tag_values_namespaced
Creates, updates, deletes, gets or lists a tag_values_namespaced
resource.
Overview
Name | tag_values_namespaced |
Type | Resource |
Id | google.cloudresourcemanager.tag_values_namespaced |
Fields
The following fields are returned by SELECT
queries:
- get_namespaced
Successful response
Name | Datatype | Description |
---|---|---|
name | string | Immutable. Resource name for TagValue in the format tagValues/456 . |
createTime | string (google-datetime) | Output only. Creation time. |
description | string | Optional. User-assigned description of the TagValue. Must not exceed 256 characters. Read-write. |
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. |
namespacedName | string | 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} . |
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 256 characters or less, beginning and ending with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_), dots (.), and alphanumerics between. |
updateTime | string (google-datetime) | Output only. Update time. |
Methods
The following methods are available for this resource:
Name | Accessible by | Required Params | Optional Params | Description |
---|---|---|---|---|
get_namespaced | select | name | Retrieves a TagValue by its namespaced name. This method will return PERMISSION_DENIED if the value does not exist or the user does not have permission to view it. |
Parameters
Parameters can be passed in the WHERE
clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
Name | Datatype | Description |
---|---|---|
name | string |
SELECT
examples
- get_namespaced
Retrieves a TagValue by its namespaced name. This method will return PERMISSION_DENIED
if the value does not exist or the user does not have permission to view it.
SELECT
name,
createTime,
description,
etag,
namespacedName,
parent,
shortName,
updateTime
FROM google.cloudresourcemanager.tag_values_namespaced
WHERE name = '{{ name }}';