DescribeUpgradeMajorVersionTasks操作を呼び出して、ApsaraDB RDS for PostgreSQLインスタンスのメジャーエンジンバージョンをアップグレードするために作成されたタスクを照会できます。

デバッグ

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

リクエストパラメーター

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

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

DBInstanceId String 必須 pgm-bp1gm3yh0ht1 ****

元のインスタンスのID。

PageSize Integer いいえ 30

各ページで返されるエントリ数。

有効な値: 30100

既定値: 30.

PageNumber Integer いいえ 1

返されるページ数。

有効値:0 以外の正の整数。

既定値:1

TargetMajorVersion String 任意 12.0

新しいインスタンスのメジャーエンジンバージョン。 有効な値:

  • 10.0
  • 11.0
  • 12.0
  • 13.0
TaskId Integer いいえ 417450000

パラメーターは予約されています。 指定する必要はありません。

レスポンスパラメーター

項目 データ型 例: 説明 
RequestId String 152E0C6D-B9C3-4468-9F2C-FEF9D9E8417B

リクエストの ID です。

PageNumber Integer 1

返されたページ数。

PageRecordCount Integer 30

返された各ページのエントリ数を示します。

TotalRecordCount Integer 1

エントリの総数。

項目 タスクの配列

返されるタスクに関する情報で構成される配列。

TargetMajorVersion String 12.0

新しいインスタンスのメジャーエンジンバージョン。 有効な値:

  • 10.0
  • 11.0
  • 12.0
  • 13.0
結果 String 成功

タスクの実行ステータス

  • Success: タスクは成功です。
  • 失敗: タスクが失敗しました。
  • 実行中: タスクは、データを新しいインスタンスに移行するフェーズにあります。
EndTime String 1614237779000

タスクが終了した時刻。

このパラメーターの値は、UNIX時間形式に従うタイムスタンプです。 単位:ミリ秒。

StartTime String 1614236007000

タスクが開始された時刻。

このパラメーターの値は、UNIX時間形式に従うタイムスタンプです。 単位:ミリ秒。

SourceMajorVersion String 11.0

元のインスタンスのメジャーエンジンバージョン。

UpgradeMode String スイッチ

ApsaraDB RDSがデータを新しいインスタンスに移行し、ワークロードを新しいインスタンスに切り替えるかどうかを示します。

有効な値:

  • clone: ApsaraDB RDSは、データを新しいインスタンスに移行せず、ワークロードを新しいインスタンスに切り替えません。
  • switch: ApsaraDB RDSはデータを新しいインスタンスに移行し、ワークロードを新しいインスタンスに切り替えます。
CollectStatMode String その後、

ApsaraDB RDSが新しいRDSインスタンスの統計を収集する時刻。

有効な値:

  • : ApsaraDB RDSは、切り替え後の新しいインスタンスの統計を収集します。
  • : ApsaraDB RDSは、切り替え前の新しいインスタンスの統計を収集します。
SourceInsName String pgm-bp1i3kkq7321 ****

元のインスタンスのID。

TaskId Integer 342900000

タスクのID。

TargetInsName String pgm-bp1c0v6d8092 ****

新しいインスタンスのID。

SwitchTime String 1614237539000

ワークロードが元のインスタンスから新しいインスタンスに切り替えられる時刻。

このパラメーターの値は、UNIX時間形式に従うタイムスタンプです。 単位:ミリ秒。

詳細 String 2021-10-27 15:03:05 --- スレーブの成功を事前に確認します。\n2021-10-27 15:03:11 --- メジャーバージョンのアップグレードを開始すると、ソースインスタンスは読み取り専用モードでロックされます。\n2021-10-27 15:03:21 --- マスターの成功をアップグレードします。\n2021-10-27 15:06:10 --- ソースインスタンスとターゲットインスタンスの交換が成功します。\n

タスクの詳細。

リクエストの例

http(s):// rds.aliyuncs.com/?Action=DescribeUpgradeMajorVersionTasks
&DBInstanceId=pgm-bp1gm3yh0ht1 ****
&<共通リクエストパラメーター>

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

XML 形式

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

<DescribeUpgradeMajorVersionTasks>
    <TotalRecordCount>1</TotalRecordCount>
    <PageRecordCount>30</PageRecordCount>
    <RequestId>152E0C6D-B9C3-4468-9F2C-FEF9D9E8417B</RequestId>
    <ページ番号> 1 </ PAGENUMBER>
    <Items>
        <SourceInsName>pgm-bp1i3kkq7321 ****</SourceInsName>
        <SourceMajorVersion>11.0</SourceMajorVersion>
        <TaskId>342900000</TaskId>
        <CollectStatMode/>
        <EndTime>1614237779000</EndTime>
        <TargetMajorVersion>12.0</TargetMajorVersion>
        <TargetInsName>pgm-bp1c0v6d8092 ****</TargetInsName>
        <StartTime>1614236007000</StartTime>
        <UpgradeMode> スイッチ </UpgradeMode>
        <詳細> 2021-10-27 15:03:05 --- スレーブの成功を事前に確認します。\n2021-10-27 15:03:11 --- メジャーバージョンのアップグレードを開始すると、ソースインスタンスは読み取り専用モードでロックされます。\n2021-10-27 15:03:21 --- アップグレードマスターの成功。\n2021-10-27 15:06:10 --- ソースインスタンスとターゲットインスタンスの交換が成功します。\n</詳細>
        <SwitchTime>1614237539000</SwitchTime>
        <結果> 成功 </結果>
    </アイテム>
</DescribeUpgradeMajorVersionTasks>

JSON 形式

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

{
  "TotalRecordCount" : 1、
  "PageRecordCount" : 30、
  "RequestId" : "152E0C6D-B9C3-4468-9F2C-FEF9D9E8417B" 、
  "PageNumber" : 1,
  "アイテム" : {
    "SourceInsName" : "pgm-bp1i3kkq7321 ****" 、
    "SourceMajorVersion" : 11.0、
    "TaskId" : 342900000、
    "CollectStatMode" : "" 、
    "EndTime" : 1614237779000、
    "TargetMajorVersion" : 12.0、
    "TargetInsName" : "pgm-bp1c0v6d8092 ****" 、
    "StartTime" : 1614236007000、
    "UpgradeMode" : "switch" 、
    "Detail" : "2021-10-27 15:03:05 --- スレーブの成功を事前に確認します。\\n2021-10-27 15:03:11 --- メジャーバージョンのアップグレードを開始すると、ソースインスタンスは読み取り専用モードでロックされます。\\n2021-10-27 15:03:21 --- マスターの成功をアップグレードします。\\\n2021-10-27 15:06:10 --- ソースインスタンスとターゲットインスタンスの交換は成功 \\n" 、
    "SwitchTime" : 1614237539000、
    "結果" : "成功"
  }
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明 
404 InvalidDBInstanceName.NotFound データベースインスタンスが存在しません。 元のインスタンスの名前が見つからない場合に返されるエラーメッセージ。 名前が正しいかどうかを確認してください。

エラーコードリストについては、「API エラーセンター」をご参照ください。