import * as pulumi from "@pulumi/pulumi"; /** * A TagBinding represents a connection between a TagValue and a cloud resource (currently project, folder, or organization). Once a TagBinding is created, the TagValue is applied to all the descendants of the cloud resource. * * To get more information about TagBinding, see: * * * [API documentation](https://cloud.google.com/resource-manager/reference/rest/v3/tagBindings) * * How-to Guides * * [Official Documentation](https://cloud.google.com/resource-manager/docs/tags/tags-creating-and-managing) * * ## Example Usage * * ### Tag Binding Basic * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as gcp from "@pulumi/gcp"; * * const project = new gcp.organizations.Project("project", { * projectId: "project_id", * name: "project_id", * orgId: "123456789", * deletionPolicy: "DELETE", * }); * const key = new gcp.tags.TagKey("key", { * parent: "organizations/123456789", * shortName: "keyname", * description: "For keyname resources.", * }); * const value = new gcp.tags.TagValue("value", { * parent: key.id, * shortName: "valuename", * description: "For valuename resources.", * }); * const binding = new gcp.tags.TagBinding("binding", { * parent: pulumi.interpolate`//cloudresourcemanager.googleapis.com/projects/${project.number}`, * tagValue: value.id, * }); * ``` * * ## Import * * TagBinding can be imported using any of these accepted formats: * * * `tagBindings/{{name}}` * * * `{{name}}` * * When using the `pulumi import` command, TagBinding can be imported using one of the formats above. For example: * * ```sh * $ pulumi import gcp:tags/tagBinding:TagBinding default tagBindings/{{name}} * ``` * * ```sh * $ pulumi import gcp:tags/tagBinding:TagBinding default {{name}} * ``` */ export declare class TagBinding extends pulumi.CustomResource { /** * Get an existing TagBinding 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?: TagBindingState, opts?: pulumi.CustomResourceOptions): TagBinding; /** * Returns true if the given object is an instance of TagBinding. 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 TagBinding; /** * The generated id for the TagBinding. This is a string of the form: `tagBindings/{full-resource-name}/{tag-value-name}` */ readonly name: pulumi.Output; /** * The full resource name of the resource the TagValue is bound to. E.g. //cloudresourcemanager.googleapis.com/projects/123 */ readonly parent: pulumi.Output; /** * The TagValue of the TagBinding. Must be of the form tagValues/456. */ readonly tagValue: pulumi.Output; /** * Create a TagBinding 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: TagBindingArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering TagBinding resources. */ export interface TagBindingState { /** * The generated id for the TagBinding. This is a string of the form: `tagBindings/{full-resource-name}/{tag-value-name}` */ name?: pulumi.Input; /** * The full resource name of the resource the TagValue is bound to. E.g. //cloudresourcemanager.googleapis.com/projects/123 */ parent?: pulumi.Input; /** * The TagValue of the TagBinding. Must be of the form tagValues/456. */ tagValue?: pulumi.Input; } /** * The set of arguments for constructing a TagBinding resource. */ export interface TagBindingArgs { /** * The full resource name of the resource the TagValue is bound to. E.g. //cloudresourcemanager.googleapis.com/projects/123 */ parent: pulumi.Input; /** * The TagValue of the TagBinding. Must be of the form tagValues/456. */ tagValue: pulumi.Input; }