全部产品
云市场

用户查询标签接口

更新时间:2019-08-08 17:22:47

描述

  • 此接口查询可见的资源标签关系。
  • 对于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) 至少存在一个
  • 单次操作,标签可以为相同类型的,也可以不同类型。
  • 用户对于用户标签全部的查询权限。用户有查询可见系统标签的权限。

请求参数

名称 类型 是否必选 描述
Action String 接口名称,系统规定参数,取值:ListTagResources
ResourceType String 资源类型定义,目前分组,插件,应用接入了标签,API相关操作基于分组的标签:
- apiGroup
- plugin
- app
ResourceId.N String 资源ID,n 的取值范围为 [1, 50]
Tag.N.Key String 标签键。n 的取值范围为 [1, 20]
Tag.N.Value String 标签值。n 的取值范围为 [1, 20]。当参数有值,要求对应当tag.N.Key在相同的N的标签键也传入值,否则会报错
NextToken String 下一个查询开始Token

返回参数

名称 类型 描述
RequestId String 本次请求编号
NextToken String 下一个查询开始Token,NextToken为-1说明没有下一个
TagResources Array 资源列表TagResource

示例

请求示例
  1. https://apigateway.cn-qingdao.aliyuncs.com/?Action=ListTagResources
  2. &ResourceType=apiGroup
  3. &ResourceId.1=285bb759342649a1b70c2093a772e087
  4. &<公共请求参数>
返回示例

XML格式

  1. <ListTagResourcesResponse>
  2. <RequestId>2D69A58F-345C-4FDE-88E4-BF5189484043</RequestId>
  3. <NextToken>1d2db86sca4384811e0b5e8707e68181f</NextToken>
  4. <TagResources>
  5. <TagResource>
  6. <ResourceId>285bb759342649a1b70c2093a772e087</ResourceId>
  7. <ResourceType>apiGroup</ResourceType>
  8. <TagKey>env</TagKey>
  9. <TagValue>product</TagValue>
  10. </TagResource>
  11. <TagResource>
  12. <ResourceId>285bb759342649a1b70c2093a772e087</ResourceId>
  13. <ResourceType>apiGroup</ResourceType>
  14. <TagKey>owner</TagKey>
  15. <TagValue>zhangsan</TagValue>
  16. </TagResource>
  17. </TagResources>
  18. </ListTagResourcesResponse>

JSON格式

  1. {
  2. "RequestId": "2D69A58F-345C-4FDE-88E4-BF5189484043",
  3. "PageSize":1,
  4. "NextToken":"1d2db86sca4384811e0b5e8707e68181f",
  5. "TagResources":{
  6. "TagResource":[
  7. {
  8. "ResourceId":"285bb759342649a1b70c2093a772e087",
  9. "ResourceType":"apiGroup",
  10. "TagKey":"env",
  11. "TagValue":"product"
  12. },{
  13. "ResourceId":"285bb759342649a1b70c2093a772e087",
  14. "ResourceType":"apiGroup",
  15. "TagKey":"owner",
  16. "TagValue":"zhangsan"
  17. }
  18. ]
  19. }
  20. }