import * as pulumi from "@pulumi/pulumi"; import * as inputs from "../types/input"; import * as outputs from "../types/output"; /** * Create a multicast group consumer activation in the specified location of the current project. * * To get more information about MulticastGroupConsumerActivation, see: * * * [API documentation](https://docs.cloud.google.com/vpc/docs/multicast/reference/rest/v1/projects.locations.multicastGroupConsumerActivations) * * How-to Guides * * [Create Multicast Group Consumer Activation](https://docs.cloud.google.com/vpc/docs/multicast/enable-consumer-network#activate-consumer) * * ## Example Usage * * ### Network Services Multicast Group Consumer 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-mgca", * autoCreateSubnetworks: false, * }); * const multicastDomain = new gcp.networkservices.MulticastDomain("multicast_domain", { * multicastDomainId: "test-domain-mgca", * location: "global", * adminNetwork: network.id, * connectionConfig: { * connectionType: "SAME_VPC", * }, * }, { * dependsOn: [network], * }); * const multicastDomainActivation = new gcp.networkservices.MulticastDomainActivation("multicast_domain_activation", { * multicastDomainActivationId: "test-domain-activation-mgca", * location: "us-central1-b", * multicastDomain: multicastDomain.id, * }); * const consumerAssociation = new gcp.networkservices.MulticastConsumerAssociation("consumer_association", { * multicastConsumerAssociationId: "test-consumer-association-mgca", * location: "us-central1-b", * network: network.id, * multicastDomainActivation: multicastDomainActivation.id, * }, { * dependsOn: [network], * }); * const internalRange = new gcp.networkconnectivity.InternalRange("internal_range", { * name: "test-internal-range-mgca", * 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-mgca", * location: "global", * reservedInternalRange: internalRange.id, * multicastDomain: multicastDomain.id, * }); * const groupRangeActivation = new gcp.networkservices.MulticastGroupRangeActivation("group_range_activation", { * multicastGroupRangeActivationId: "test-mgra-mgca", * location: "us-central1-b", * multicastGroupRange: groupRange.id, * multicastDomainActivation: multicastDomainActivation.id, * }); * const mgcaTest = new gcp.networkservices.MulticastGroupConsumerActivation("mgca_test", { * multicastGroupConsumerActivationId: "test-mgca-mgca", * location: "us-central1-b", * multicastGroupRangeActivation: groupRangeActivation.id, * multicastConsumerAssociation: consumerAssociation.id, * }); * ``` * * ## Import * * MulticastGroupConsumerActivation can be imported using any of these accepted formats: * * * `projects/{{project}}/locations/{{location}}/multicastGroupConsumerActivations/{{multicast_group_consumer_activation_id}}` * * `{{project}}/{{location}}/{{multicast_group_consumer_activation_id}}` * * `{{location}}/{{multicast_group_consumer_activation_id}}` * * When using the `pulumi import` command, MulticastGroupConsumerActivation can be imported using one of the formats above. For example: * * ```sh * $ pulumi import gcp:networkservices/multicastGroupConsumerActivation:MulticastGroupConsumerActivation default projects/{{project}}/locations/{{location}}/multicastGroupConsumerActivations/{{multicast_group_consumer_activation_id}} * $ pulumi import gcp:networkservices/multicastGroupConsumerActivation:MulticastGroupConsumerActivation default {{project}}/{{location}}/{{multicast_group_consumer_activation_id}} * $ pulumi import gcp:networkservices/multicastGroupConsumerActivation:MulticastGroupConsumerActivation default {{location}}/{{multicast_group_consumer_activation_id}} * ``` */ export declare class MulticastGroupConsumerActivation extends pulumi.CustomResource { /** * Get an existing MulticastGroupConsumerActivation 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?: MulticastGroupConsumerActivationState, opts?: pulumi.CustomResourceOptions): MulticastGroupConsumerActivation; /** * Returns true if the given object is an instance of MulticastGroupConsumerActivation. 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 MulticastGroupConsumerActivation; /** * The timestamp when the multicast group consumer activation * was created. */ readonly createTime: pulumi.Output; /** * An optional text description of the multicast group consumer 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; }>; /** * 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 the multicast consumer association that is in the * same zone as this multicast group consumer activation. * Use the following format: * `projects/*/locations/*/multicastConsumerAssociations/*`. */ readonly multicastConsumerAssociation: pulumi.Output; /** * A unique name for the multicast group consumer 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 multicastGroupConsumerActivationId: pulumi.Output; /** * The resource name of the multicast group range activation created by the * admin in the same zone as this multicast group consumer activation. Use the * following format: * // `projects/*/locations/*/multicastGroupRangeActivations/*`. */ readonly multicastGroupRangeActivation: pulumi.Output; /** * Identifier. The resource name of the multicast group consumer activation. * Use the following format: * `projects/*/locations/*/multicastGroupConsumerActivations/*`. */ 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; /** * The Google-generated UUID for the resource. This value is * unique across all multicast group consumer activation resources. If a group * consumer activation is deleted and another with the same name is created, * the new group consumer activation is assigned a different unique_id. */ readonly uniqueId: pulumi.Output; /** * The timestamp when the multicast group consumer activation * was most recently updated. */ readonly updateTime: pulumi.Output; /** * Create a MulticastGroupConsumerActivation 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: MulticastGroupConsumerActivationArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering MulticastGroupConsumerActivation resources. */ export interface MulticastGroupConsumerActivationState { /** * The timestamp when the multicast group consumer activation * was created. */ createTime?: pulumi.Input; /** * An optional text description of the multicast group consumer 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; }>; /** * 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; }>; /** * 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 the multicast consumer association that is in the * same zone as this multicast group consumer activation. * Use the following format: * `projects/*/locations/*/multicastConsumerAssociations/*`. */ multicastConsumerAssociation?: pulumi.Input; /** * A unique name for the multicast group consumer 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. */ multicastGroupConsumerActivationId?: pulumi.Input; /** * The resource name of the multicast group range activation created by the * admin in the same zone as this multicast group consumer activation. Use the * following format: * // `projects/*/locations/*/multicastGroupRangeActivations/*`. */ multicastGroupRangeActivation?: pulumi.Input; /** * Identifier. The resource name of the multicast group consumer activation. * Use the following format: * `projects/*/locations/*/multicastGroupConsumerActivations/*`. */ 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; }>; /** * (Output) * The state of the multicast resource. * Possible values: * CREATING * ACTIVE * DELETING * DELETE_FAILED * UPDATING * UPDATE_FAILED * INACTIVE */ states?: pulumi.Input[]>; /** * The Google-generated UUID for the resource. This value is * unique across all multicast group consumer activation resources. If a group * consumer activation is deleted and another with the same name is created, * the new group consumer activation is assigned a different unique_id. */ uniqueId?: pulumi.Input; /** * The timestamp when the multicast group consumer activation * was most recently updated. */ updateTime?: pulumi.Input; } /** * The set of arguments for constructing a MulticastGroupConsumerActivation resource. */ export interface MulticastGroupConsumerActivationArgs { /** * An optional text description of the multicast group consumer 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; }>; /** * 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 the multicast consumer association that is in the * same zone as this multicast group consumer activation. * Use the following format: * `projects/*/locations/*/multicastConsumerAssociations/*`. */ multicastConsumerAssociation: pulumi.Input; /** * A unique name for the multicast group consumer 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. */ multicastGroupConsumerActivationId: pulumi.Input; /** * The resource name of the multicast group range activation created by the * admin in the same zone as this multicast group consumer activation. Use the * following format: * // `projects/*/locations/*/multicastGroupRangeActivations/*`. */ multicastGroupRangeActivation: 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; }