遷移MongoDB實例的可用區(qū)。
接口說明
- MigrateAvailableZone 接口適用于 MongoDB 4.2 及以下版本的副本集實例,分片集群實例,暫不支持單節(jié)點實例。
- 如果實例申請了公網(wǎng)連接地址,需要先調(diào)用 ReleasePublicNetworkAddress 接口釋放公網(wǎng)連接地址。
- 實例未開啟透明數(shù)據(jù)加密 TDE 功能。
- 遷移的目標可用區(qū)和當前實例的可用區(qū)處于同一地域。
- 專有網(wǎng)絡的實例在操作遷移可用區(qū)之前,請確保目標可用區(qū)已創(chuàng)建相應的虛擬交換機。如需創(chuàng)建,請參見創(chuàng)建虛擬交換機。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
下表是API對應的授權(quán)信息,可以在RAM權(quán)限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下:
- 操作:是指具體的權(quán)限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權(quán)的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權(quán)的操作,用
全部資源
表示。
- 條件關鍵字:是指云產(chǎn)品自身定義的條件關鍵字。
- 關聯(lián)操作:是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時具備關聯(lián)操作的權(quán)限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯(lián)操作 |
---|---|---|---|---|
dds:MigrateAvailableZone | update |
|
| 無 |
請求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
DBInstanceId | string | 是 | 實例 ID。 說明
如果實例的網(wǎng)絡類型為專有網(wǎng)絡,您還需要傳入 Vswitch 參數(shù)。
| dds-bp1ece71ff2f**** |
ZoneId | string | 是 | 遷移的目標可用區(qū) ID。 說明
| cn-hangzhou-b |
Vswitch | string | 否 | 遷移的目標可用區(qū)虛擬交換機 ID。 說明
當實例的網(wǎng)絡類型為專有網(wǎng)絡時,需要配置該參數(shù)。
| vsw-bp1buy0h9myt5i9e7**** |
EffectiveTime | string | 否 | 遷移可用區(qū)的生效時間,取值:
默認為 Immediately。 | Immediately |
SecondaryZoneId | string | 否 | 遷移的目標備可用區(qū) 1 的 ID。 | cn-hangzhou-h |
HiddenZoneId | string | 否 | 遷移的目標備可用區(qū) 2 的 ID。 | cn-shanghai-n |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"RequestId": "0FDDC511-7252-4A4A-ADDA-5CB1BF63****"
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
400 | InvalidEffectiveTime.Malformed | Specified EffectiveTime is not valid. | - |
400 | InsType.NotSupport | Specified instance type dose not support this operation. | - |
400 | IncorrectMasterDBInstanceState | The Master instance state does not support this operation. | - |
400 | NetworkTypeNotSupport | The network type does not support this operation. | 該網(wǎng)絡類型不支持此操作。 |
400 | OperationDenied.LockMode | The operation is not permitted when the instance locked. | 當前實例已被鎖定,無法執(zhí)行該操作。 |
400 | InvalidIzNo.NotSupported | the Specified vpc Zone not supported. | - |
400 | IncorrectVswitchId | The specified parameter 'VSwitchId' is not valid. | - |
400 | InvalidRegion_Zone_NotFound | Specified Region does not exist in RDS. | - |
400 | VPCERROR.ALLOCATE_ERROR | Cannot Allocate the require vpcInstances. | - |
400 | ProxyError | The request processing has failed due to some unknown error, exception or failure. | - |
400 | DbInsertError | Database insert error. | - |
400 | UnsupportedDBTdeStatus | Specified DB TDEStatus does not support this operation. | 指定實例已開啟TDE,不支持此操作 |
400 | InvalidZoneParam | The target zone and source zone cannot be the same. | 目標可用區(qū)不可以和原可用區(qū)一致 |
404 | InvalidDbInstanceId.NotFound | Specified instance does not exist. | 該實例不存在,原因可能是該實例已經(jīng)釋放,請刷新頁面。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內(nèi)容概要 | 操作 |
---|---|---|
2024-07-25 | OpenAPI 錯誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
2024-04-08 | OpenAPI 錯誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
2024-03-13 | OpenAPI 錯誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
2023-07-13 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |