REST Resource: tagValues

Resource: TagValue

A TagValue is a child of a particular TagKey. This is used to group cloud resources for the purpose of controlling them using policies.

JSON representation
{
  "name": string,
  "parent": string,
  "shortName": string,
  "namespacedName": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "etag": string
}
Fields
name

string

Immutable. Resource name for TagValue in the format tagValues/456.

parent

string

Immutable. The resource name of the new TagValue's parent TagKey. Must be of the form tagKeys/{tag_key_id}.

shortName

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.

namespacedName

string

Output only. The namespaced name of the TagValue. Can be in the form {organizationId}/{tag_key_short_name}/{tag_value_short_name} or {projectId}/{tag_key_short_name}/{tag_value_short_name} or {projectNumber}/{tag_key_short_name}/{tag_value_short_name}.

description

string

Optional. User-assigned description of the TagValue. Must not exceed 256 characters.

Read-write.

createTime

string (Timestamp format)

Output only. Creation time.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Output only. Update time.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

etag

string

Optional. Entity tag which users can pass to prevent race conditions. This field is always set in server responses. See UpdateTagValueRequest for details.

Methods

create

Creates a TagValue as a child of the specified TagKey.

delete

Deletes a TagValue.

get

Retrieves a TagValue.

getIamPolicy

Gets the access control policy for a TagValue.

getNamespaced

Retrieves a TagValue by its namespaced name.

list

Lists all TagValues for a specific TagKey.

patch

Updates the attributes of the TagValue resource.

setIamPolicy

Sets the access control policy on a TagValue, replacing any existing policy.

testIamPermissions

Returns permissions that a caller has on the specified TagValue.