批量创建安全组资源标签

功能介绍

为指定的安全组资源实例批量添加标签。

此接口为幂等接口：创建时如果请求体中存在重复key则报错。创建时，不允许设置重复key数据，如果数据库已存在该key，就覆盖value的值。

接口约束

此接口为幂等接口：创建时如果请求体中存在重复key则报错。创建时，不允许设置重复key数据,如果数据库已存在该key，就覆盖value的值

URI

POST /v2.0/{project_id}/security-groups/{security_group_id}/tags/action

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID
security_group_id	是	String	安全组资源ID

请求参数

表2 请求Body参数
参数	是否必选	参数类型	描述
action	是	String	操作标识
tags	是	Array of ResourceTag objects	标签列表

表3 ResourceTag
参数	是否必选	参数类型	描述
key	是	String	功能说明：标签键约束：同一资源的key值不能重复。最小长度：0 最大长度：36
value	是	String	功能说明：标签值最小长度：0 最大长度：43

响应参数

状态码： 400

表4 响应Body参数
参数	参数类型	描述
code	String	请求返回的错误码
message	String	请求返回的错误信息最小长度：1 最大长度：999

状态码： 401

表5 响应Body参数
参数	参数类型	描述
code	String	请求返回的错误码
message	String	请求返回的错误信息最小长度：1 最大长度：999

状态码： 403

表6 响应Body参数
参数	参数类型	描述
code	String	请求返回的错误码
message	String	请求返回的错误信息最小长度：1 最大长度：999

状态码： 404

表7 响应Body参数
参数	参数类型	描述
code	String	请求返回的错误码
message	String	请求返回的错误信息最小长度：1 最大长度：999

状态码： 409

表8 响应Body参数
参数	参数类型	描述
code	String	请求返回的错误码
message	String	请求返回的错误信息最小长度：1 最大长度：999

状态码： 500

表9 响应Body参数
参数	参数类型	描述
code	String	请求返回的错误码
message	String	请求返回的错误信息最小长度：1 最大长度：999

请求示例

example-1：删除资源标签

POST https://{Endpoint}/v2.0/{project_id}/security-groups/{security_group_id}/tags/action

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

example-2：批量创建资源标签

POST https://{Endpoint}/v2.0/{project_id}/security-groups/{security_group_id}/tags/action

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

响应示例

无

状态码

状态码	描述
204	正常返回
400	服务器未能处理请求。
401	被请求的页面需要用户名和密码。
403	对被请求页面的访问被禁止。
404	服务器无法找到被请求的页面。
409	由于冲突，请求无法被完成。
500	请求未完成。服务异常。