该接口用于查询一个或多个POLARDB集群已绑定的标签列表，或者查询一个或多个标签绑定的POLARDB集群列表。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
RegionId String 是 cn-hangzhou

地域ID，可以通过接口DescribeRegions查看可用的地域ID。

ResourceType String 是 cluster

资源类型定义。唯一取值：cluster。

Action String 否 ListTagResources

系统规定参数。取值：ListTagResources。

AccessKeyId String 否 LTAIfCxxxxxxx

阿里云颁发给用户的访问服务所用的密钥ID。
ResourceId.N RepeatList 否 pc-bp1l20nxxxxxxxxxx

集群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继续查询。

返回数据

名称 类型 示例值 描述
NextToken String 212db86sca4384811e0b5e8707ec21345

用来返回更多结果。如果一次查询没有返回全部结果，则可在后续查询中传入前一次返回的token继续查询。
RequestId String 184DE106-CB2C-4DD2-B57F-396652E6C8F8

请求ID。
TagResources Array

查询到的集群和标签的信息。
TagResource

查询到的集群和标签的信息。
ResourceId String pc-bp1l20nxxxxxxxxxx

集群ID。
ResourceType String cluster

资源类型，cluster即云数据库POLARDB集群。

TagKey String testkey1

标签键。
TagValue String testvalue1

标签键对应的标签值。

示例

请求示例


http(s)://polardb.aliyuncs.com/?Action=ListTagResources
&RegionId=cn-hangzhou
&ResourceType=cluster
&ResourceId.1=pc-bp1l20nxxxxxxxxxx
&Tag.1.Key=testkey1
&<公共请求参数>

正常返回示例

XML 格式 

<TagResources>
    <TagResource>
        <ResourceType>cluster</ResourceType>
        <TagValue>testvalue1</TagValue>
        <ResourceId>pc-bp1l20nxxxxxxxxxx</ResourceId>
        <TagKey>testkey1</TagKey>
    </TagResource>
</TagResources>
<RequestId>184DE106-CB2C-4DD2-B57F-396652E6C8F8</RequestId>

JSON 格式 

{
	"TagResources":{
		"TagResource":[
			{
				"ResourceType":"cluster",
				"TagValue":"testvalue1",
				"ResourceId":"pc-bp1l20nxxxxxxxxxx",
				"TagKey":"testkey1"
			}
		]
	},
	"RequestId":"184DE106-CB2C-4DD2-B57F-396652E6C8F8"
}

错误码

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