この API は、MongoDB インスタンスのデータベースバージョンをアップグレードする場合に呼び出すことができます。
この API は、レプリカセットインスタンスとシャードクラスタインスタンスの両方をサポートします。 UpgradeDBInstanceEngineVersion は、スタンドアロンインスタンスでは実行できません。
この API を呼び出す際に、インスタンスは実行中の状態にある必要があります。
注
- インスタンスのストレージエンジンは、データベースバージョンの選択には制約をかけています。 詳細は、バージョンとストレージエンジンをご参照ください。
- データベースバージョンを一度アップグレードすると、ダウングレードすることはできません。
- インスタンスは、アップグレードプロセス中に 2~3 回自動的に再起動されます。 インスタンスをピーク時間外に実行することをお勧めします。
デバッグ
OpenAPI Explorer は API の使用を簡素化します。 OpenAPI Explorer を使用して、API の取得、API の呼び出し、SDK サンプルコードの動的生成などのデバッグ操作を実行できます。
リクエストパラメータ
| パラメータ | データ型 | 必須 | 例 | 説明 |
|---|---|---|---|---|
| EngineVersion | String | はい | 4.0 |
アップグレードするデータベースバージョン。 有効値： 3.4 および 4.0 。 注 ターゲットデータベースのバージョンは、インスタンスの現行データベースバージョンよりも後である必要があります。
|
| DBInstanceId | String | はい | dds-bpxxxxxxxx |
インスタンスの ID。 |
| Action | String | いいえ | UpgradeDBInstanceEngineVersion |
実行する操作。 値をUpgradeDBInstanceEngineVersion に設定します。 |
| AccessKeyId | String | いいえ | LTAIgbTGpxxxxxx |
Alibaba Cloud から提供された AccessKey ID。 |
レスポンスパラメータ
| パラメータ | タイプ | 例 | 説明 |
|---|---|---|---|
| RequestId | String | C4907B00-A208-4E0C-A636-AA85140E406C |
リクエスト ID。 |
例
リクエストの例
http(s)://mongodb.aliyuncs.com/? Action=UpgradeDBInstanceEngineVersion
&EngineVersion=4.0
&DBInstanceId=dds-bpxxxxxxxx
&<Common request parameters>
通常のレスポンスの例
XML 形式
<UpgradeDBInstanceEngineVersionResponse>
<RequestId>C4907B00-A208-4E0C-A636-AA85140E406C</RequestId>
</UpgradeDBInstanceEngineVersionResponse>
JSON 形式
{
"RequestId":"C4907B00-A208-4E0C-A636-AA85140E406C"
}