All Products
Search
Document Center

ApsaraDB for MyBase:UntagResources

Last Updated:Aug 28, 2026

Removes tags from hosts.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

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.

  • N specifies the serial number of the tag. Examples:

    • Tag.1.Key specifies the key of the first tag.

    • Tag.2.Key specifies the key of the second tag.

  • If no tag key exists, a key is automatically created.

demokey

All

boolean

No

Whether to remove all tags from the host. Valid values:

  • true

  • false

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.