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