文档首页> 虚拟私有云 VPC> API参考> API> 安全组资源标签管理> 批量创建安全组资源标签
更新时间：2024-07-01 GMT+08:00
前往Github编辑
查看PDF
分享

批量创建安全组资源标签

功能介绍

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

此接口为幂等接口：创建时如果请求体中存在重复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 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

获取Token，请参考《统一身份认证服务API参考》的“获取用户Token”章节。请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。
表3 请求Body参数

参数

是否必选

参数类型

描述

action

是

String

操作标识

tags

是

Array of ResourceTag objects

标签列表
表4 ResourceTag

参数

是否必选

参数类型

描述

key

是

String

功能说明：标签键

约束：同一资源的key值不能重复。

value

是

String

功能说明：标签值

响应参数

状态码： 400

表5 响应Body参数

参数

参数类型

描述

NeutronError

NeutronError object

NeutronError对象
表6 NeutronError

参数

参数类型

描述

message

String

错误请求返回的错误信息

type

String

错误请求返回的错误类型

detail

String

错误请求返回的错误详情

状态码： 401

表7 响应Body参数

参数

参数类型

描述

NeutronError

NeutronError object

NeutronError对象
表8 NeutronError

参数

参数类型

描述

message

String

错误请求返回的错误信息

type

String

错误请求返回的错误类型

detail

String

错误请求返回的错误详情

状态码： 403

表9 响应Body参数

参数

参数类型

描述

NeutronError

NeutronError object

NeutronError对象
表10 NeutronError

参数

参数类型

描述

message

String

错误请求返回的错误信息

type

String

错误请求返回的错误类型

detail

String

错误请求返回的错误详情

状态码： 404

表11 响应Body参数

参数

参数类型

描述

NeutronError

NeutronError object

NeutronError对象
表12 NeutronError

参数

参数类型

描述

message

String

错误请求返回的错误信息

type

String

错误请求返回的错误类型

detail

String

错误请求返回的错误详情

状态码： 409

表13 响应Body参数

参数

参数类型

描述

NeutronError

NeutronError object

NeutronError对象
表14 NeutronError

参数

参数类型

描述

message

String

错误请求返回的错误信息

type

String

错误请求返回的错误类型

detail

String

错误请求返回的错误详情

状态码： 500

表15 响应Body参数

参数

参数类型

描述

NeutronError

NeutronError object

NeutronError对象
表16 NeutronError

参数

参数类型

描述

message

String

错误请求返回的错误信息

type

String

错误请求返回的错误类型

detail

String

错误请求返回的错误详情

请求示例

  • 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

请求未完成。服务异常。

错误码

请参见错误码。

分享：

    相关文档

    相关产品