Docs

Elastic Compute Service

Volume tag

DeleteTags - Delete Tags

Use the DeleteTags API to delete user tags for one or more resources.

precautions

You can delete up to 20 tags in a single API call.

Repeatedly unbinding tags will overwrite original results and update tag values.

Debugging

API Explorer

You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.

Go to debug

request parameters

Only the unique request parameters for this API and some common parameters are listed below. For more information, see Common Parameters.

Action string required Example value: DeleteTags

The operation to perform is: DeleteTags.

Version string required Example value: 2020-04-01

The version of the API is: 2020-04-01.

ResourceType string required Example value: volume

Resource Type, values:

volume: cloud disk.

Snapshot: snapshot.

Snapshot Policy: automatic snapshot policy.

snapshotgroup: snapshot consistency group.

ResourceIds.N string[] required Example value: ResourceIds.1=vol-76pwr6rilv8lzwxv****&ResourceIds.2=vol-76pwr6rilv8lzwxv****

Resource IDs of the tags to be deleted. Description as follows:

ResourceIds.N: N represents the resource number, with a range of 1–50.

Use & to separate multiple resources.

TagKeys.N string[] required Example value: TagKeys.1=tag

The tag key to delete.

TagKeys.N: N represents the sequence number of the tag key. Value range: 1-20.

Separate multiple tag keys with “&”.

Response Parameters

This interface does not have specific return parameters. For more information, see Return structure.

Request example

GET /?Action=DeleteTags&Version=2020-04-01&ResourceType=volume&ResourceIds.1=vol-76pwr6rilv8lzwxv*****&ResourceIds.2=vol-76pwr6rilv8lzwxv****&TagKeys.1=tag HTTP/1.1​
Host: open.volcengineapi.com​
Region: cn-beijing​
ServiceName: storage_ebs​

Back to example

{​
    "ResponseMetadata": {​
        "RequestId": "202303031134568758D54369753EAE****",​
        "Action": "DeleteTags",​
        "Version": "2020-04-01",​
        "Service": "storage_ebs",​
        "Region": "cn-beijing"​
    },​
    "Result": {}​
}​

error code

The table below lists error codes related to this interface and business logic. For public error codes, refer to the Public Error Code documentation.

Status code	error code	error message	Create Volume
400	ErrResourceIdNotFound	resource id not found	Resource ID not found
400	ErrMaximumResourceIds	too many resource ids	Resource ID exceeds the limit.
400	ErrResourceTypeNotFound	resource type not found	Resource type not found
400	ErrTagKeyNotFound	tag key not found	Tag key not found.
400	ErrInvalidTagKeyNum	too many tag keys	Tag key exceeds the limit.
400	ErrInvalidTagKey	tag key invalid	Invalid tag key.
400	ErrTagServiceUnavailable	tag service unavailable	Tag service is unavailable.
500	ErrUnknown	unknown error	Unknown error.

Last updated: 2026.01.09 18:19:56