ListTagResources
调用ListTagResources查询一个或多个RDS实例已经绑定的标签列表。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListTagResources |
系统规定参数。取值:ListTagResources。 |
RegionId | String | 是 | cn-hangzhou |
地域ID,可以通过接口DescribeRegions查看可用的地域ID。 |
ResourceType | String | 是 | INSTANCE |
资源类型定义。唯一取值:INSTANCE。 |
ResourceId.N | RepeatList | 否 | rm-uf6wjk5xxxxxxx |
实例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。 |
NextToken | String | 212db86sca4384811e0b5e8707ec21345 |
如果一次查询没有返回全部结果,则可在后续查询中传入前一次返回的token继续查询。 |
TagResources | Array |
查询到的实例和标签的信息。 |
|
TagKey | String | testkey1 |
标签键。 |
TagValue | String | testvalue1 |
标签键对应的标签值。 |
ResourceType | String | ALIYUN::RDS::INSTANCE |
资源类型, |
ResourceId | String | rm-uf6wjk5xxxxxxx |
实例ID。 |
示例
请求示例
http(s)://rds.aliyuncs.com/?Action=ListTagResources
&RegionId=cn-hangzhou
&ResourceType=INSTANCE
&ResourceId.1=rm-uf6wjk5xxxxxxx
&Tag.1.Key=testkey1
&<公共请求参数>
正常返回示例
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
格式
{
"TagResources":{
"TagResource":[
{
"ResourceType":"ALIYUN::RDS::INSTANCE",
"TagValue":"testvalue1",
"ResourceId":"rm-uf6wjk5xxxxxxx",
"TagKey":"testkey1"
}
]
},
"RequestId":"47A514A1-4B77-4E30-B4C5-2A880650B3FD"
}
错误码
访问错误中心查看更多错误码。
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论