调用ListTagResources查询一个或多个AnalyticDB MySQL集群已绑定的标签列表,或者查询一个或多个标签绑定的AnalyticDB MySQL集群列表。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListTagResources |
系统规定参数。取值:ListTagResources。 |
RegionId | String | 是 | cn-hangzhou |
地域ID,您可通过接口DescribeRegions查看可用的地域ID。 |
ResourceType | String | 是 | cluster |
资源类型定义。唯一取值:cluster。 |
NextToken | String | 否 | 212db86sca4384811e0b5e8707ec21345 |
用来返回更多结果。第一次查询不需要提供这个参数,如果一次查询没有返回全部结果,则可在后续查询中传入前一次返回的Token继续查询。 |
ResourceId.N | String | 否 | am-bp1l20nxxxxxxxxxx |
集群ID。支持同时传入多个集群ID,N的取值范围为:1~50。 说明 ResourceId.N参数和Tag.N.Key参数至少传入一个。
|
Tag.N.Key | String | 否 | testkey1 |
标签键。支持同时传入多个标签键,不允许传入空字符串。N的取值范围为:1~20。 说明 ResourceId.N参数和Tag.N.Key参数至少传入一个。
|
Tag.N.Value | String | 否 | testvalue1 |
标签键对应的标签值。支持同时传入多个标签值,允许传入空字符串。N的取值范围为:1~20。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
NextToken | String | 212db86sca4384811e0b5e8707ec21345 |
用来返回更多结果。如果一次查询没有返回全部结果,则可在后续查询中传入前一次返回的token继续查询。 |
RequestId | String | 184DE106-CB2C-4DD2-B57F-396652E6C8F8 |
请求ID。 |
TagResources | Array of TagResource |
查询到的集群和标签的信息。 |
|
TagResource | |||
ResourceType | String | cluster |
资源类型,cluster即云原生数据仓库AnalyticDB MySQL集群。 |
TagValue | String | testvalue1 |
标签键对应的标签值。 |
ResourceId | String | am-bp1l20nxxxxxxxxxx |
集群ID。 |
TagKey | String | testkey1 |
标签键。 |
示例
请求示例
http(s)://adb.aliyuncs.com/?Action=ListTagResources
&RegionId=cn-hangzhou
&ResourceType=cluster
&NextToken=212db86sca4384811e0b5e8707ec21345
&ResourceId=["am-bp1l20nxxxxxxxxxx"]
&Tag=[{"Key":"testkey1","Value":"testvalue1"}]
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<ListTagResourcesResponse>
<NextToken>212db86sca4384811e0b5e8707ec21345</NextToken>
<RequestId>184DE106-CB2C-4DD2-B57F-396652E6C8F8</RequestId>
<TagResources>
<ResourceType>cluster</ResourceType>
<TagValue>testvalue1</TagValue>
<ResourceId>am-bp1l20nxxxxxxxxxx</ResourceId>
<TagKey>testkey1</TagKey>
</TagResources>
</ListTagResourcesResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"NextToken" : "212db86sca4384811e0b5e8707ec21345",
"RequestId" : "184DE106-CB2C-4DD2-B57F-396652E6C8F8",
"TagResources" : {
"ResourceType" : "cluster",
"TagValue" : "testvalue1",
"ResourceId" : "am-bp1l20nxxxxxxxxxx",
"TagKey" : "testkey1"
}
}
错误码
访问错误中心查看更多错误码。