1. Registry
  2. Packages
  3. Google Cloud Native
  4. API Docs
  5. cloudresourcemanager
  6. cloudresourcemanager/v3
  7. TagValue

This package is deprecated. Active development has stopped. We recommend using the Google Cloud package instead.

Viewing docs for Google Cloud Native v0.32.0
published on Wednesday, Nov 29, 2023 by Pulumi
google-native logo Google Cloud Native

This package is deprecated. Active development has stopped. We recommend using the Google Cloud package instead.

Viewing docs for Google Cloud Native v0.32.0
published on Wednesday, Nov 29, 2023 by Pulumi

    Creates a TagValue as a child of the specified TagKey. If a another request with the same parameters is sent while the original request is in process the second request will receive an error. A maximum of 1000 TagValues can exist under a TagKey at any given time.

    Create TagValue Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new TagValue(name: string, args: TagValueArgs, opts?: CustomResourceOptions);
    @overload
    def TagValue(resource_name: str,
                 args: TagValueArgs,
                 opts: Optional[ResourceOptions] = None)
    
    @overload
    def TagValue(resource_name: str,
                 opts: Optional[ResourceOptions] = None,
                 short_name: Optional[str] = None,
                 description: Optional[str] = None,
                 etag: Optional[str] = None,
                 name: Optional[str] = None,
                 parent: Optional[str] = None)
    func NewTagValue(ctx *Context, name string, args TagValueArgs, opts ...ResourceOption) (*TagValue, error)
    public TagValue(string name, TagValueArgs args, CustomResourceOptions? opts = null)
    public TagValue(String name, TagValueArgs args)
    public TagValue(String name, TagValueArgs args, CustomResourceOptions options)
    
    type: google-native:cloudresourcemanager/v3:TagValue
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "google-native_cloudresourcemanager_v3_tag_value" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args TagValueArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args TagValueArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args TagValueArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args TagValueArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args TagValueArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var tagValueResource = new GoogleNative.CloudResourceManager.V3.TagValue("tagValueResource", new()
    {
        ShortName = "string",
        Description = "string",
        Etag = "string",
        Name = "string",
        Parent = "string",
    });
    
    example, err := cloudresourcemanagerv3.NewTagValue(ctx, "tagValueResource", &cloudresourcemanagerv3.TagValueArgs{
    	ShortName:   pulumi.String("string"),
    	Description: pulumi.String("string"),
    	Etag:        pulumi.String("string"),
    	Name:        pulumi.String("string"),
    	Parent:      pulumi.String("string"),
    })
    
    resource "google-native_cloudresourcemanager_v3_tag_value" "tagValueResource" {
      lifecycle {
        create_before_destroy = true
      }
      short_name  = "string"
      description = "string"
      etag        = "string"
      name        = "string"
      parent      = "string"
    }
    
    var tagValueResource = new TagValue("tagValueResource", TagValueArgs.builder()
        .shortName("string")
        .description("string")
        .etag("string")
        .name("string")
        .parent("string")
        .build());
    
    tag_value_resource = google_native.cloudresourcemanager.v3.TagValue("tagValueResource",
        short_name="string",
        description="string",
        etag="string",
        name="string",
        parent="string")
    
    const tagValueResource = new google_native.cloudresourcemanager.v3.TagValue("tagValueResource", {
        shortName: "string",
        description: "string",
        etag: "string",
        name: "string",
        parent: "string",
    });
    
    type: google-native:cloudresourcemanager/v3:TagValue
    properties:
        description: string
        etag: string
        name: string
        parent: string
        shortName: string
    

    TagValue Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The TagValue resource accepts the following input properties:

    ShortName string
    Immutable. User-assigned short name for TagValue. The short name should be unique for TagValues within the same parent TagKey. The short name must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between.
    Description string
    Optional. User-assigned description of the TagValue. Must not exceed 256 characters. Read-write.
    Etag string
    Optional. Entity tag which users can pass to prevent race conditions. This field is always set in server responses. See UpdateTagValueRequest for details.
    Name string
    Immutable. Resource name for TagValue in the format tagValues/456.
    Parent string
    Immutable. The resource name of the new TagValue's parent TagKey. Must be of the form tagKeys/{tag_key_id}.
    ShortName string
    Immutable. User-assigned short name for TagValue. The short name should be unique for TagValues within the same parent TagKey. The short name must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between.
    Description string
    Optional. User-assigned description of the TagValue. Must not exceed 256 characters. Read-write.
    Etag string
    Optional. Entity tag which users can pass to prevent race conditions. This field is always set in server responses. See UpdateTagValueRequest for details.
    Name string
    Immutable. Resource name for TagValue in the format tagValues/456.
    Parent string
    Immutable. The resource name of the new TagValue's parent TagKey. Must be of the form tagKeys/{tag_key_id}.
    short_name string
    Immutable. User-assigned short name for TagValue. The short name should be unique for TagValues within the same parent TagKey. The short name must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between.
    description string
    Optional. User-assigned description of the TagValue. Must not exceed 256 characters. Read-write.
    etag string
    Optional. Entity tag which users can pass to prevent race conditions. This field is always set in server responses. See UpdateTagValueRequest for details.
    name string
    Immutable. Resource name for TagValue in the format tagValues/456.
    parent string
    Immutable. The resource name of the new TagValue's parent TagKey. Must be of the form tagKeys/{tag_key_id}.
    shortName String
    Immutable. User-assigned short name for TagValue. The short name should be unique for TagValues within the same parent TagKey. The short name must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between.
    description String
    Optional. User-assigned description of the TagValue. Must not exceed 256 characters. Read-write.
    etag String
    Optional. Entity tag which users can pass to prevent race conditions. This field is always set in server responses. See UpdateTagValueRequest for details.
    name String
    Immutable. Resource name for TagValue in the format tagValues/456.
    parent String
    Immutable. The resource name of the new TagValue's parent TagKey. Must be of the form tagKeys/{tag_key_id}.
    shortName string
    Immutable. User-assigned short name for TagValue. The short name should be unique for TagValues within the same parent TagKey. The short name must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between.
    description string
    Optional. User-assigned description of the TagValue. Must not exceed 256 characters. Read-write.
    etag string
    Optional. Entity tag which users can pass to prevent race conditions. This field is always set in server responses. See UpdateTagValueRequest for details.
    name string
    Immutable. Resource name for TagValue in the format tagValues/456.
    parent string
    Immutable. The resource name of the new TagValue's parent TagKey. Must be of the form tagKeys/{tag_key_id}.
    short_name str
    Immutable. User-assigned short name for TagValue. The short name should be unique for TagValues within the same parent TagKey. The short name must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between.
    description str
    Optional. User-assigned description of the TagValue. Must not exceed 256 characters. Read-write.
    etag str
    Optional. Entity tag which users can pass to prevent race conditions. This field is always set in server responses. See UpdateTagValueRequest for details.
    name str
    Immutable. Resource name for TagValue in the format tagValues/456.
    parent str
    Immutable. The resource name of the new TagValue's parent TagKey. Must be of the form tagKeys/{tag_key_id}.
    shortName String
    Immutable. User-assigned short name for TagValue. The short name should be unique for TagValues within the same parent TagKey. The short name must be 63 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between.
    description String
    Optional. User-assigned description of the TagValue. Must not exceed 256 characters. Read-write.
    etag String
    Optional. Entity tag which users can pass to prevent race conditions. This field is always set in server responses. See UpdateTagValueRequest for details.
    name String
    Immutable. Resource name for TagValue in the format tagValues/456.
    parent String
    Immutable. The resource name of the new TagValue's parent TagKey. Must be of the form tagKeys/{tag_key_id}.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the TagValue resource produces the following output properties:

    CreateTime string
    Creation time.
    Id string
    The provider-assigned unique ID for this managed resource.
    NamespacedName string
    The namespaced name of the TagValue. Can be in the form {organization_id}/{tag_key_short_name}/{tag_value_short_name} or {project_id}/{tag_key_short_name}/{tag_value_short_name} or {project_number}/{tag_key_short_name}/{tag_value_short_name}.
    UpdateTime string
    Update time.
    CreateTime string
    Creation time.
    Id string
    The provider-assigned unique ID for this managed resource.
    NamespacedName string
    The namespaced name of the TagValue. Can be in the form {organization_id}/{tag_key_short_name}/{tag_value_short_name} or {project_id}/{tag_key_short_name}/{tag_value_short_name} or {project_number}/{tag_key_short_name}/{tag_value_short_name}.
    UpdateTime string
    Update time.
    create_time string
    Creation time.
    id string
    The provider-assigned unique ID for this managed resource.
    namespaced_name string
    The namespaced name of the TagValue. Can be in the form {organization_id}/{tag_key_short_name}/{tag_value_short_name} or {project_id}/{tag_key_short_name}/{tag_value_short_name} or {project_number}/{tag_key_short_name}/{tag_value_short_name}.
    update_time string
    Update time.
    createTime String
    Creation time.
    id String
    The provider-assigned unique ID for this managed resource.
    namespacedName String
    The namespaced name of the TagValue. Can be in the form {organization_id}/{tag_key_short_name}/{tag_value_short_name} or {project_id}/{tag_key_short_name}/{tag_value_short_name} or {project_number}/{tag_key_short_name}/{tag_value_short_name}.
    updateTime String
    Update time.
    createTime string
    Creation time.
    id string
    The provider-assigned unique ID for this managed resource.
    namespacedName string
    The namespaced name of the TagValue. Can be in the form {organization_id}/{tag_key_short_name}/{tag_value_short_name} or {project_id}/{tag_key_short_name}/{tag_value_short_name} or {project_number}/{tag_key_short_name}/{tag_value_short_name}.
    updateTime string
    Update time.
    create_time str
    Creation time.
    id str
    The provider-assigned unique ID for this managed resource.
    namespaced_name str
    The namespaced name of the TagValue. Can be in the form {organization_id}/{tag_key_short_name}/{tag_value_short_name} or {project_id}/{tag_key_short_name}/{tag_value_short_name} or {project_number}/{tag_key_short_name}/{tag_value_short_name}.
    update_time str
    Update time.
    createTime String
    Creation time.
    id String
    The provider-assigned unique ID for this managed resource.
    namespacedName String
    The namespaced name of the TagValue. Can be in the form {organization_id}/{tag_key_short_name}/{tag_value_short_name} or {project_id}/{tag_key_short_name}/{tag_value_short_name} or {project_number}/{tag_key_short_name}/{tag_value_short_name}.
    updateTime String
    Update time.

    Look up Existing TagValue Resource

    Get an existing TagValue resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, opts?: CustomResourceOptions): TagValue
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None) -> TagValue
    func GetTagValue(ctx *Context, name string, id IDInput, state *TagValueState, opts ...ResourceOption) (*TagValue, error)
    public static TagValue Get(string name, Input<string> id, CustomResourceOptions? opts = null)
    public static TagValue get(String name, Output<String> id, CustomResourceOptions options)
    resources:  existingTagValue:    type: google-native:cloudresourcemanager/v3:TagValue    get:      id: ${id}
    import {
      to = google-native_cloudresourcemanager_v3_tag_value.example
      id = "${id}"
    }
    
    name string
    The unique name of the resulting resource.
    id Input<ID>
    The unique provider ID of the resource to look up.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resulting resource.
    id str
    The unique provider ID of the resource to look up.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resulting resource.
    id IDInput
    The unique provider ID of the resource to look up.
    state TagValueState
    Pass nil. This resource has no state arguments.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resulting resource.
    id Input<string>
    The unique provider ID of the resource to look up.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resulting resource.
    id Output<String>
    The unique provider ID of the resource to look up.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Package Details

    Repository
    Google Cloud Native pulumi/pulumi-google-native
    License
    Apache-2.0
    google-native logo Google Cloud Native

    This package is deprecated. Active development has stopped. We recommend using the Google Cloud package instead.

    Viewing docs for Google Cloud Native v0.32.0
    published on Wednesday, Nov 29, 2023 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial