调用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"
}

错误码

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