tag_values
Creates, updates, deletes, gets or lists a tag_values resource.
Overview
| Name | tag_values |
| Type | Resource |
| Id | aws.resourcegroupstaggingapi.tag_values |
Fields
The following fields are returned by SELECT queries:
- get_tag_values
| Name | Datatype | Description |
|---|---|---|
tag_value | string | A list of all tag values for the specified key currently used in the specified Amazon Web Services Region for the calling account. |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get_tag_values | select | region | Returns all tag values for the specified key that are used in the specified Amazon Web Services Region for the calling account. This operation supports pagination, where the response can be sent in multiple pages. You should check the PaginationToken response parameter to determine if there are additional results available to return. Repeat the query, passing the PaginationToken response parameter value as an input to the next request until you recieve a null value. A null value for PaginationToken indicates that there are no more results waiting to be returned. |
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 |
|---|---|---|
region | string | AWS region (default: us-east-1) |
SELECT examples
- get_tag_values
Returns all tag values for the specified key that are used in the specified Amazon Web Services Region for the calling account. This operation supports pagination, where the response can be sent in multiple pages. You should check the PaginationToken response parameter to determine if there are additional results available to return. Repeat the query, passing the PaginationToken response parameter value as an input to the next request until you recieve a null value. A null value for PaginationToken indicates that there are no more results waiting to be returned.
SELECT
tag_value
FROM aws.resourcegroupstaggingapi.tag_values
WHERE region = '{{ region }}' -- required
;