import * as pulumi from "@pulumi/pulumi"; import * as inputs from "../types/input"; import * as outputs from "../types/output"; /** * Create a multicast group range activation in the specified location of the current project. * * To get more information about MulticastGroupRangeActivation, see: * * * [API documentation](https://docs.cloud.google.com/vpc/docs/multicast/reference/rest/v1/projects.locations.multicastGroupRangeActivations) * * How-to Guides * * [Create Multicast Group Range Activation](https://docs.cloud.google.com/vpc/docs/multicast/create-group-ranges#activate_the_group_range) * * ## Example Usage * * ### Network Services Multicast Group Range Activation Basic * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as gcp from "@pulumi/gcp"; * * const network = new gcp.compute.Network("network", { * name: "test-network-mgra", * autoCreateSubnetworks: false, * }); * const multicastDomain = new gcp.networkservices.MulticastDomain("multicast_domain", { * multicastDomainId: "test-domain-mgra", * location: "global", * adminNetwork: network.id, * connectionConfig: { * connectionType: "SAME_VPC", * }, * }, { * dependsOn: [network], * }); * const internalRange = new gcp.networkconnectivity.InternalRange("internal_range", { * name: "test-internal-range-mgra", * network: network.selfLink, * usage: "FOR_VPC", * peering: "FOR_SELF", * ipCidrRange: "224.2.0.2/32", * }); * const groupRange = new gcp.networkservices.MulticastGroupRange("group_range", { * multicastGroupRangeId: "test-group-range-mgra", * location: "global", * reservedInternalRange: internalRange.id, * multicastDomain: multicastDomain.id, * }); * const multicastDomainActivation = new gcp.networkservices.MulticastDomainActivation("multicast_domain_activation", { * multicastDomainActivationId: "test-domain-activation-mgra", * location: "us-central1-b", * multicastDomain: multicastDomain.id, * }); * const mgraTest = new gcp.networkservices.MulticastGroupRangeActivation("mgra_test", { * multicastGroupRangeActivationId: "test-mgra-mgra", * location: "us-central1-b", * description: "my description", * labels: { * "test-label": "test-value", * }, * multicastGroupRange: groupRange.id, * multicastDomainActivation: multicastDomainActivation.id, * }); * ``` * * ## Import * * MulticastGroupRangeActivation can be imported using any of these accepted formats: * * * `projects/{{project}}/locations/{{location}}/multicastGroupRangeActivations/{{multicast_group_range_activation_id}}` * * `{{project}}/{{location}}/{{multicast_group_range_activation_id}}` * * `{{location}}/{{multicast_group_range_activation_id}}` * * When using the `pulumi import` command, MulticastGroupRangeActivation can be imported using one of the formats above. For example: * * ```sh * $ pulumi import gcp:networkservices/multicastGroupRangeActivation:MulticastGroupRangeActivation default projects/{{project}}/locations/{{location}}/multicastGroupRangeActivations/{{multicast_group_range_activation_id}} * $ pulumi import gcp:networkservices/multicastGroupRangeActivation:MulticastGroupRangeActivation default {{project}}/{{location}}/{{multicast_group_range_activation_id}} * $ pulumi import gcp:networkservices/multicastGroupRangeActivation:MulticastGroupRangeActivation default {{location}}/{{multicast_group_range_activation_id}} * ``` */ export declare class MulticastGroupRangeActivation extends pulumi.CustomResource { /** * Get an existing MulticastGroupRangeActivation resource's state with the given name, ID, and optional extra * properties used to qualify the lookup. * * @param name The _unique_ name of the resulting resource. * @param id The _unique_ provider ID of the resource to lookup. * @param state Any extra arguments used during the lookup. * @param opts Optional settings to control the behavior of the CustomResource. */ static get(name: string, id: pulumi.Input, state?: MulticastGroupRangeActivationState, opts?: pulumi.CustomResourceOptions): MulticastGroupRangeActivation; /** * Returns true if the given object is an instance of MulticastGroupRangeActivation. This is designed to work even * when multiple copies of the Pulumi SDK have been loaded into the same process. */ static isInstance(obj: any): obj is MulticastGroupRangeActivation; /** * [Output only] The timestamp when the multicast group range activation was * created. */ readonly createTime: pulumi.Output; /** * Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. * When a 'terraform destroy' or 'pulumi up' would delete the resource, * the command will fail if this field is set to "PREVENT" in Terraform state. * When set to "ABANDON", the command will remove the resource from Terraform * management without updating or deleting the resource in the API. * When set to "DELETE", deleting the resource is allowed. */ readonly deletionPolicy: pulumi.Output; /** * An optional text description of the multicast group range activation. */ readonly description: pulumi.Output; /** * All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services. */ readonly effectiveLabels: pulumi.Output<{ [key: string]: string; }>; /** * [Output only] The multicast group IP address range. */ readonly ipCidrRange: pulumi.Output; /** * Labels as key-value pairs. * **Note**: This field is non-authoritative, and will only manage the labels present in your configuration. * Please refer to the field `effectiveLabels` for all of the labels present on the resource. */ readonly labels: pulumi.Output<{ [key: string]: string; } | undefined>; /** * Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122. */ readonly location: pulumi.Output; /** * The logging configuration. * Structure is documented below. */ readonly logConfig: pulumi.Output; /** * The resource name of a multicast domain activation that is in the * same zone as this multicast group. * Use the following format: * `projects/*/locations/*/multicastDomainActivations/*` */ readonly multicastDomainActivation: pulumi.Output; /** * The resource names of associated multicast group consumer activations. * Use the following format: * `projects/*/locations/*/multicastGroupConsumerActivations/*`. */ readonly multicastGroupConsumerActivations: pulumi.Output; /** * The resource name of the global multicast group range for the * group. Use the following format: * `projects/*/locations/global/multicastGroupRanges/*` */ readonly multicastGroupRange: pulumi.Output; /** * A unique name for the multicast group range activation. * The name is restricted to letters, numbers, and hyphen, with the first * character a letter, and the last a letter or a number. The name must not * exceed 48 characters. */ readonly multicastGroupRangeActivationId: pulumi.Output; /** * Identifier. The resource name of the multicast group range activation. * Use the following format: * `projects/*/locations/*/multicastGroupRangeActivations/*`. */ readonly name: pulumi.Output; /** * The ID of the project in which the resource belongs. * If it is not provided, the provider project is used. */ readonly project: pulumi.Output; /** * The combination of labels configured directly on the resource * and default labels configured on the provider. */ readonly pulumiLabels: pulumi.Output<{ [key: string]: string; }>; /** * (Output) * The state of the multicast resource. * Possible values: * CREATING * ACTIVE * DELETING * DELETE_FAILED * UPDATING * UPDATE_FAILED * INACTIVE */ readonly states: pulumi.Output; /** * [Output only] The Google-generated UUID for the resource. This value is * unique across all multicast group resources. If a group is deleted and * another with the same name is created, the new group is assigned a * different unique_id. */ readonly uniqueId: pulumi.Output; /** * [Output only] The timestamp when the multicast group range activation was * most recently updated. */ readonly updateTime: pulumi.Output; /** * Create a MulticastGroupRangeActivation resource with the given unique name, arguments, and options. * * @param name The _unique_ name of the resource. * @param args The arguments to use to populate this resource's properties. * @param opts A bag of options that control this resource's behavior. */ constructor(name: string, args: MulticastGroupRangeActivationArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering MulticastGroupRangeActivation resources. */ export interface MulticastGroupRangeActivationState { /** * [Output only] The timestamp when the multicast group range activation was * created. */ createTime?: pulumi.Input; /** * Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. * When a 'terraform destroy' or 'pulumi up' would delete the resource, * the command will fail if this field is set to "PREVENT" in Terraform state. * When set to "ABANDON", the command will remove the resource from Terraform * management without updating or deleting the resource in the API. * When set to "DELETE", deleting the resource is allowed. */ deletionPolicy?: pulumi.Input; /** * An optional text description of the multicast group range activation. */ description?: pulumi.Input; /** * All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services. */ effectiveLabels?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * [Output only] The multicast group IP address range. */ ipCidrRange?: pulumi.Input; /** * Labels as key-value pairs. * **Note**: This field is non-authoritative, and will only manage the labels present in your configuration. * Please refer to the field `effectiveLabels` for all of the labels present on the resource. */ labels?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122. */ location?: pulumi.Input; /** * The logging configuration. * Structure is documented below. */ logConfig?: pulumi.Input; /** * The resource name of a multicast domain activation that is in the * same zone as this multicast group. * Use the following format: * `projects/*/locations/*/multicastDomainActivations/*` */ multicastDomainActivation?: pulumi.Input; /** * The resource names of associated multicast group consumer activations. * Use the following format: * `projects/*/locations/*/multicastGroupConsumerActivations/*`. */ multicastGroupConsumerActivations?: pulumi.Input[] | undefined>; /** * The resource name of the global multicast group range for the * group. Use the following format: * `projects/*/locations/global/multicastGroupRanges/*` */ multicastGroupRange?: pulumi.Input; /** * A unique name for the multicast group range activation. * The name is restricted to letters, numbers, and hyphen, with the first * character a letter, and the last a letter or a number. The name must not * exceed 48 characters. */ multicastGroupRangeActivationId?: pulumi.Input; /** * Identifier. The resource name of the multicast group range activation. * Use the following format: * `projects/*/locations/*/multicastGroupRangeActivations/*`. */ name?: pulumi.Input; /** * The ID of the project in which the resource belongs. * If it is not provided, the provider project is used. */ project?: pulumi.Input; /** * The combination of labels configured directly on the resource * and default labels configured on the provider. */ pulumiLabels?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * (Output) * The state of the multicast resource. * Possible values: * CREATING * ACTIVE * DELETING * DELETE_FAILED * UPDATING * UPDATE_FAILED * INACTIVE */ states?: pulumi.Input[] | undefined>; /** * [Output only] The Google-generated UUID for the resource. This value is * unique across all multicast group resources. If a group is deleted and * another with the same name is created, the new group is assigned a * different unique_id. */ uniqueId?: pulumi.Input; /** * [Output only] The timestamp when the multicast group range activation was * most recently updated. */ updateTime?: pulumi.Input; } /** * The set of arguments for constructing a MulticastGroupRangeActivation resource. */ export interface MulticastGroupRangeActivationArgs { /** * Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. * When a 'terraform destroy' or 'pulumi up' would delete the resource, * the command will fail if this field is set to "PREVENT" in Terraform state. * When set to "ABANDON", the command will remove the resource from Terraform * management without updating or deleting the resource in the API. * When set to "DELETE", deleting the resource is allowed. */ deletionPolicy?: pulumi.Input; /** * An optional text description of the multicast group range activation. */ description?: pulumi.Input; /** * Labels as key-value pairs. * **Note**: This field is non-authoritative, and will only manage the labels present in your configuration. * Please refer to the field `effectiveLabels` for all of the labels present on the resource. */ labels?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122. */ location: pulumi.Input; /** * The logging configuration. * Structure is documented below. */ logConfig?: pulumi.Input; /** * The resource name of a multicast domain activation that is in the * same zone as this multicast group. * Use the following format: * `projects/*/locations/*/multicastDomainActivations/*` */ multicastDomainActivation: pulumi.Input; /** * The resource name of the global multicast group range for the * group. Use the following format: * `projects/*/locations/global/multicastGroupRanges/*` */ multicastGroupRange: pulumi.Input; /** * A unique name for the multicast group range activation. * The name is restricted to letters, numbers, and hyphen, with the first * character a letter, and the last a letter or a number. The name must not * exceed 48 characters. */ multicastGroupRangeActivationId: pulumi.Input; /** * The ID of the project in which the resource belongs. * If it is not provided, the provider project is used. */ project?: pulumi.Input; } //# sourceMappingURL=multicastGroupRangeActivation.d.ts.map