功能介绍
为指定保护实例批量添加或删除标签。一个资源上最多有10个标签。 此接口为幂等接口: 创建时如果请求体中存在重复key则报错。 创建时,不允许设置重复key数据,如果 数据库 已存在该key,就覆盖value的值。
接口约束
无
调试
您可以在API Explorer中调试该接口。
URI
POST /v1/{project_id}/protected-instances/{protected_instance_id}/tags/action
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID。 |
protected_instance_id |
是 |
String |
保护实例的ID。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值) |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
tags |
是 |
标签列表。 |
|
action |
是 |
String |
操作标识,取值仅限于:create:创建 枚举值:
|
响应参数
状态码: 400
状态码: 401
状态码: 403
状态码: 404
状态码: 500
请求示例
添加标签
POST https://{Endpoint}/v1/{project_id}/protected-instances/67a2cc7e-fb87-41a8-ba28-9c032abcaee1/tags/action { "action" : "create", "tags" : [ { "key" : "key1", "value" : "value1" }, { "key" : "key", "value" : "value3" } ] }
响应示例
无
状态码
状态码 |
描述 |
---|---|
204 |
No Content |
400 |
Bad Request |
401 |
Unauthorized |
403 |
Forbidden |
404 |
Not Found |
500 |
Internal Server Error |
错误码
请参见错误码。