Removes tags from hosts.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| RegionId |
string |
Yes |
The region ID of the host. |
ap-southeast-1 |
| ResourceId |
array |
Yes |
The ID of host N. You can specify multiple host IDs. |
|
|
string |
No |
The ID of host N. You can specify multiple host IDs. N specifies the serial number of the host. Examples: Resourceid.1 specifies the ID of the first host. Resourceid.2 specifies the ID of the second host. |
ch-t4n4dcdvu6840**** |
|
| TagKey |
array |
No |
The key of tag N. |
|
|
string |
No |
The key of tag N.
|
demokey |
|
| All |
boolean |
No |
Whether to remove all tags from the host. Valid values:
Note
If you specify both this parameter and the TagKey.N parameter, this parameter does not take effect. |
false |
| ResourceType |
string |
Yes |
The resource type. Set the value to DEDICATEDHOST. |
DEDICATEDHOST |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The request ID. |
||
| RequestId |
string |
The request ID. |
B74AD197-214C-50F2-BF7D-B13632EE4D75 |
Examples
Success response
JSON format
{
"RequestId": "B74AD197-214C-50F2-BF7D-B13632EE4D75"
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | NoPermission.SystemTag | The operator is not permission for the system tag | The operator is not permission for the system tag |
| 400 | InvalidParameter.TagValue | The Tag.%s.Value parameter - %s is invalid | The Tag.%s.Value parameter - %s is invalid |
| 400 | InvalidParameter.TagKey | The Tag.%s.Key parameter - %s is invalid | The Tag.%s.Key parameter - %s is invalid |
| 400 | NumberExceed.ResourceIds | The ResourceIds parameter's number is exceed , Valid : 50 | |
| 400 | InvalidTagValue.Malformed | The specified parameter "Tag.n.Value" is not valid. | |
| 400 | InvalidDedicatedHostId.NotFound | The parameter - ResourceIds.N is not found. | The parameter - ResourceIds.N is not found. |
| 400 | InvalidParameter.ResourceType | The specified parameter "ResourceType" is not valid. | |
| 400 | NumberExceed.Tags | The Tags parameter's number is exceed, Valid : 20. | |
| 400 | MissingParameter.ResourceIds | The parameter - ResourceIds.N should not be null. | The parameter - ResourceIds.N should not be null. |
| 400 | Duplicate.TagKey | The Tag.N.Key contain duplicate key. | |
| 400 | InvalidTagKey.Malformed | The Tag.N.Key parameter is invalid. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.