Removes tags from specified Elastic Compute Service (ECS) resources. After a tag is removed from a resource, it is automatically deleted if it is not added to other resources.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | UntagResources |
The operation that you want to perform. Set the value to UntagResources. |
RegionId | String | Yes | cn-hangzhou |
The region ID of the resource. You can call the DescribeRegions operation to query the most recent region list. |
ResourceType | String | Yes | instance |
The type of the resource. Valid values:
|
All | Boolean | No | false |
Specifies whether to remove all tags from the resource. This parameter is valid only when the TagKey.N parameter is not specified. Valid values:
Default value: false. |
ResourceId.N | String | Yes | i-bp67acfmxazb4ph**** |
The ID of the resource. Valid values of N: 1 to 50. |
TagKey.N | String | No | TestKey |
The key of tag N. Valid values of N: 1 to 20. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | C46FF5A8-C5F0-4024-8262-B16B639225A0 |
The ID of the request. |
Examples
Sample requests
https://ecs.aliyuncs.com/?Action=UntagResources
&RegionId=cn-hangzhou
&ResourceType=instance
&ResourceId.1=i-bp1j6qtvdm8w0z1o0****
&TagKey.1=TestKey
&<Common request parameters>
Sample success responses
XML
format
HTTP/1.1 200 OK
Content-Type:application/xml
<UntagResourcesResponse>
<RequestId>C46FF5A8-C5F0-4024-8262-B16B639225A0</RequestId>
</UntagResourcesResponse>
JSON
format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "C46FF5A8-C5F0-4024-8262-B16B639225A0"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | Duplicate.TagKey | The Tag.N.Key contain duplicate key. | The error message returned because the specified tag key already exists. Tag keys must be unique. |
400 | InvalidTagKey.Malformed | The specified Tag.n.Key is not valid. | The error message returned because the specified Tag.N.Key parameter is invalid. |
400 | InvalidTagValue.Malformed | The specified Tag.n.Value is not valid. | The error message returned because the specified Tag.N.Value parameter is invalid. |
400 | OperationDenied.QuotaExceed | The quota of tags on resource is beyond permitted range. | The error message returned because the maximum number of tags that can be added to the instance has been reached. |
400 | InvalidTag.Mismatch | The specified Tag.n.Key and Tag.n.Value are not match. | The error message returned because the specified Tag.N.Key parameter does not correspond to the specified Tag.N.Value parameter. |
400 | InvalidTagCount | The specified tags are beyond the permitted range. | The error message returned because the number of specified tags exceeds the upper limit. |
400 | Invalid.Scope | The specified scope is invalid. | The error message returned because the specified Scope parameter is invalid. |
403 | PermissionDenied.TagOwnerUid | The specified operator not have permission to set TagOwnerUid value. | The error message returned because you are not authorized to set the owner of the tag. |
403 | PermissionDenied.Scope | The specified operator not have permission to set Scope value. | The error message returned because you are not authorized to specify the Scope parameter. |
403 | InvalidResourceId.NotSupported | The specified ResourceId does not support tagging. | The error message returned because the specified resource does not support tagging. |
403 | NoPermission.Tag | The operator is not permission for the tag. | The error message returned because you are not authorized to manage the tag. |
404 | InvalidRegionId.NotFound | %s | The error message returned because the specified RegionId parameter does not exist. |
404 | MissingParameter.TagOwnerUid | The parameter - TagOwnerUid should not be null | The error message returned because the TagOwnerUid parameter is not specified. |
404 | MissingParameter.TagOwnerBid | The parameter - TagOwnerBid should not be null | The error message returned because the TagOwnerBid parameter is not specified. |
404 | MissingParameter.Tags | The parameter - Tags should not be null | The error message returned because the tag-related parameters are not specified. |
404 | MissingParameter.RegionId | The parameter - RegionId should not be null | The error message returned because the RegionId parameter is not specified. |
404 | InvalidResourceId.NotFound | The specified ResourceIds are not found in our records. | The error message returned because the specified ResourceId parameter does not exist. Check whether the resource ID is correct. |
404 | InvalidResourceType.NotFound | The ResourceType provided does not exist in our records. | The error message returned because the specified ResourceType parameter does not exist. |
404 | InvalidRegionId.NotFound | The specified RegionId does not exist. | The error message returned because the specified region ID does not exist. |
For a list of error codes, see Service error codes.