调用ListTagResources查询一个或多个RDS实例已经绑定的标签列表。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String ListTagResources

系统规定参数。取值:ListTagResources

RegionId String cn-hangzhou

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

ResourceType String INSTANCE

资源类型定义。唯一取值:INSTANCE

NextToken String 212db86sca4384811e0b5e8707ec21345

用来返回更多结果。第一次查询不需要提供这个参数,如果一次查询没有返回全部结果,则可在后续查询中传入前一次返回的token继续查询。

ResourceId.N String rm-uf6wjk5*******

实例ID。可以同时查询N个实例的标签,N的取值范围:1~50

说明 ResourceId.N参数和Tag.N.Key参数至少传入一个。
Tag.N.Key String testkey1

标签键。可以同时查询N个标签键,N的取值范围:1~20。不允许传入空字符串。

说明 ResourceId.N参数和Tag.N.Key参数至少传入一个。
Tag.N.Value String testvalue1

标签键对应的标签值。可以同时查询N个标签值,N的取值范围:1~20。允许传入空字符串。

返回数据

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

如果一次查询没有返回全部结果,则可在后续查询中传入前一次返回的token继续查询。

RequestId String 47A514A1-4B77-4E30-B4C5-2A880650B3FD

请求ID。

TagResources Array of TagResource

查询到的实例和标签的信息。

TagResource
TagValue String testvalue1

标签键对应的标签值。

ResourceType String ALIYUN::RDS::INSTANCE

资源类型,ALIYUN::RDS::INSTANCE即云数据库RDS实例。

ResourceId String rm-uf6wjk5xxxxxxx

实例ID。

TagKey String testkey1

标签键。

示例

请求示例

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

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ListTagResourcesResponse>
<TagResources>
    <TagResource>
        <ResourceType>ALIYUN::RDS::INSTANCE</ResourceType>
        <TagValue>testvalue1</TagValue>
        <ResourceId>rm-uf6wjk5xxxxxxx</ResourceId>
        <TagKey>testkey1</TagKey>
    </TagResource>
</TagResources>
<RequestId>47A514A1-4B77-4E30-B4C5-2A880650B3FD</RequestId>
</ListTagResourcesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TagResources" : {
    "TagResource" : [ {
      "ResourceType" : "ALIYUN::RDS::INSTANCE",
      "TagValue" : "testvalue1",
      "ResourceId" : "rm-uf6wjk5xxxxxxx",
      "TagKey" : "testkey1"
    } ]
  },
  "RequestId" : "47A514A1-4B77-4E30-B4C5-2A880650B3FD"
}

错误码

HttpCode 错误码 错误信息 描述
400 BothEmpty.TagsAndResources The specified Tags and ResourcesIds are not allow to both empty. 操作失败,标签和资源ID不允许同时为空。
400 InvalidParameter.ResourceType The parameter ResourceType is invalid. 操作失败,请检查资源类型参数正确性。

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