tags
Creates, updates, deletes, gets or lists a tags resource.
Overview
| Name | tags |
| Type | Resource |
| Id | aws.dataexchange.tags |
Fields
The following fields are returned by SELECT queries:
- list_tags_for_resource
| Name | Datatype | Description |
|---|---|---|
tags | object | A label that consists of a customer-defined key and an optional value. |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
list_tags_for_resource | select | resource_arn, region | This operation lists the tags on the resource. | |
untag_resource | update | resource_arn, tagKeys, region | This operation removes one or more tags from a resource. | |
tag_resource | update | resource_arn, region | This operation tags a resource. |
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) |
resource_arn | string | An Amazon Resource Name (ARN) that uniquely identifies an AWS resource. |
tagKeys | array | The key tags. |
SELECT examples
- list_tags_for_resource
This operation lists the tags on the resource.
SELECT
tags
FROM aws.dataexchange.tags
WHERE resource_arn = '{{ resource_arn }}' -- required
AND region = '{{ region }}' -- required
;
UPDATE examples
- untag_resource
- tag_resource
This operation removes one or more tags from a resource.
UPDATE aws.dataexchange.tags
SET
-- No updatable properties
WHERE
resource_arn = '{{ resource_arn }}' --required
AND tagKeys = '{{ tagKeys }}' --required
AND region = '{{ region }}' --required;
This operation tags a resource.
UPDATE aws.dataexchange.tags
SET
Tags = '{{ Tags }}'
WHERE
resource_arn = '{{ resource_arn }}' --required
AND region = '{{ region }}' --required;