调用ListTagResources,查询可见的资源标签关系_检索分析服务 Elasticsearch版(ES)-阿里云帮助中心

调试

您可以在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个子项。

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

返回数据

名称	类型	示例值	描述
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"
    } ]
  }
}

错误码

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