文档首页/ 云备份 CBR/ API参考/ API/ 标签/ 添加存储库资源标签
更新时间:2024-12-12 GMT+08:00
分享

添加存储库资源标签

功能介绍

一个资源上最多有10个标签(支持landingzone的region支持20个)。

此接口为幂等接口:创建时,如果创建的标签已经存在(key相同),则覆盖。

URI

POST /v3/{project_id}/vault/{vault_id}/tags

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目id

vault_id

String

资源id

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

tag

Tag object

标签

表3 Tag

参数

是否必选

参数类型

描述

key

String

键。

key最大长度为36个字符。

key不能为空字符串。

key前后空格会被丢弃。

key不能包含非打印字符ASCII(0-31),“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。

key只能由中文,字母,数字,“-”,“_”组成。

value

String

值。

添加标签时value值必选,删除标签时value值可选。

value最大长度为43个字符。

value可以为空字符串。

value前后的空格会被丢弃。

value不能包含非打印字符ASCII(0-31),“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。

value只能由中文,字母,数字,“-”,“_”,“.”组成。

响应参数

状态码: 400

表4 响应Body参数

参数

参数类型

描述

error_code

String

请参见错误码

error_msg

String

错误信息

请求示例

添加存储库标签

POST  https://{endpoint}/v3/{project_id}/vault/{vault_id}/tags

{
  "tag" : {
    "key" : "key1",
    "value" : "key2"
  }
}

响应示例

状态码

状态码

描述

204

No Content

400

Bad Request

错误码

请参见错误码

相关文档