调用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 RepeatList dtsntk10k6r12v****

数据迁移、同步和订阅的实例ID,可以通过调用DescribeDtsJobs

说明
  • N表示传入第几个实例ID。例如:ResourceId.1表示传入第一个实例ID;ResourceId.2表示传入第二个实例ID。可以同时查询1~50个实例ID。
  • 该参数和Tag.N.Key参数至少传入一个。
Tag.N.Key String testkey1

标签键。

说明
  • N表示传入第几个标签的键。例如:Tag.1.Key表示传入第一个标签的键;Tag.2.Key表示传入第二个标签的键。可以同时查询1~20个标签键。
  • 该参数和ResourceId.N参数至少传入一个,且传入时不允许传入空字符串。
Tag.N.Value String testvalue1

标签的值。

说明
  • N表示传入第几个标签的值。例如:Tag.1.Value表示传入第一个标签的值;Tag.2.Value表示传入第二个标签的值。可以同时查询1~20个标签值。
  • 允许传入空字符串。

返回数据

名称 类型 示例值 描述
ErrCode String InternalError

调用出错时返回的错误码。

ErrMessage String The request processing has failed due to some unknown error.

调用错误时返回对应的错误信息。

NextToken String 212db86sca4384811e0b5e8707ec2****

查询凭证。

说明 如果此次查询没有返回全部结果,则可在后续查询中传入此NextToken参数继续查询。
RequestId String 609AD332-F2B1-48B7-BF43-41FEE641****

请求ID。

Success Boolean true

请求是否成功。

TagResources Array of TagResource

返回标签集合。

TagResource
ResourceId String dtsntk10k6r12v****

实例ID。

ResourceType String ALIYUN::DTS::INSTANCE

资源类型定义,取值固定为ALIYUN::DTS::INSTANCE

TagKey String testkey1

标签键。

TagValue 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格式

<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格式

{
	"RequestId": "609AD332-F2B1-48B7-BF43-41FEE641****",
	"TagResources": [
		{
			"ResourceId": "dtsntk10k6r12v****",
			"TagKey": "testkey1",
			"ResourceType": "ALIYUN::DTS::INSTANCE",
			"TagValue": "testvalue1"
		}
	],
	"Success": true
}

错误码

HttpCode 错误码 错误信息 描述
419 QuotaExceed.TagsPerResource The maximum number of tags for each resource is exceeded. 资源上的标签超限

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