Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-132865105.6 KB
tagValues

Creates a TagValue as a child of the specified TagKey. If a 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 TagValues can exist under a TagKey at any given time.

post/v3/tagValues

Query parameters

validateOnlyboolean

Optional. Set as true to perform the validations necessary for creating the resource, but not actually perform the action.

Request body

parentstring

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

etagstring

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

descriptionstring

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

namespacedNamestring

Output only. The namespaced name of the TagValue. Can be in the form {organization_id}/{tag_key_short_name}/{tag_value_short_name} or {project_id}/{tag_key_short_name}/{tag_value_short_name} or {project_number}/{tag_key_short_name}/{tag_value_short_name}.

updateTimestring google-datetime

Output only. Update time.

namestring

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

shortNamestring

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 256 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between.

createTimestring google-datetime

Output only. Creation time.

Response

Successful response