更新时间:2023-07-17 GMT+08:00

查询云服务器标签

功能介绍

  • 查询指定云服务器的标签信息。
  • 标签管理服务TMS使用该接口查询指定云服务器的全部标签数据。
  • 该接口支持企业项目细粒度权限的校验,具体细粒度请参见 ecs:cloudServers:showServerTags

URI

GET /v1/{project_id}/cloudservers/{server_id}/tags

参数说明请参见表1
表1 参数说明

参数

是否必选

描述

project_id

项目ID。

获取方法请参见获取项目ID

server_id

云服务器ID。

请求消息

响应消息

响应参数如表2所示。

表2 响应参数

参数

参数类型

描述

tags

Array of objects

标签列表,详情参见表3

表3 tags 字段数据结构说明

参数

参数类型

描述

key

String

标签键。

value

String

标签值。

请求示例

查询指定云服务器的所有标签信息。

GET https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/tags

响应示例

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

返回值

请参考通用请求返回值

错误码

请参考错误码