調用TransferInstanceClass可以升級DTS執行個體規格。
說明
- DTS執行個體規格已不支援降級。
- 若DTS執行個體的源端為Redis 6.0版本且有增量資料更新,請勿執行升級操作,否則可能會導致DTS執行個體失敗且無法恢複(失敗後需要重新設定執行個體)。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
請求參數
名稱 |
類型 |
是否必選 |
樣本值 |
描述 |
Action | String | 是 | TransferInstanceClass | 系統規定參數。取值:TransferInstanceClass。 |
OrderType | String | 是 | UPGRADE | 請填入UPGRADE。 |
InstanceClass | String | 是 | large | 升級後的執行個體規格,可以調用DescribeDtsJobDetail查詢升級前的執行個體規格。
說明 關於各鏈路規格的說明及效能測試情況請參見資料移轉鏈路規格說明和資料同步鏈路規格說明。 |
RegionId | String | 否 | cn-hangzhou | DTS執行個體所在地區的ID,請參見支援的地區列表。 |
DtsJobId | String | 是 | r4yr723m199**** | 遷移或同步任務ID,可調用DescribeDtsJobs查詢。 |
ResourceGroupId | String | 否 | rg-acfmzawhxxc**** | 資源群組ID。 |
返回資料
名稱 |
類型 |
樣本值 |
描述 |
EndTime | String | 2021-08-04T16:00:00.000+00:00 | 執行個體到期時間。 說明 ChargeType為PREPAY,才會返回此參數。 |
HttpStatusCode | Integer | 200 | 狀態代碼。 |
RequestId | String | 716DB03E-2D0B-4DC3-BC4C-F7A9EE21**** | 請求ID。 |
DtsJobId | String | r4yr723m199**** | 遷移或同步任務ID。 |
ErrCode | String | InternalError | 調用出錯時返回的錯誤碼。 |
Success | Boolean | true | 請求是否成功。傳回值:
|
ChargeType | String | POSTPAY | 付費類型,傳回值:
|
ErrMessage | String | The request processing has failed due to some unknown error. | 調用錯誤時返回對應的錯誤資訊。 |
Code | String | 200 | 錯誤碼。 |
DynamicMessage | String | DtsJobId | 動態錯誤資訊,用於替換返回參數ErrMessage錯誤資訊中的%s。 說明 如果ErrMessage返回The Value of Input Parameter %s is not valid,且DynamicMessage返回DtsJobId,則表示所傳入的請求參數DtsJobId不合法。 |
InstanceId | String | dtsr4yr723m199**** | 執行個體ID。 |
樣本
請求樣本
http(s)://dts.aliyuncs.com/?Action=TransferInstanceClass
&OrderType=UPGRADE
&InstanceClass=large
&DtsJobId=r4yr723m199****
&<公用請求參數>
正常返回樣本
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<TransferInstanceClassResponse>
<DtsJobId>r4yr723m199****</DtsJobId>
<RequestId>716DB03E-2D0B-4DC3-BC4C-F7A9EE21****</RequestId>
<InstanceId>dtsr4yr723m199****</InstanceId>
<ChargeType>POSTPAY</ChargeType>
<HttpStatusCode>200</HttpStatusCode>
<Success>true</Success>
</TransferInstanceClassResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"DtsJobId" : "r4yr723m199****",
"RequestId" : "716DB03E-2D0B-4DC3-BC4C-F7A9EE21****",
"InstanceId" : "dtsr4yr723m199****",
"ChargeType" : "POSTPAY",
"HttpStatusCode" : 200,
"Success" : true
}
錯誤碼
HttpCode |
錯誤碼 |
錯誤資訊 |
描述 |
400 | Throttling.User | Request was denied due to user flow control. | 由於請求頻次達到閾值,請求被拒絕,請稍後重試。 |
500 | ServiceUnavailable | The request has failed due to a temporary failure of the server. | 由於服務端響應逾時或者不可用導致請求失敗,請重試,重試後仍失敗請聯絡支援人員。 |
403 | InvalidSecurityToken.Expired | Specified SecurityToken is expired. | 簽名已經到期,請更新簽名 |
訪問錯誤中心查看更多錯誤碼。