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.