調用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 | 標簽的值。 說明
|
返回數據
名稱 | 類型 | 示例值 | 描述 |
---|---|---|---|
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. | 由于服務端響應超時或者不可用導致請求失敗,請重試,重試后仍失敗請聯系技術支持。 |
訪問錯誤中心查看更多錯誤碼。