DeleteTags--云服务器-火山引擎

文档中心

立即注册

导航

云服务器

DeleteTags

最近更新时间：2024.11.01 18:49:26首次发布时间：2023.03.03 16:32:18

调用 DeleteTags 接口为一个或多个资源删除用户标签。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

注意事项

单次调用该接口最多可删除20个标签。
重复解绑标签会覆盖原有结果，标签值更新。

请求参数

名称	类型	是否必填	示例值	描述
Action	String	是	DeleteTags	要执行的操作，取值：DeleteTags。
Version	String	是	2020-04-01	API的版本，取值：2020-04-01。
ResourceType	String	是	volume	资源类型，取值： volume：云盘。
ResourceIds.N	String	是	ResourceIds.1=vol-76pwr6rilv8lzwxv**&ResourceIds.2=vol-76pwr6rilv8lzwxv**	需要删除标签的资源ID。说明如下： ResourceIds.N：`N`表示资源的序号，取值范围：1～50。多个资源之间用`&`分隔。
TagKeys.N	String	是	TagKeys.1=tag	需要删除的标签键。 TagKeys.N：`N`表示标签键的序号。取值范围：1～20。多个标签键之间用`&`分隔。命名规则如下：不能以任何大小写形式的`volc:`或`sys:`开头，`volc:`或`sys:`开头为系统预留标签键，禁止创建。只能包含语言字符、数字、空格和特殊符号`_.:/=+-@`。长度限制在1～128个字符之间。

返回数据

null

请求示例

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

返回示例

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

错误码

HttpCode	错误码	错误信息
400	ErrTagServiceUnable	tag服务禁用
400	ErrTagNotFound	tag参数为空
400	InvalidTagKeyConflict	tag参数重复
400	ErrInvalidTagCount	tag数量过多
400	ErrInvalidTagKey	tag key非法
400	ErrInvalidTagValue	tag value非法
400	ErrTagKeyNotFound	tag key为空
400	ErrInvalidResourceIdNotFound	resource id为空
400	ErrMaximumResourceIds	resource id数量过多
400	ErrResourceTypeNotFound	resource type为空
400	ErrResourceTypeUnknown	resource type未知
400	ErrInvalidTagKeyCount	tag key数量过多
400	ErrInvalidAccountId	account id非法
400	ErrCallTagPlatform	访问tag平台失败
400	ErrQueryTagDB	db 持久化失败