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

调试

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

请求头

该接口使用公共请求头,无特殊请求头。请参见公共请求参数文档。

请求语法

GET /openapi/tags HTTP/1.1

请求参数

名称 类型 位置 是否必选 示例值 描述
Page Integer Query 1

资源关系列表的分页数,废弃字段。

Size Integer Query 10

分页查询时设置的每页条数,废弃字段。

ResourceType String Query INSTANCE

资源类型定义。

NextToken String Query 1d2db86sca4384811e0b5e8707e******

下一个查询开始的Token。

ResourceIds String Query ["es-cn-aaa","es-cn-bbb"]

要查询的实例ID列表。采用JSON数组格式,最多支持20个子项。

Tags String Query [{"key":"env","value","dev"},{"key":"dev", "value":"IT"}]

要查询的Tags列表,采用JSON字符串的形式,最多包含20个子项。

  • 您需要在ResourceIdsTags参数中,至少选择一个传入值,否则报错。
  • 您只能查询系统标签中的可见标签,不能查询不可见标签。
    说明 系统标签是指云产品(即阿里云服务)给用户实例添加的标签。系统标签分为可见标签和不可见标签。

返回数据

名称 类型 示例值 描述
PageSize Integer 1

分页数。

RequestId String F99407AB-2FA9-489E-A259-40CF6D******

请求ID。

Headers Object

返回头信息。该参数为空,仅供参考,程序中不能强制依赖此参数。

说明 返回示例中不包含此参数。
X-Total-Count Integer 10

查询到TagResource的资源数量。

TagResources Object

标签资源组。

TagResource Array of TagResource

标签资源。

TagValue String dev

标签值。

ResourceType String ALIYUN::ELASTICSEARCH::INSTANCE

资源类型。固定为ALIYUN::ELASTICSEARCH::INSTANCE

ResourceId String es-cn-oew1q8bev0002****

资源ID。

TagKey String env

标签键。

示例

请求示例

GET /openapi/tags?ResourceType=INSTANCE&NextToken=1d2db86sca4384811e0b5e8707e******&ResourceIds=["es-cn-aaa","es-cn-bbb"]&Tags=[{"key":"env","value","dev"},{"key":"dev",  "value":"IT"}] HTTP/1.1
Host:elasticsearch.aliyuncs.com
Content-Type:application/json

正常返回示例

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "A5423B74-DBD5-4714-BF28-6725E5BE****",
  "TagResources" : {
    "TagResource" : [ {
      "ResourceType" : "ALIYUN::ELASTICSEARCH::INSTANCE",
      "ResourceId" : "es-cn-oew1q8bev0002****",
      "TagKey" : "env",
      "TagValue" : "dev"
    } ]
  }
}

错误码

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