调用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相关操作基于分组的标签:
|
Tag.N.Key | String | 是 | env |
标签键。 N的取值范围为: |
Action | String | 否 | ListTagResources |
接口名称,系统规定参数,取值:ListTagResources。 |
ResourceId.N | RepeatList | 否 | 285bb759342649a1b70c2093a772e087 |
资源ID。 N的取值范围为: |
Tag.N.Value | String | 否 | product |
标签值。当参数有值,要求对应的tag.N.Key在相同的N的标签键也传入值,否则会报错。 N的取值范围为: |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
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"
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交