Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors See Also

UntagResource

Removes a resource tag. Each tag is a label consisting of a user-defined key and value. Tags can help you manage, identify, organize, search for, and filter resources.

Request Syntax


POST /tags/ResourceArn HTTP/1.1
Content-type: application/json

{
   "TagKeys": [ "string" ]
}

URI Request Parameters

The request uses the following URI parameters.

ResourceArn

Amazon Resource Name (ARN) for the resource you want to untag.

Length Constraints: Minimum length of 0. Maximum length of 1000.

Required: Yes

Request Body

The request accepts the following data in JSON format.

TagKeys

Array of tag key-value pairs that you want to untag.

Type: Array of strings

Array Members: Minimum number of 0 items. Maximum number of 50 items.

Length Constraints: Minimum length of 1. Maximum length of 128.

Required: Yes

Response Syntax


HTTP/1.1 200

Response Elements

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

You do not have sufficient access to perform this action. Check your permissions, and try again.

Message: Message for the AccessDeniedException error.

HTTP Status Code: 403

InternalServerException

The service encountered an internal error. Try your request again. If the problem persists, contact AWS Support.

Message: Message for the InternalServerException error.

HTTP Status Code: 500

ResourceNotFoundException

The specified resource doesn't exist. Check the resource ID, and try again.

Message: Message for the ResourceNotFoundException error.

HTTP Status Code: 404

ThrottlingException

The request was denied due to request throttling.

Message: Message for the ThrottlingException error.

HTTP Status Code: 429

ValidationException

The input fails to satisfy the constraints specified by an AWS service.

Message: Message for the ValidationException error.

HTTP Status Code: 400