UpgradeDBInstanceEngineVersion操作を呼び出して、ApsaraDB RDS for MySQLインスタンスのメジャーエンジンバージョンをアップグレードできます。

説明 アップグレード後に支払う必要がある料金は、元のインスタンスと新しいインスタンスのインスタンスタイプとストレージタイプによって異なります。

インスタンスが読み取り専用インスタンスまたはディザスタリカバリインスタンスがアタッチされているプライマリインスタンスである場合、プライマリインスタンスのメジャーエンジンバージョンをアップグレードする前に、読み取り専用インスタンスまたはディザスタリカバリインスタンスのメジャーエンジンバージョンをアップグレードする必要があります。

この API を呼び出す場合、インスタンスは次の要件を満たしている必要があります。

  • 元のインスタンスは [実行中] 状態です。
  • インスタンスは、次のいずれかのデータベースバージョンを実行します。
    • MySQL 5.7
    • MySQL 5.6
    • MySQL 5.5

UpgradeDBInstanceMajorVersionを呼び出して、ApsaraDB RDS for PostgreSQLインスタンスのメジャーエンジンバージョンをアップグレードできます。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

項目 データ型 必須／任意 例: 説明　
操作 String 必須 UpgradeDBInstanceEngineVersion

実行する操作です。 値をUpgradeDBInstanceEngineVersionに設定します。

ClientToken String 任意 ETnLKlblzczshOTUbOCzxxxxxxxxxx

リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアントを使用して値を生成できますが、生成されたトークンが異なるリクエスト間で一意であることを確認する必要があります。 トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。

DBInstanceId String 必須 rm-uf6wjk5xxxxxxx

インスタンスの ID です。

EngineVersion String 必須 5.7

新しいインスタンスが実行するメジャーエンジンのバージョン。 有効な値：

  • 8.0
  • 5.7
  • 5.6
EffectiveTime String 任意 即時

変更を有効にする時間。 有効な値：

  • Immediate: 変更はすぐに有効になります。
  • MaintainTime: 変更は、指定されたメンテナンス期間中に有効になります。 詳細については、「ModifyDBInstanceMaintainTime」をご参照ください。

デフォルト値: Immediate。

レスポンスパラメーター

項目 データ型 例: 説明　
TaskId String 10254125

タスクのID。

RequestId String 65BDA532-28AF-4122-AA39-B382721EEE64

リクエストの ID です。

例

リクエストの例

http(s):// rds.aliyuncs.com/?Action=UpgradeDBInstanceEngineVersion
&DBInstanceId=rm-uf6wjk5xxxxxxx
&EngineVersion=5.7
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式

HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<UpgradeDBInstanceEngineVersionResponse>
<RequestId> 65BDA532-28AF-4122-AA39-B382721EEE64</RequestId>
<TaskId>10254125</TaskId></UpgradeDBInstanceEngineVersionResponse>

JSON 形式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "65BDA532-28AF-4122-AA39-B382721EEE64" 、
  "TaskId" : "10254125"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明　
400 InvalidOrderTask.NotSupport 現在のInstanceIdはRDSの注文タスクです。 インスタンスに未完了の注文がある場合に返されるエラーメッセージ。 しばらくしてからもう一度お試しください。
400 InvalidSSLstatus 現在のDBインスタンスはSSLが有効になっています。この操作はサポートされていません。 インスタンスのSSL暗号化が有効になっている場合に返されるエラーメッセージ。
400 InvalidDBInstanceConnType. フォーマット 指定されたDBインスタンスのconnタイプは無効です。 インスタンスのネットワークタイプがこの操作をサポートしていない場合に返されるエラーメッセージ。
403 IncorrectDBInstanceState Current DB instance state does not support this operation. インスタンスが現在の状態の場合、この操作がサポートされていない場合に返されるエラーメッセージ。
403 IncorrectEngineVersion エンジンバージョンは操作をサポートしていません。 インスタンスで実行されているデータベースエンジンバージョンでは、この操作がサポートされていない場合に返されるエラーメッセージ。
403 IncorrectEngineTypeMyisam 現在のDBインスタンスにはMyISAMテーブルがあり、この操作はサポートされていません。 インスタンスにMyISAMテーブルが存在する場合に返されるエラーメッセージ。
403 InvalidInstanceLevel.Malformed 現在のDBインスタンスレベルはこの操作をサポートしていません。 インスタンスがこの操作をサポートしていない場合に返されるエラーメッセージ。
403 IncorrectDBInstanceLockMode Current DB instance lock mode does not support this operation. インスタンスがロックされている場合に返されるエラーメッセージ。
404 InvalidDBInstance.NotFound 指定されたインスタンスが存在しないか、サポートされていません。 指定されたインスタンスが見つからない場合に返されるエラーメッセージ。 インスタンスのIDを確認する必要があります。

エラーコードのリストについては、エラーセンターをご覧ください。