文档首页/ 全球加速 GA/ API参考/ API/ 标签/ 查询特定资源标签
更新时间:2024-11-11 GMT+08:00
分享

查询特定资源标签

功能介绍

查询特定资源标签。

调用方法

请参见如何调用API

URI

GET /v1/{resource_type}/{resource_id}/tags

表1 路径参数

参数

是否必选

参数类型

描述

resource_type

Object

资源类型。

resource_id

String

资源ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

tags

Array of ResourceTag objects

标签列表。

request_id

String

请求ID。

表4 ResourceTag

参数

参数类型

描述

key

String

标签键,规则:

  • 1.key不能为空,长度1~128个字符(中文也可以输入128个字符)。

  • 2.可用 UTF-8 格式表示的字母(包含中文)、数字和空格,以及以下字符_ . : = + - @。

  • 3._sys_开头属于系统标签,租户不能输入。

value

String

标签值,规则:

  • 1.长度0~255个字符(中文也可以输入255个字符)。

  • 2.可用 UTF-8 格式表示的字母(包含中文)、数字和空格,以及以下字符_ . : / = + - @。

  • 3.资源标签值可以为空(empty or null)。

请求示例

查询特定资源标签

GET https://{ga_endpoint}/v1/{resource_type}/{resource_id}/tags

响应示例

状态码: 200

操作成功

{
  "tags" : [ {
    "key" : "tagKey",
    "value" : "tagValue"
  } ],
  "request_id" : "915a14a6-867b-4af7-83d1-70efceb146f9"
}

状态码

状态码

描述

200

操作成功

错误码

请参见错误码

相关文档