tags
Creates, updates, deletes, gets or lists a tags resource.
Overview
| Name | tags |
| Type | Resource |
| Id | aws.billing.tags |
Fields
The following fields are returned by SELECT queries:
- list_tags_for_resource
| Name | Datatype | Description |
|---|---|---|
resource_tags | array | A list of tag key value pairs that are associated with the resource. |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
list_tags_for_resource | select | region | Lists tags associated with the billing view resource. | |
tag_resource | update | region, resourceArn, resourceTags | An API operation for adding one or more tags (key-value pairs) to a resource. | |
untag_resource | update | region, resourceArn, resourceTagKeys | Removes one or more tags from a resource. Specify only tag keys in your request. Don't specify the value. |
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
- list_tags_for_resource
Lists tags associated with the billing view resource.
SELECT
resource_tags
FROM aws.billing.tags
WHERE region = '{{ region }}' -- required
;
UPDATE examples
- tag_resource
- untag_resource
An API operation for adding one or more tags (key-value pairs) to a resource.
UPDATE aws.billing.tags
SET
resourceArn = '{{ resourceArn }}',
resourceTags = '{{ resourceTags }}'
WHERE
region = '{{ region }}' --required
AND resourceArn = '{{ resourceArn }}' --required
AND resourceTags = '{{ resourceTags }}' --required;
Removes one or more tags from a resource. Specify only tag keys in your request. Don't specify the value.
UPDATE aws.billing.tags
SET
resourceArn = '{{ resourceArn }}',
resourceTagKeys = '{{ resourceTagKeys }}'
WHERE
region = '{{ region }}' --required
AND resourceArn = '{{ resourceArn }}' --required
AND resourceTagKeys = '{{ resourceTagKeys }}' --required;