调用DescribeTagValues接口查找一个迁移、同步或订阅实例绑定的标签键对应的所有值。

调试

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

请求参数

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

系统规定参数。取值：DescribeTagValues。
PageSize Integer 否 20

当一个标签键对应多个标签值时，选择一次返回标签值的个数，默认为20。
PageNumber Integer 否 1

页码，当一个标签键对应多个标签值时，选择返回的起始页。取值为大于0且不超过Integer数据类型的最大值，通常与PageSize搭配使用，默认值为1。
ResourceType String 否 ALIYUN::DTS::INSTANCE

系统服务规定参数，固定取值为：ALIYUN::DTS::INSTANCE。

ResourceId String 否 dtsl5o11f9029c****

数据迁移、同步或订阅的实例ID，可以通过调用DescribeDtsJobs接口查询。

说明 取值为空时，返回该用户下对应标签键的所有标签值。
Category String 否 Custom

标签键类型，取值：

  • Custom：用户添加的标签键。
  • System：系统创建的标签键。
说明 当值为空时，默认返回所有的标签键。
Key String 否 owner

标签的键值。
RegionId String 否 cn-hangzhou

DTS实例所属的地域，详情请参见支持的地域列表。

返回数据

名称 类型 示例值 描述
Category String Custom

标签键类型。
PageNumber Integer 1

标签值的起始页。
PageSize Integer 20

每页返回标签值的数量。
RequestId String AD110813-9AD6-5F07-BFC8-4C841309****

请求ID。
TagValues List ["a","x"]

标签键对应的标签值。
TotalCount Integer 13

标签键对应标签值的总数。

示例

请求示例

http(s)://dts.aliyuncs.com/?Action=DescribeTagValues
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML格式 

<DescribeTagValuesResponse>
      <pageNumber>1</pageNumber>
      <tagValues>a</tagValues>
      <tagValues>b</tagValues>
      <totalRecordCount>13</totalRecordCount>
      <pageRecordCount>10</pageRecordCount>
      <requestId>AD110813-9AD6-5F07-BFC8-4C841309****</requestId>
      <success>true</success>
      <httpStatusCode>200</httpStatusCode>
</DescribeTagValuesResponse>

JSON格式 

{
    "pageNumber": 1,
    "tagValues": [
        "a",
        "b"
    ],
    "totalRecordCount": 13,
    "pageRecordCount": 10,
    "requestId": "AD110813-9AD6-5F07-BFC8-4C841309****",
    "success": true,
    "httpStatusCode": 200
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidParameter.Category The specified Category is invalid. Valid values are Custom and System. 标签类型非法，合法值为Custom，System。
400 InvalidParameter.ResourceType The ResourceType parameter is invalid. 参数ResourceType无效，请输入固定值ALIYUN::DTS::INSTANCE。

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