DataCatalogPolicyTag

Property Value
Google Cloud Service Name Data Catalog
Google Cloud Service Documentation /data-catalog/docs/
Google Cloud REST Resource Name v1.projects.locations.taxonomies.policyTags
Google Cloud REST Resource Documentation /data-catalog/docs/reference/rest/v1/projects.locations.taxonomies.policyTags
Config Connector Resource Short Names datacatalogpolicytag
gcpdatacatalogpolicytag
gcpdatacatalogpolicytags
Config Connector Service Name datacatalog.googleapis.com
Config Connector Resource Fully Qualified Name datacatalogpolicytags.datacatalog.cnrm.cloud.google.com
Can Be Referenced by IAMPolicy/IAMPolicyMember Yes
Supports IAM Conditions No
Supports IAM Audit Configs No
IAM External Reference Format

{{name}}
Config Connector Default Average Reconcile Interval In Seconds 600

Custom Resource Definition Properties

Spec

Schema

description: string
displayName: string
parentPolicyTagRef:
  external: string
  name: string
  namespace: string
resourceID: string
taxonomyRef:
  external: string
  name: string
  namespace: string
Fields

description

Optional

string

Description of this policy tag. It must: contain only unicode characters, tabs, newlines, carriage returns and page breaks; and be at most 2000 bytes long when encoded in UTF-8. If not set, defaults to an empty description.

displayName

Required

string

User defined name of this policy tag. It must: be unique within the parent taxonomy; contain only unicode letters, numbers, underscores, dashes and spaces; not start or end with spaces; and be at most 200 bytes long when encoded in UTF-8.

parentPolicyTagRef

Optional

object

PolicyTagRef is a reference to a DataCatalogPolicyTag.

parentPolicyTagRef.external

Optional

string

A reference to an externally managed DataCatalogPolicyTag resource. Should be in the format "projects/{{projectID}}/locations/{{location}}/taxonomies/{{taxonomyID}}/policyTags/{{policytagID}}".

parentPolicyTagRef.name

Optional

string

The name of a DataCatalogPolicyTag resource.

parentPolicyTagRef.namespace

Optional

string

The namespace of a DataCatalogPolicyTag resource.

resourceID

Optional

string

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

taxonomyRef

Required

object

TaxonomyRef is a reference to a DataCatalogTaxonomy.

taxonomyRef.external

Optional

string

A reference to an externally managed DataCatalogTaxonomy resource. Should be in the format "projects/{{projectID}}/locations/{{location}}/taxonomies/{{taxonomyID}}".

taxonomyRef.name

Optional

string

The name of a DataCatalogTaxonomy resource.

taxonomyRef.namespace

Optional

string

The namespace of a DataCatalogTaxonomy resource.

Status

Schema

childPolicyTags:
- string
conditions:
- lastTransitionTime: string
  message: string
  reason: string
  status: string
  type: string
externalRef: string
name: string
observedGeneration: integer
observedState: {}
Fields
childPolicyTags

list (string)

Resource names of child policy tags of this policy tag.
childPolicyTags[]

string
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 DataCatalogPolicyTag resource in Google Cloud.
name

string

Resource name of this policy tag, whose format is: "projects/{project}/locations/{region}/taxonomies/{taxonomy}/policyTags/{policytag}".
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.
observedState

object

ObservedState is the state of the resource as most recently observed in Google Cloud.

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: datacatalog.cnrm.cloud.google.com/v1beta1
kind: DataCatalogPolicyTag
metadata:
  name: datacatalogpolicytag-sample
spec:
  description: A policy tag normally associated with low security items
  displayName: Low security
  taxonomyRef:
    name: datacatalogtaxonomy-dep
---
apiVersion: datacatalog.cnrm.cloud.google.com/v1beta1
kind: DataCatalogTaxonomy
metadata:
  name: datacatalogtaxonomy-dep
spec:
  activatedPolicyTypes:
  - FINE_GRAINED_ACCESS_CONTROL
  description: A collection of policy tags
  displayName: my_taxonomy
  projectRef:
    # Replace ${PROJECT_ID?} with your project ID.
    external: ${PROJECT_ID?}
  region: us