tags

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

Overview

Name	tags
Type	Resource
Id	aws.greengrass.tags

Fields

The following fields are returned by SELECT queries:

list_tags_for_resource

Name	Datatype	Description
tags	object

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		Retrieves a list of resource tags for a resource arn.
untag_resource	update	resource-arn, tagKeys, region		Remove resource tags from a Greengrass Resource.
tag_resource	update	resource-arn, region		Adds tags to a Greengrass resource. Valid resources are 'Group', 'ConnectorDefinition', 'CoreDefinition', 'DeviceDefinition', 'FunctionDefinition', 'LoggerDefinition', 'SubscriptionDefinition', 'ResourceDefinition', and 'BulkDeployment'.

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	The Amazon Resource Name (ARN) of the resource.
tagKeys	array	An array of tag keys to delete

SELECT examples

list_tags_for_resource

Retrieves a list of resource tags for a resource arn.

SELECT
tags
FROM aws.greengrass.tags
WHERE `resource-arn` = '{{ resource-arn }}' -- required
AND region = '{{ region }}' -- required
;

UPDATE examples

untag_resource

Remove resource tags from a Greengrass Resource.

UPDATE aws.greengrass.tags
SET 
-- No updatable properties
WHERE 
`resource-arn` = '{{ resource-arn }}' --required
AND tagKeys = '{{ tagKeys }}' --required
AND region = '{{ region }}' --required;

tag_resource

Adds tags to a Greengrass resource. Valid resources are 'Group', 'ConnectorDefinition', 'CoreDefinition', 'DeviceDefinition', 'FunctionDefinition', 'LoggerDefinition', 'SubscriptionDefinition', 'ResourceDefinition', and 'BulkDeployment'.

UPDATE aws.greengrass.tags
SET 
tags = '{{ tags }}'
WHERE 
`resource-arn` = '{{ resource-arn }}' --required
AND region = '{{ region }}' --required;