Resource: TagKey
A TagKey, used to group a set of TagValues.
JSON representation |
---|
{
"name": string,
"parent": string,
"shortName": string,
"namespacedName": string,
"description": string,
"createTime": string,
"updateTime": string,
"etag": string,
"purpose": enum ( |
Fields | |
---|---|
name |
Immutable. The resource name for a TagKey. Must be in the format |
parent |
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 |
shortName |
Required. 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. |
namespacedName |
Output only. Immutable. Namespaced name of the TagKey. |
description |
Optional. User-assigned description of the TagKey. Must not exceed 256 characters. Read-write. |
createTime |
Output only. Creation time. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
updateTime |
Output only. Update time. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
etag |
Optional. Entity tag which users can pass to prevent race conditions. This field is always set in server responses. See UpdateTagKeyRequest for details. |
purpose |
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. |
purposeData |
Optional. Purpose data corresponds to the policy system that the tag is intended for. See documentation for Purpose data cannot be changed once set. |
Purpose
A purpose for each policy engine requiring such an integration. A single policy engine may have multiple purposes defined, however a TagKey may only specify a single purpose.
Enums | |
---|---|
PURPOSE_UNSPECIFIED |
Unspecified purpose. |
GCE_FIREWALL |
Purpose for Compute Engine firewalls. A corresponding
|
DATA_GOVERNANCE |
Purpose for data governance. Tag Values created under a key with this purpose may have Tag Value children. No purposeData should be set. |
Methods |
|
---|---|
|
Creates a new TagKey. |
|
Deletes a TagKey. |
|
Retrieves a TagKey. |
|
Gets the access control policy for a TagKey. |
|
Retrieves a TagKey by its namespaced name. |
|
Lists all TagKeys for a parent resource. |
|
Updates the attributes of the TagKey resource. |
|
Sets the access control policy on a TagKey, replacing any existing policy. |
|
Returns permissions that a caller has on the specified TagKey. |