ListTagsForResources, TagResource, UntagResource
URI
/tags/
resource-arn
HTTP methods
GET
Operation ID: ListTagsForResources
Lists the tags for a resource.
Name | Type | Required | Description |
---|---|---|---|
resource-arn | String | True | The Amazon Resource Name (ARN) for a resource. |
Status code | Response model | Description |
---|---|---|
200 | tagsModel | 200 response - Success. |
204 | None | 204 response - Successful deletion |
400 | None | 400 response - Multiple causes. For example, you might have a malformed query string, an input parameter might be out of range, or you used parameters together incorrectly. |
404 | None | 404 response - Malformed query string. The query string contains a syntax error or resource not found. |
500 | None | 500 response - Internal service error or temporary service error. Retry the request. |
POST
Operation ID: TagResource
Adds a tag to a resource.
Name | Type | Required | Description |
---|---|---|---|
resource-arn | String | True | The Amazon Resource Name (ARN) for a resource. |
Status code | Response model | Description |
---|---|---|
200 | None | 200 response - Success. |
204 | None | 204 response - Successful deletion |
400 | None | 400 response - Multiple causes. For example, you might have a malformed query string, an input parameter might be out of range, or you used parameters together incorrectly. |
404 | None | 404 response - Malformed query string. The query string contains a syntax error or resource not found. |
500 | None | 500 response - Internal service error or temporary service error. Retry the request. |
DELETE
Operation ID: UntagResource
Removes a tag from a resource.
Name | Type | Required | Description |
---|---|---|---|
resource-arn | String | True | The Amazon Resource Name (ARN) for a resource. |
Name | Type | Required | Description |
---|---|---|---|
tagKeys | String | True | The keys for tags you add to resources. |
Status code | Response model | Description |
---|---|---|
204 | None | 204 response - Successful deletion |
400 | None | 400 response - Multiple causes. For example, you might have a malformed query string, an input parameter might be out of range, or you used parameters together incorrectly. |
404 | None | 404 response - Malformed query string. The query string contains a syntax error or resource not found. |
500 | None | 500 response - Internal service error or temporary service error. Retry the request. |
Schemas
Request bodies
{ "tags": { } }
Response bodies
{ "tags": { } }
Properties
Tags
A collection of tags associated with a resource.
Property | Type | Required | Description |
---|---|---|---|
| string | False |
tagsModel
Property | Type | Required | Description |
---|---|---|---|
tags | True |
See also
For more information about using this API in one of the language-specific AWS SDKs and references, see the following: