URI HTTP methods Schemas Properties See also

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


{
  "tags": {
  }
}

Response bodies


{
  "tags": {
  }
}

Properties

tagsModel

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

Property Type Required Description

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.

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.