Tag Key Args
Creates a new TagKey. If 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 TagKeys can exist under a parent at any given time.
Properties
Optional. User-assigned description of the TagKey. Must not exceed 256 characters. Read-write.
Immutable. The resource name of the TagKey's parent. A TagKey can be parented by an Organization or a Project. For a TagKey parented by an Organization, its parent must be in the form organizations/{org_id}
. For a TagKey parented by a Project, its parent can be in the form projects/{project_id}
or projects/{project_number}
.
Optional. A purpose denotes that this Tag is intended for use in policies of a specific policy engine, and will involve that policy engine in management operations involving this Tag. A purpose does not grant a policy engine exclusive rights to the Tag, and it may be referenced by other policy engines. A purpose cannot be changed once set.
Optional. Purpose data corresponds to the policy system that the tag is intended for. See documentation for Purpose
for formatting of this field. Purpose data cannot be changed once set.
Immutable. The user friendly name for a TagKey. The short name should be unique for TagKeys within the same tag namespace. The short name must be 1-63 characters, beginning and ending with an alphanumeric character (a-z0-9A-Z) with dashes (-), underscores (_), dots (.), and alphanumerics between.