すべてのプロダクト
Search
ドキュメントセンター

PolarDB:DescribeUpgradeReport

最終更新日:Sep 24, 2026

スペックアップまたは移行の検証レポートを照会します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

polardb:DescribeUpgradeReport

get

*すべてのリソース。

*

なし なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

RegionId

string

任意

リージョン ID。

説明

DescribeRegions 操作を呼び出して、利用可能なリージョンを照会できます。

cn-hangzhou

SourceDBClusterId

string

任意

ソースインスタンスの ID。

rm-2zen5pe5vi56447d0

DBType

string

任意

データベースタイプ。有効な値:

  • MySQL。

  • Oracle。

MySQL

DBVersion

string

任意

互換性のあるデータベースバージョン。

8.0

TaskId

string

任意

タスクの ID。

2321321

PageNumber

integer

任意

ページ番号。

1

PageSize

integer

任意

ページサイズ。

30

Status

string

任意

タスクのステータス。

Running

Type

string

任意

特別なメトリック。現在、tair (PolarTair アーキテクチャ) のみがサポートされています。

orca

CreationCategory

string

任意

エディション。有効な値:

  • Normal: Cluster Edition (デフォルト)。

  • SENormal: Standard Edition。

エディションの詳細については、「プロダクトエディション」を参照してください。

Normal

レスポンスフィールド

フィールド

型

説明

例

object

レスポンスのスキーマ。

RequestId

string

リクエストの ID。

2FED790E-FB61-4721-8C1C-07C627******

SourceDBClusterId

string

ソースインスタンスの ID。

rm-2zen5pe5vi56447d0

TotalSize

integer

クエリ結果のエントリの総数。

137

UpgradeReportList

array<object>

評価レポートのリスト。

object

TaskId

string

ターゲットタスクの ID。

275948

CheckTime

string

チェック時間。

時間は ISO 8601 標準の協定世界時 (UTC) タイムゾーン (フォーマット: YYYY-MM-DDTHH:mm:ssZ) です。

2024-03-15T06:48:44Z

DstVersion

string

ターゲットインスタンスのバージョン。

8.0

SrcInsName

string

ソースインスタンスの名前。

pc-2ze54671qoz830za9

SrcVersion

string

ソースインスタンスのバージョン。

5.7

UpgradeMode

string

スペックアップモード。

rds2polar_pengine_with_dts

Result

string

評価タスクのステータス。

running

EffectiveTime

string

評価の有効期間。

時間は ISO 8601 標準の協定世界時 (UTC) タイムゾーン (フォーマット: YYYY-MM-DDTHH:mm:ssZ) です。

2024-03-08T06:48:44Z

StartTime

string

評価の開始時刻。

時間は ISO 8601 標準の協定世界時 (UTC) タイムゾーン (フォーマット: YYYY-MM-DDTHH:mm:ssZ) です。

2025-07-05T01:56:00Z

EndTime

string

評価の終了時刻。

時間は ISO 8601 標準の協定世界時 (UTC) タイムゾーン (フォーマット: YYYY-MM-DDTHH:mm:ssZ) です。

2024-03-08T06:48:44Z

ItemsSize

integer

Oracle 互換性評価の詳細リストの長さ。

10

Items

array<object>

Oracle 互換性評価の詳細リスト。

説明

Oracle インスタンスのみがサポートされています。

object

リスト。

Schema

string

評価対象オブジェクトが属するスキーマ。

ny_openapi

Type

string

評価対象オブジェクトのオブジェクトタイプ。

orca

Name

string

評価対象オブジェクトの名前。

testName

Status

string

互換性評価の結果。有効な値:

  • 0: 失敗。

  • 1: 成功。

1

DDL

string

オブジェクト同期用の DDL 文。

CREATE XXXX

Details

string

詳細。

[]

SrcDBType

string

ソースインスタンスのデータベースタイプ。有効な値:

  • MySQL。

  • Oracle。

MySQL

DstDBType

string

ターゲットインスタンスのデータベースタイプ。有効な値:

  • MySQL。

  • Oracle。

MySQL

SrcDeleted

string

ソースインスタンスの削除ステータス。有効な値:

  • 0: 未削除。

  • 1: 削除済み。

1

Type

string

特別なメトリック。現在、tair (PolarTair アーキテクチャ) のみがサポートされています。

tair

例

成功レスポンス

JSONJSON

{
  "RequestId": "2FED790E-FB61-4721-8C1C-07C627******",
  "SourceDBClusterId": "rm-2zen5pe5vi56447d0",
  "TotalSize": 137,
  "UpgradeReportList": [
    {
      "TaskId": "275948",
      "CheckTime": "2024-03-15T06:48:44Z",
      "DstVersion": "8.0",
      "SrcInsName": "pc-2ze54671qoz830za9",
      "SrcVersion": "5.7",
      "UpgradeMode": "rds2polar_pengine_with_dts",
      "Result": "running",
      "EffectiveTime": "2024-03-08T06:48:44Z",
      "StartTime": "2025-07-05T01:56:00Z",
      "EndTime": "2024-03-08T06:48:44Z"
    }
  ],
  "ItemsSize": 10,
  "Items": [
    {
      "Schema": "ny_openapi",
      "Type": "orca",
      "Name": "testName",
      "Status": "1",
      "DDL": "CREATE XXXX"
    }
  ],
  "Details": "[]",
  "SrcDBType": "MySQL",
  "DstDBType": "MySQL",
  "SrcDeleted": "1",
  "Type": "tair"
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。