TagsTagValue

Property	Value
Google Cloud Service Name	Cloud Resource Manager
Google Cloud Service Documentation	/resource-manager/docs/tags/tags-overview
Google Cloud REST Resource Name	v3.tagValues
Google Cloud REST Resource Documentation	/resource-manager/reference/rest/v3/tagValues
Config Connector Resource Short Names	gcptagstagvalue gcptagstagvalues tagstagvalue
Config Connector Service Name	cloudresourcemanager.googleapis.com
Config Connector Resource Fully Qualified Name	tagstagvalues.tags.cnrm.cloud.google.com
Can Be Referenced by IAMPolicy/IAMPolicyMember	Yes
Supports IAM Conditions	No
Supports IAM Audit Configs	No
IAM External Reference Format	tagValues/{{name}}
Config Connector Default Average Reconcile Interval In Seconds	600

Custom Resource Definition Properties

Spec

Schema

description: string
parentRef:
  external: string
  name: string
  namespace: string
resourceID: string
shortName: string

Fields
description Optional	string Optional. User-assigned description of the TagValue. Must not exceed 256 characters. Read-write.
parentRef Required	object Immutable. The TagValue's parent TagKey.
parentRef.external Optional	string A reference to an externally managed TagsTagKey resource. Should be in the format "tagKeys/{{tagKeyID}}".
parentRef.name Optional	string The name of a TagsTagKey resource.
parentRef.namespace Optional	string The namespace of a TagsTagKey resource.
resourceID Optional	string Immutable. Optional. The service-generated name of the resource. Used for acquisition only. Leave unset to create a new resource.
shortName Required	string Required. 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.

Status

Schema

conditions:
- lastTransitionTime: string
  message: string
  reason: string
  status: string
  type: string
createTime: string
externalRef: string
name: string
namespacedName: string
observedGeneration: integer
updateTime: string

Fields
conditions	list (object) Conditions represent the latest available observations of the object's current state.
conditions[]	object
conditions[].lastTransitionTime	string Last time the condition transitioned from one status to another.
conditions[].message	string Human-readable message indicating details about last transition.
conditions[].reason	string Unique, one-word, CamelCase reason for the condition's last transition.
conditions[].status	string Status is the status of the condition. Can be True, False, Unknown.
conditions[].type	string Type is the type of the condition.
createTime	string Output only. Creation time.
externalRef	string A unique specifier for the TagsTagValue resource in Google Cloud.
name	string Immutable. Resource name for TagValue in the format `tagValues/456`.
namespacedName	string Output only. 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}`.
observedGeneration	integer ObservedGeneration is the generation of the resource that was most recently observed by the Config Connector controller. If this is equal to metadata.generation, then that means that the current reported status reflects the most recent desired state of the resource.
updateTime	string Output only. Update time.

Sample YAML(s)

TagsTagValue Org

# Copyright 2026 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

apiVersion: tags.cnrm.cloud.google.com/v1beta1
kind: TagsTagValue
metadata:
  name: tagstagvalue-sample-org
spec:
  description: For valuename resources.
  parentRef:
    name: tagstagkey-dep-org
  shortName: valuename
---
apiVersion: tags.cnrm.cloud.google.com/v1beta1
kind: TagsTagKey
metadata:
  name: tagstagkey-dep-org
spec:
  description: For keyname resources.
  # Replace ${ORG_ID?} with your organization ID.
  parent: organizations/${ORG_ID?}
  shortName: keynamedeporg

TagsTagValue Project

# Copyright 2026 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

apiVersion: tags.cnrm.cloud.google.com/v1beta1
kind: TagsTagValue
metadata:
  name: tagstagvalue-sample-project
spec:
  description: For valuename resources.
  parentRef:
    name: tagstagkey-dep-project
  shortName: valuename
---
apiVersion: tags.cnrm.cloud.google.com/v1beta1
kind: TagsTagKey
metadata:
  name: tagstagkey-dep-project
spec:
  description: For keyname resources.
  # Replace ${PROJECT_ID?} with your project ID.
  parent: projects/${PROJECT_ID?}
  shortName: keynamedepproject

Note: If you have any trouble with instantiating the resource, refer to Troubleshoot Config Connector.