华为云计算 云知识 为指定云硬盘批量添加标签BatchCreateVolumeTags
为指定云硬盘批量添加标签BatchCreateVolumeTags

 

功能介绍

为指定 云硬盘 批量添加标签。

添加标签时,如果云硬盘的标签已存在相同key,则会覆盖已有标签。 单个云硬盘最多支持创建10个标签。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

POST /v2/{project_id}/cloudvolumes/{volume_id}/tags/action

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。 获取方法请参见"获取项目ID"。

volume_id

String

云硬盘ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。 通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

表3 请求Body参数

参数

是否必选

参数类型

描述

action

String

操作标识,当前支持的取值如下:

添加标签:create

缺省值:create

枚举值:

  • create

tags

Array of Tag objects

标签列表。

表4 Tag

参数

是否必选

参数类型

描述

key

String

标签键。同一资源的key值不能重复。 最大长度36个字符。 字符集:A-Z,a-z , 0-9,‘-’,‘_’,UNICODE字符(\u4E00-\u9FFF)。

value

String

标签值。 最大长度43个字符。 字符集:A-Z,a-z , 0-9,‘.’,‘-’,‘_’,UNICODE字符(\u4E00-\u9FFF)。

响应参数

状态码: 400

表5 响应Body参数

参数

参数类型

描述

error

Error object

出现错误时,返回的错误信息,具体请参见 error参数说明

表6 Error

参数

参数类型

描述

code

String

出现错误时,返回的错误码。错误码和其对应的含义请参考错误码说明

message

String

出现错误时,返回的错误消息。

请求示例

添加两个标签给一个指定的云硬盘,一个标签key为key1,value为value1,另一个标签key为key2,value为value3。

POST https://{endpoint}/v2/{project_id}/cloudvolumes/{volume_id}/tags/action

{
  "action" : "create",
  "tags" : [ {
    "key" : "key1",
    "value" : "value1"
  }, {
    "key" : "key2",
    "value" : "value3"
  } ]
}

响应示例

状态码: 400

Bad Request

{
  "error" : {
    "message" : "XXXX",
    "code" : "XXX"
  }
}

状态码

状态码

描述

204

No Content

400

Bad Request

错误码

请参见错误码

 

上一篇:Ceph是什么 下一篇:什么是密钥对管理服务

云硬盘 EVS

云硬盘(Elastic Volume Service)是一种为ECS、BMS等计算服务提供持久性块存储的服务,通过数据冗余和缓存加速等多项技术,提供高可用性和持久性,以及稳定的低时延性能。您可以对云硬盘做格式化、创建文件系统等操作,并对数据做持久化存储