调用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。 |
| Tag.N.Key | String | 否 | testkey1 |
标签键。可以同时查询N个标签键，N的取值范围：1~20。不允许传入空字符串。 |
| 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 |
资源类型， |
| 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
ALIYUN::RDS::INSTANCE
testvalue1
rm-uf6wjk5xxxxxxx
testkey1
47A514A1-4B77-4E30-B4C5-2A880650B3FD
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. | 操作失败，请检查资源类型参数正确性。 |
访问错误中心查看更多错误码。
内容没看懂？ 不太想学习？想快速解决？ 有偿解决： 联系专家
阿里云企业补贴进行中： 马上申请
腾讯云限时活动1折起，即将结束： 马上收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利:同意关联，立享优惠
转转请注明出处：https://www.yunxiaoer.com/154237.html