Tags resource-arn - AWS IoT 1-Click

Tags resource-arn

Adds, modifies or deletes one or more resource tags (metadata key/value pairs associated with a resource) given the ARN of a resource. For more information, see AWS Tagging Strategies

URI

/tags/resource-arn

HTTP Methods

GET

Operation ID: ListTagsForResource

Lists the tags associated with the specified resource ARN.

Path Parameters
Name Type Required Description
resource-arn String True

The ARN of the resource.

Responses
Status Code Response Model Description
200 tagsModel

200 response

POST

Operation ID: TagResource

Adds or updates the tags associated with the resource ARN. See AWS IoT 1-Click Service Limits for the maximum number of tags allowed per resource.

Path Parameters
Name Type Required Description
resource-arn String True

The ARN of the resource.

Responses
Status Code Response Model Description
204 None

204 response

DELETE

Operation ID: UntagResource

Using tag keys, deletes the tags (key/value pairs) associated with the specified resource ARN.

Path Parameters
Name Type Required Description
resource-arn String True

The ARN of the resource.

Query Parameters
Name Type Required Description
tagKeys String True

A collections of tag keys. For example, {"key1","key2"}

Responses
Status Code Response Model Description
204 None

204 response

Schemas

Request Bodies

Example POST

{ "tags": { } }

Response Bodies

Example tagsModel

{ "tags": { } }

Properties

tagsModel

Contains tag information (resource metadata key/value pairs).

Property Type Required Description
tags

object

True

A collection of key/value pairs defining the resource tags. For example, { "tags": {"key1": "value1", "key2": "value2"} }. For more information, see AWS Tagging Strategies.

See Also

For more information about using this API in one of the language-specific AWS SDKs and references, see the following:

ListTagsForResource

TagResource

UntagResource