UntagResource
Deletes tags from an Application Auto Scaling scalable target. To delete a tag, specify the tag key and the Application Auto Scaling scalable target.
Request Syntax
{
"ResourceARN": "string
",
"TagKeys": [ "string
" ]
}
Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
The request accepts the following data in JSON format.
- ResourceARN
-
Identifies the Application Auto Scaling scalable target from which to remove tags.
For example:
arn:aws:application-autoscaling:us-east-1:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123
To get the ARN for a scalable target, use DescribeScalableTargets.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 1011.
Pattern:
^arn:.+:application-autoscaling:.+:[0-9]+:scalable-target\/[a-zA-Z0-9-]+$
Required: Yes
- TagKeys
-
One or more tag keys. Specify only the tag keys, not the tag values.
Type: Array of strings
Array Members: Minimum number of 0 items. Maximum number of 200 items.
Length Constraints: Minimum length of 1. Maximum length of 128.
Required: Yes
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.
- ResourceNotFoundException
-
The specified resource doesn't exist.
HTTP Status Code: 400
- ValidationException
-
An exception was thrown for a validation issue. Review the available parameters for the API request.
HTTP Status Code: 400
Examples
If you plan to create requests manually, you must replace the Authorization
header contents in the examples (AUTHPARAMS
) with a signature. For more information,
see Signing
Amazon API requests in the IAM User Guide.
If you plan to use the Amazon CLI
Example
The following example removes the tag pair with the key name "environment" from the scalable target specified by its ARN.
Sample Request
POST / HTTP/1.1
Host: application-autoscaling.us-west-2.amazonaws.com
Accept-Encoding: identity
Content-Length: [content-length]
X-Amz-Target: AnyScaleFrontendService.UntagResource
X-Amz-Date: 20230506T211829Z
User-Agent: aws-cli/2.0.0 Python/3.7.5 Windows/10 botocore/2.0.0dev4
Content-Type: application/x-amz-json-1.1
Authorization: AUTHPARAMS
{
"ResourceARN": "arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123",
"TagKeys": [ "environment" ]
}
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: