tags

Creates, updates, deletes, gets or lists a tags resource.

Overview

Name	tags
Type	Resource
Id	aws.appmesh.tags

Fields

The following fields are returned by SELECT queries:

list_tags_for_resource

Name	Datatype	Description
key	string	One part of a key-value pair that make up a tag. A key is a general label that acts like a category for more specific tag values.
value	string	The optional part of a key-value pair that make up a tag. A value acts as a descriptor within a tag category (key).

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_tags_for_resource	select	resourceArn, region	limit, nextToken	List the tags for an App Mesh resource.
tag_resource	update	resourceArn, region, tags		Associates the specified tags to a resource with the specified resourceArn. If existing tags on a resource aren't specified in the request parameters, they aren't changed. When a resource is deleted, the tags associated with that resource are also deleted.
untag_resource	update	resourceArn, region, tagKeys		Deletes specified tags from 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)
resourceArn	string	The Amazon Resource Name (ARN) of the resource to delete tags from.
limit	integer	The maximum number of tag results returned by ListTagsForResource in paginated output. When this parameter is used, ListTagsForResource returns only limit results in a single page along with a nextToken response element. You can see the remaining results of the initial request by sending another ListTagsForResource request with the returned nextToken value. This value can be between 1 and 100. If you don't use this parameter, ListTagsForResource returns up to 100 results and a nextToken value if applicable.
nextToken	string	The nextToken value returned from a previous paginated ListTagsForResource request where limit was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value.

SELECT examples

list_tags_for_resource

List the tags for an App Mesh resource.

SELECT
key,
value
FROM aws.appmesh.tags
WHERE resourceArn = '{{ resourceArn }}' -- required
AND region = '{{ region }}' -- required
AND limit = '{{ limit }}'
AND nextToken = '{{ nextToken }}'
;

UPDATE examples

tag_resource

Associates the specified tags to a resource with the specified resourceArn. If existing tags on a resource aren't specified in the request parameters, they aren't changed. When a resource is deleted, the tags associated with that resource are also deleted.

UPDATE aws.appmesh.tags
SET 
tags = '{{ tags }}'
WHERE 
resourceArn = '{{ resourceArn }}' --required
AND region = '{{ region }}' --required
AND tags = '{{ tags }}' --required;

untag_resource

Deletes specified tags from a resource.

UPDATE aws.appmesh.tags
SET 
tagKeys = '{{ tagKeys }}'
WHERE 
resourceArn = '{{ resourceArn }}' --required
AND region = '{{ region }}' --required
AND tagKeys = '{{ tagKeys }}' --required;