You need to enable JavaScript to run this app.
导航
云服务器
  • 文档首页
    • /
  • 云服务器

DeleteTags

最近更新时间：2024.04.25 17:11:27

首次发布时间：2023.03.03 16:32:18

我的收藏

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

调试

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

注意事项

  • 单次调用该接口最多可删除20个标签。

  • 重复解绑标签会覆盖原有结果，标签值更新。

请求参数

名称类型是否必填示例值描述
ActionString是DeleteTags要执行的操作，取值：DeleteTags。

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错误码错误信息
400ErrTagServiceUnabletag服务禁用
400ErrTagNotFoundtag参数为空
400InvalidTagKeyConflicttag参数重复
400ErrInvalidTagCounttag数量过多
400ErrInvalidTagKeytag key非法
400ErrInvalidTagValuetag value非法
400ErrTagKeyNotFoundtag key为空
400ErrInvalidResourceIdNotFoundresource id为空
400ErrMaximumResourceIdsresource id数量过多
400ErrResourceTypeNotFoundresource type为空
400ErrResourceTypeUnknownresource type未知
400ErrInvalidTagKeyCounttag key数量过多
400ErrInvalidAccountIdaccount id非法
400ErrCallTagPlatform访问tag平台失败
400ErrQueryTagDBdb 持久化失败