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

  • 对于Tag.N.Key及Tag.N.Value中相同的N是一对键值对。
  • ResourceId.N需满足所有输入的键值对。当输入多个键值对，查询结果为资源中包含指定多个键值对的资源。
  • 查询返回符合条件的资源及符合条件的标签的标签资源关系，当过滤后没有匹配的资源标签关系则返回空列表。
  • 用户同时查询用户标签跟可见系统标签。
  • 除必填参数传入外，传入ResourceId.N，查询某个region的指定资源的可见资源标签关系。
  • 除必填参数传入外，传入Tag.N.Key，查询某个region的指定Key下的可见资源标签关系。
  • ResourceId.N 及 (Tag.N.Key,Tag.N.Value) 至少存在一个。
  • 单次操作，标签可以为相同类型的，也可以不同类型。
  • 用户对于用户标签全部的查询权限，用户有查询可见系统标签的权限。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
NextToken String 是 1d2db86sca4384811e0b5e8707e68181f

下一个查询开始Token
ResourceType String 是 apiGroup

资源类型定义。

目前分组，插件，应用接入了标签，API相关操作基于分组的标签：

  • apiGroup
  • plugin
  • app
Tag.N.Key String 是 env

标签键。

N的取值范围为：[1, 20]
Action String 否 ListTagResources

接口名称，系统规定参数，取值：ListTagResources。

ResourceId.N RepeatList 否 285bb759342649a1b70c2093a772e087

资源ID。

N的取值范围为：[1, 50]
Tag.N.Value String 否 product

标签值。当参数有值，要求对应的tag.N.Key在相同的N的标签键也传入值，否则会报错。

N的取值范围为：[1, 20]

返回数据

名称 类型 示例值 描述
NextToken String 1d2db86sca4384811e0b5e8707e68181f

下一个查询开始的Token。

NextToken为-1表示没有下一个。

RequestId String 2D69A58F-345C-4FDE-88E4-BF5189484043

请求ID
TagResources Array

资源列表
TagResource

资源列表
ResourceId String 285bb759342649a1b70c2093a772e087

资源ID
ResourceType String apiGroup

资源类型
TagKey String owner

标签键
TagValue String zhangsan

标签值

示例

请求示例


http(s)://apigateway.cn-qingdao.aliyuncs.com/?Action=ListTagResources
&NextToken=1d2db86sca4384811e0b5e8707e68181f
&ResourceType=apiGroup
&Tag.1.Key=env
&<公共请求参数>

正常返回示例

XML 格式 

<ListTagResourcesResponse>
      <RequestId>2D69A58F-345C-4FDE-88E4-BF5189484043</RequestId>
      <NextToken>1d2db86sca4384811e0b5e8707e68181f</NextToken>
      <TagResources>
            <TagResource>
                  <ResourceId>285bb759342649a1b70c2093a772e087</ResourceId>
                  <ResourceType>apiGroup</ResourceType>
                  <TagKey>env</TagKey>
                  <TagValue>product</TagValue>
            </TagResource>
            <TagResource>
                  <ResourceId>285bb759342649a1b70c2093a772e087</ResourceId>
                  <ResourceType>apiGroup</ResourceType>
                  <TagKey>owner</TagKey>
                  <TagValue>zhangsan</TagValue>
            </TagResource>
      </TagResources>
</ListTagResourcesResponse>

JSON 格式 

{
	"TagResources":{
		"TagResource":[
			{
				"ResourceType":"apiGroup",
				"TagValue":"product",
				"ResourceId":"285bb759342649a1b70c2093a772e087",
				"TagKey":"env"
			},
			{
				"ResourceType":"apiGroup",
				"TagValue":"zhangsan",
				"ResourceId":"285bb759342649a1b70c2093a772e087",
				"TagKey":"owner"
			}
		]
	},
	"NextToken":"1d2db86sca4384811e0b5e8707e68181f",
	"PageSize":1,
	"RequestId":"2D69A58F-345C-4FDE-88E4-BF5189484043"
}

错误码

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