TagsTagBinding

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.tagBindings
Google Cloud REST Resource Documentation	/resource-manager/reference/rest/v3/tagBindings
Config Connector Resource Short Names	gcptagstagbinding gcptagstagbindings tagstagbinding
Config Connector Service Name	cloudresourcemanager.googleapis.com
Config Connector Resource Fully Qualified Name	tagstagbindings.tags.cnrm.cloud.google.com
Can Be Referenced by IAMPolicy/IAMPolicyMember	No
Config Connector Default Average Reconcile Interval In Seconds	600

Custom Resource Definition Properties

Spec

Schema

parentRef:
  external: string
  kind: string
  name: string
  namespace: string
resourceID: string
tagValueRef:
  external: string
  name: string
  namespace: string

Fields

Fields
`parentRef` Required	`object` ParentRef is a reference to a parent resource.
`parentRef.external` Optional	`string` Allowed value: string of the format `//cloudresourcemanager.googleapis.com/projects/{{value}}`, where {{value}} is the `number` field of a `Project` resource.
`parentRef.kind` Optional	`string` Kind to which we are binding the tag. Defaults to Project if not specified.
`parentRef.name` Optional	`string` Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
`parentRef.namespace` Optional	`string` Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/
`resourceID` Optional	`string` The service-generated name of the resource. Used for acquisition only. Leave unset to create a new resource.
`tagValueRef` Required	`object` TagsTagValueRef is a reference to a TagsTagValue resource.
`tagValueRef.external` Optional	`string` A reference to an externally managed TagsTagValue resource. Should be in the format "tagValues/{{tagValueID}}".
`tagValueRef.name` Optional	`string` The name of a TagsTagValue resource.
`tagValueRef.namespace` Optional	`string` The namespace of a TagsTagValue resource.

parentRef

Required

object

ParentRef is a reference to a parent resource.

parentRef.external

Optional

string

Allowed value: string of the format `//cloudresourcemanager.googleapis.com/projects/{{value}}`, where {{value}} is the `number` field of a `Project` resource.

parentRef.kind

Optional

string

Kind to which we are binding the tag. Defaults to Project if not specified.

parentRef.name

Optional

string

Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

parentRef.namespace

Optional

string

Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

resourceID

Optional

string

The service-generated name of the resource. Used for acquisition only. Leave unset to create a new resource.

tagValueRef

Required

object

TagsTagValueRef is a reference to a TagsTagValue resource.

tagValueRef.external

Optional

string

A reference to an externally managed TagsTagValue resource. Should be in the format "tagValues/{{tagValueID}}".

tagValueRef.name

Optional

string

The name of a TagsTagValue resource.

tagValueRef.namespace

Optional

string

The namespace of a TagsTagValue resource.

Status

Schema

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

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.
`externalRef`	`string` A unique specifier for the TagsTagBinding resource in Google Cloud.
`name`	`string` The generated id for the TagBinding. This is a string of the form: tagBindings/{full-resource-name}/{tag-value-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.

Sample YAML(s)

Typical Use Case

# 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: TagsTagBinding
metadata:
  name: tagstagbinding-sample
spec:
  parentRef:
    # If parent is project, This is the full resource name of a Google Cloud project number not ID!
    # Replace ${PROJECT_NUMBER?} with your project number.
    external: //cloudresourcemanager.googleapis.com/projects/${PROJECT_NUMBER?}
  tagValueRef:
    name: tagstagvalue-dep
---
apiVersion: tags.cnrm.cloud.google.com/v1beta1
kind: TagsTagKey
metadata:
  name: tagstagkey-dep
spec:
  description: For keyname resources.
  # Replace ${ORG_ID?} with your organization ID.
  parent: organizations/${ORG_ID?}
  shortName: keynamedep
---
apiVersion: tags.cnrm.cloud.google.com/v1beta1
kind: TagsTagValue
metadata:
  name: tagstagvalue-dep
spec:
  description: For valuename resources.
  parentRef:
    name: tagstagkey-dep
  shortName: valuename