文档首页/ 全球加速 GA/ API参考/ API/ 标签/ 查询特定资源标签 - ShowResourceTags
更新时间：2025-11-04 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询特定资源标签 - ShowResourceTags

功能介绍

查询特定资源标签。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    ga:tag:get

    Read

    accelerator

    g:ResourceTag/<tag-key>

    -

    -

    listener

    g:ResourceTag/<tag-key>

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

resource_type

是

Object

资源类型，取值范围：

  • ga-accelerators：加速实例

  • ga-listeners：监听器

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

标签键，取值范围：

  • key不能为空，长度1~128个字符（中文也可以输入128个字符）。

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

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

value

String

标签值，取值范围：

  • 长度0~255个字符（中文也可以输入255个字符）。

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

  • 资源标签值可以为空（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

操作成功

错误码

请参见错误码。

父主题： 标签

相关文档