調用UpgradeTwoWay介面將DTS同步執行個體的同步拓撲從單向同步升級為雙向同步,目前只支援後付費任務的升級。
請確保在使用該介面前,已充分瞭解雲資料庫DTS產品的收費方式和價格。
使用該介面需注意:
- 資料同步任務的源執行個體和目標執行個體的資料庫類型均為MySQL。
- 資料同步任務的同步拓撲為單向同步。
- 資料同步任務的狀態為同步中。
- 升級生效期間資料同步會出現5秒左右的延遲,請在業務低峰期操作。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
請求參數
| 名稱 | 類型 | 是否必選 | 樣本值 | 描述 |
| Action | String | 是 | UpgradeTwoWay | 系統規定參數,取值:UpgradeTwoWay。 |
| InstanceClass | String | 是 | large | 雙向同步的執行個體規格,取值為large、medium、micro 、small。 說明 鏈路規格說明,請參見資料同步鏈路規格說明。 |
| InstanceId | String | 是 | dtsh77p49x4k28**** | 執行個體ID,可通過調用DescribeDtsJobs擷取。 |
| RegionId | String | 否 | cn-hangzhou | DTS執行個體所屬的地區,詳情請參見支援的地區列表。 |
返回資料
| 名稱 | 類型 | 樣本值 | 描述 |
| DynamicCode | String | 403 | 動態錯誤碼,本參數即將下線。 |
| DynamicMessage | String | InstanceId | 動態錯誤資訊,用於替換返回參數ErrMessage錯誤資訊中的%s。 說明 如果ErrMessage返回The Value of Input Parameter %s is not valid,且DynamicMessage返回InstanceId,則代表所傳入的請求參數InstanceId不合法。 |
| ErrCode | String | InternalError | 調用錯誤時返回的錯誤碼。 |
| ErrMessage | String | The Value of Input Parameter %s is not valid. | 調用錯誤時返回的錯誤資訊。 |
| HttpStatusCode | Integer | 200 | 狀態代碼。 |
| RequestId | String | 2D3B4615-923F-49AA-AF21-6D8E3967**** | 請求ID。 |
| Success | Boolean | true | 請求是否成功,傳回值:
|
樣本
請求樣本
http(s)://dts.aliyuncs.com/?Action=UpgradeTwoWay
&InstanceClass=large
&InstanceId=dtsh77p49x4k28****
&<公用請求參數>
正常返回樣本
XML格式
<StartDtsJobResponse>
<RequestId>2D3B4615-923F-49AA-AF21-6D8E3967****</RequestId>
<HttpStatusCode>200</HttpStatusCode>
<Success>true</Success>
</StartDtsJobResponse>
JSON格式
{
"RequestId":"2D3B4615-923F-49AA-AF21-6D8E3967****",
"HttpStatusCode":200,
"Success":true
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。