Removes tags from resources.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
ResourceType | String | Yes | VPC | The resource type. Valid values:
Note The values are case-insensitive. |
All | Boolean | No | false | Specifies whether to remove all tags from the specified resource. Valid values:
|
ResourceId.N | String | No | vpc-bp16qjewdsunr41m1**** | The resource ID. You can specify at most 50 resource IDs. |
TagKey.N | String | No | FinanceDept | The key of the tag that you want to remove. You can specify at most 20 tag keys. A tag key can be up to 128 characters in length. It can be an empty string. It cannot start with |
RegionId | String | Yes | cn-hangzhou | The region ID of the resource. You can call the DescribeRegions operation to query the most recent region list. |
Action | String | Yes | UnTagResources | The operation that you want to perform. Set the value to UnTagResources. |
Response parameters
Parameter | Type | Example | Description |
RequestId | String | C46FF5A8-C5F0-4024-8262-B16B639225A0 | The request ID. |
Examples
Sample requests
http(s)://[Endpoint]/?ResourceType=VPC
&All=false
&ResourceId=["vpc-bp16qjewdsunr41m1****"]
&TagKey=["FinanceDept"]
&RegionId=cn-hangzhou
&Action=UnTagResources
&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\t"
}
Error codes
HttpCode | Error code | Error message | Description |
400 | InvalidTagKey | The tag keys are not valid. | The error message returned because the tag index is invalid. |
400 | InvalidTagValue | The tag values are not valid. | The error message returned because the tag value is invalid. |
400 | InvalidInstanceType.NotFound | The instance type is not found | The error message returned because the instance type is not found. |
400 | InvalidInstanceIds.NotFound | The instanceIds are not found | The error message returned because the instance ID is not found. |
400 | Forbidden.TagKeys | The request do not allow to operate the tag keys | The error message returned because you do not have the permissions to set the TagKeys parameter. |
400 | QuotaExceeded.TagNum | Custom Tags quota exceeded | The error message returned because the quota is exceeded. |
400 | Forbidden.NotAllowedCategary | The System tag is not valid | The error message returned because the system tag is invalid. |
400 | Forbidden.TagKeys | The request does not allow operate this tagkeys | The error message returned because you cannot manage the tag key by calling the operation. |
400 | Forbidden.TagKey.Duplicated | The specified tag key already exists. | The error message returned because the tag key already exists. |
400 | SizeLimitExceeded.TagNum | The maximum number of tags is exceeded. | The error message returned because the number of tags exceeds the upper limit. |
400 | SizeLimitExceeded.ResourceId | The maximum number of resource IDs is exceeded. | The error message returned because the number of resource group IDs exceeds the upper limit. |
403 | Forbidden | User not authorized to operate on the specified resource. | The error message returned because you are unauthorized to perform the operation on the specified resource. Acquire the required permissions and try again. |
For a list of error codes, see Service error codes.