批量添加或删除存储库资源标签 - BatchCreateAndDeleteVaultTags
功能介绍
为指定实例批量添加或删除标签
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,当前API调用无需身份策略权限。
URI
POST /v3/{project_id}/vault/{vault_id}/tags/action
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| tags | 否 | Array of BulkCreateAndDeleteTags objects | 参数解释: 标签列表。 约束限制: tags不允许为空列表,最多包含10个key且tags中key不允许重复。 取值范围: 不涉及 默认取值: 不涉及 |
| sys_tags | 否 | Array of SysTagCreate objects | 参数解释: 系统标签列表。 约束限制: op_service权限可以访问,tags和sys_tags必须二选一、不能同时为空,且现在仅支持create操作。 取值范围: 不涉及 默认取值: 不涉及 |
| action | 是 | String | 参数解释: 用于指定对标签执行的操作类型 约束限制: 不涉及 取值范围: 默认取值: 不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| key | 是 | String | 参数解释: 用于标识资源的标签键 约束限制: 创建时请求体中不允许重复key,如果添加的key已添加到资源上,则覆盖,删除时允许重复key且不做字符集校验,但tags结构体不能缺失且key不能为空,不存在的标签默认删除成功。 取值范围: key最大长度为36字符且不能为空,前后空格会被丢弃,不能包含非打印字符(ASCII 0-31)及 = * < > \ , | /;特定场景下仅允许中文、字母、数字、“-”、“”,其他场景仅允许字母、数字、“”、“-”。 默认取值: 不涉及 |
| value | 否 | String | 参数解释: 用于标识资源的标签值 约束限制: 添加标签时value值必选,删除标签时value值可选 取值范围: value最大长度为43个字符,不能包含非打印字符ASCII(0-31),“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”但是可以为空字符串,同时,value前后的空格会被丢弃 value只能由中文,字母,数字,“-”,“_”,“.”组成。 默认取值: 不涉及 |
请求示例
批量创建tag
POST https://{endpoint}/v3/{project_id}/vault/{vault_id}/tags/action
{
"tags" : [ {
"key" : "string",
"value" : "string"
}, {
"key" : "string1",
"value" : "string2"
} ],
"action" : "create"
} 响应示例
无
状态码
| 状态码 | 描述 |
|---|---|
| 204 | No Content |
| 400 | Bad Request |
错误码
请参见错误码。