文档首页/ 虚拟私有云 VPC/ API参考/ API/ 安全组资源标签管理/ 创建安全组资源标签
更新时间：2024-09-03 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建安全组资源标签

功能介绍

给指定安全组资源实例增加标签信息。

此接口为幂等接口：创建时，如果创建的标签已经存在（key相同），则覆盖。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

security_group_id

是

String

安全组资源ID

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

tag

是

ResourceTag object

创建安全组资源标签请求体
表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

请求示例

创建安全组资源标签

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

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

响应示例

无

状态码

状态码

描述

204

正常返回

400

服务器未能处理请求。

401

被请求的页面需要用户名和密码。

403

对被请求页面的访问被禁止。

404

服务器无法找到被请求的页面。

409

由于冲突，请求无法被完成。

500

请求未完成。服务异常。

错误码

请参见错误码。

相关文档