調用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

說明
  • N表示傳入第幾個實例ID。例如:ResourceId.0表示傳入第一個實例ID;ResourceId.1表示傳入第二個實例ID。可以同時查詢1~50個實例ID。
  • 該參數和Tag.N.Key參數至少傳入一個。
Tag.N.Key String testkey1

標簽鍵。

說明
  • N表示傳入第幾個標簽的鍵。例如:Tag.0.Key表示傳入第一個標簽的鍵;Tag.1.Key表示傳入第二個標簽的鍵。可以同時查詢1~20個標簽鍵。
  • 該參數和ResourceId.N參數至少傳入一個,且傳入時不允許傳入空字符串。
Tag.N.Value String testvalue1

標簽的值。

說明
  • N表示傳入第幾個標簽的值。例如:Tag.0.Value表示傳入第一個標簽的值;Tag.1.Value表示傳入第二個標簽的值。可以同時查詢1~20個標簽值。
  • 允許傳入空字符串。

返回數據

名稱 類型 示例值 描述
NextToken String 212db86sca4384811e0b5e8707ec2****

查詢憑證。

說明 如果此次查詢沒有返回全部結果,則可在后續查詢中傳入此NextToken參數繼續查詢。
RequestId String 609AD332-F2B1-48B7-BF43-41FEE641****

請求ID。

ErrCode String InternalError

調用出錯時返回的錯誤碼。

Success Boolean true

請求是否成功。

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

調用錯誤時返回對應的錯誤信息。

TagResources Array of TagResource

返回標簽集合。

TagResource
TagValue String testvalue1

標簽鍵對應的標簽值。

ResourceType String ALIYUN::DTS::INSTANCE

資源類型定義,取值固定為ALIYUN::DTS::INSTANCE

ResourceId String dtsntk10k6r12v****

實例ID。

TagKey String testkey1

標簽鍵。

示例

請求示例

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 錯誤碼 錯誤信息 描述
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. 由于服務端響應超時或者不可用導致請求失敗,請重試,重試后仍失敗請聯系技術支持。

訪問錯誤中心查看更多錯誤碼。