调用ListTagResources查询迁移、同步和订阅实例绑定的标签,也可以查询标签所绑定的实例。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListTagResources | 系统规定参数。取值:ListTagResources。 |
RegionId | String | 是 | cn-hangzhou | 地域ID,传入本参数来指定实例所在地域,详情请参见支持的地域列表。 |
ResourceType | String | 是 | ALIYUN::DTS::INSTANCE | 资源类型定义,取值固定为:ALIYUN::DTS::INSTANCE。 |
NextToken | String | 否 | 212db86sca4384811e0b5e8707ec2**** | 查询凭证。 如果一次查询没有返回全部结果,则可在后续查询中传入上一次查询返回的NextToken参数继续查询。 |
ResourceId.N | String | 否 | dtsntk10k6r12v**** | 数据迁移、同步和订阅的实例ID,可以通过调用DescribeDtsJobs。
|
Tag.N.Key | String | 否 | testkey1 | 标签键。
|
Tag.N.Value | String | 否 | testvalue1 | 标签的值。
|
返回数据
示例
请求示例
http(s)://dts.aliyuncs.com/?Action=ListTagResources
&RegionId=cn-hangzhou
&ResourceType=ALIYUN::DTS::INSTANCE
&ResourceId.1=dtsntk10k6r12v****
&Tag.1.Key=testkey1
&Tag.1.Value=testvalue1
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<ListTagResourcesResponse>
<RequestId>609AD332-F2B1-48B7-BF43-41FEE641****</RequestId>
<TagResources>
<ResourceId>dtsntk10k6r12v****</ResourceId>
<TagKey>testkey1</TagKey>
<ResourceType>ALIYUN::DTS::INSTANCE</ResourceType>
<TagValue>testvalue1</TagValue>
</TagResources>
<Success>true</Success>
</ListTagResourcesResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "609AD332-F2B1-48B7-BF43-41FEE641****",
"TagResources" : [ {
"ResourceId" : "dtsntk10k6r12v****",
"TagKey" : "testkey1",
"ResourceType" : "ALIYUN::DTS::INSTANCE",
"TagValue" : "testvalue1"
} ],
"Success" : true
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
419 | QuotaExceed.TagsPerResource | The maximum number of tags for each resource is exceeded. | 已超过标签数量上限,请先删除不需要的标签。 |
400 | Throttling.User | Request was denied due to user flow control. | 由于请求频次达到阈值,请求被拒绝,请稍后重试。 |
403 | InvalidSecurityToken.Expired | Specified SecurityToken is expired. | 签名已经过期,请更新签名 |
500 | ServiceUnavailable | The request has failed due to a temporary failure of the server. | 由于服务端响应超时或者不可用导致请求失败,请重试,重试后仍失败请联系技术支持。 |
访问错误中心查看更多错误码。