调用ListTagResources查询可见的资源标签关系。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求头

该接口使用公共请求头,无特殊请求头。更多信息,请参见公共请求参数

请求语法

GET /tags 

请求参数

名称 类型 位置 是否必选 示例值 描述
resource_ids Array of String Query c71cf3d796c374bf48644482cb0c3****

集群ID。

tags Array of tag Query

要查询的标签列表,限制最多包含20个子项。

next_token String Query ***

下一个查询开始的令牌。

返回数据

名称 类型 示例值 描述
next_token String c374bf4864448****

下一个查询开始的令牌。

request_id String E368C761-F8F6-4A36-9B58-BD53D5CD0CEB

请求ID。

tag_resources object

标签资源集。

tag_resource Array of tag_resource

标签资源。

tag_key String ack.aliyun.com

标签的名称。

tag_value String c71cf3d796c374bf48644482cb0c3****

标签值。

resource_id String i-xxx

资源ID。

resource_type String CLUSTER

资源类型。更多信息,请参见标签

示例

请求示例

GET /tags?resource_ids=["c71cf3d796c374bf48644482cb0c3****"]&tags=["ack.aliyun.com"]

正常返回示例

XML 格式

<tag_resources>
    <tag_resource>
        <tag_value>c71cf3d796c374bf48644482cb0c3****</tag_value>
        <resource_type>CLUSTER</resource_type>
        <resource_id>i-xxx</resource_id>
        <tag_key>ack.aliyun.com</tag_key>
    </tag_resource>
</tag_resources>
<next_token>c374bf4864448****</next_token>
<request_id>E368C761-F8F6-4A36-9B58-BD53D5CD0CEB</request_id>

JSON 格式

{
  "tag_resources": {
    "tag_resource": [
      {
        "tag_value": "c71cf3d796c374bf48644482cb0c3****",
        "resource_type": "CLUSTER",
        "resource_id": "i-xxx",
        "tag_key": "ack.aliyun.com"
      }
    ]
  },
  "next_token": "c374bf4864448****",
  "request_id": "E368C761-F8F6-4A36-9B58-BD53D5CD0CEB"
}

错误码

访问错误中心查看更多错误码。