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

查询安全组资源标签

功能介绍

查询指定安全组实例的标签信息。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

security_group_id

是

String

安全组资源ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

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

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

tags

Array of ResourceTag objects

tag对象列表
表4 ResourceTag

参数

参数类型

描述

key

String

功能说明：标签键

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

value

String

功能说明：标签值

状态码： 400

表5 响应Body参数

参数

参数类型

描述

code

String

请求返回的错误码

message

String

请求返回的错误信息

状态码： 401

表6 响应Body参数

参数

参数类型

描述

code

String

请求返回的错误码

message

String

请求返回的错误信息

状态码： 403

表7 响应Body参数

参数

参数类型

描述

code

String

请求返回的错误码

message

String

请求返回的错误信息

状态码： 404

表8 响应Body参数

参数

参数类型

描述

code

String

请求返回的错误码

message

String

请求返回的错误信息

状态码： 409

表9 响应Body参数

参数

参数类型

描述

code

String

请求返回的错误码

message

String

请求返回的错误信息

状态码： 500

表10 响应Body参数

参数

参数类型

描述

code

String

请求返回的错误码

message

String

请求返回的错误信息

请求示例

查询安全组资源标签

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

响应示例

状态码： 200

正常返回

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

状态码

状态码

描述

200

正常返回

400

服务器未能处理请求。

401

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

403

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

404

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

409

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

500

请求未完成。服务异常。

错误码

请参见错误码。

分享：

    相关文档

    相关产品