文档首页/ 专属主机 DeH/ API参考/ API/ 专属主机标签管理/ 查询指定专属主机标签 - ShowDedicatedHostTags
更新时间:2025-11-14 GMT+08:00

查询指定专属主机标签 - ShowDedicatedHostTags

功能介绍

  • 查询指定专属主机的标签信息。
  • 标签管理服务(TMS)使用该接口查询指定专属主机的全部标签数据。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项

URI

GET /v1.0/{project_id}/dedicated-host-tags/{dedicated_host_id}/tags

参数说明请参见表1

表1 参数说明

参数

参数类型

是否必选

描述

project_id

String

项目ID。

dedicated_host_id

String

专属主机ID。

可以从专属主机控制台查询,或者通过调用查询专属主机列表 - ListDedicatedHostsAPI获取。

请求消息

响应消息

表2 响应参数

参数

参数类型

描述

tags

Array of objects

标签列表。

详情请参见表3

表3 tag字段数据结构说明

名称

参数类型

说明

key

String

标签键。

value

String

标签值。

请求示例

查询ID为74259164-e63a-4ad9-9c77-a1bd2c9aa187的专属主机的标签信息。

GET https://{Endpoint}/v1.0/9c53a566cb3443ab910cf0daebca90c4/dedicated-host-tags/74259164-e63a-4ad9-9c77-a1bd2c9aa187/tags

响应示例

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

返回值

请参见状态码