すべてのプロダクト
Search

このプロダクト

    PolarDB:DescribeActiveOperationTasks

    ドキュメントセンター

    PolarDB:DescribeActiveOperationTasks

    最終更新日:Dec 11, 2025

    インスタンスの運用保守イベントの詳細をクエリします。

    今すぐお試しください

    この 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:DescribeActiveOperationTasks

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    未処理イベントのリージョン ID。

    説明

    利用可能なリージョンをクエリするには、DescribeRegions 操作を呼び出します。

    cn-beijing
    TaskType

    string

    任意

    未処理イベントタスクのタイプ。有効な値：

    • DatabaseSoftwareUpgrading：データベースソフトウェアのアップグレード

    • DatabaseHardwareMaintenance：ハードウェアのメンテナンスとアップグレード

    • DatabaseStorageUpgrading：データベースストレージのアップグレード

    • DatabaseProxyUpgrading：プロキシのマイナーバージョンのアップグレード

    • all：すべてのタイプの未処理イベントの詳細をクエリします

    説明

    Region を all に設定した場合、TaskType も all に設定する必要があります。

    DatabaseProxyUpgrading
    PageSize

    integer

    任意

    各ページに返すエントリ数。有効な値：

    • 30 (デフォルト)

    • 50

    • 100

    30
    PageNumber

    integer

    任意

    ページ番号。値は 0 より大きい整数で、Integer データ型の最大値を超えることはできません。デフォルト値：1。

    1
    DBType

    string

    任意

    データベースエンジンタイプ。有効な値：

    • MySQL

    • PostgreSQL

    • Oracle

    MySQL
    Status

    integer

    任意

    タスクステータス。有効な値：

    • -1：すべてのタスク。

    • 3：保留中のタスク。

    • 4：進行中のタスク。

    • 5：正常に完了したタスク。

    • 6：失敗したタスク。

    • 7：キャンセルされたタスク。

    -1
    DBClusterId

    string

    任意

    クラスター ID。

    説明

    アカウント配下にあるすべてのクラスターの詳細情報 (クラスター ID を含む) をクエリするには、DescribeDBClusters 操作を呼び出します。

    pc-3ns***********d5d
    AllowChange

    integer

    任意

    時間変更を許可するかどうかを指定します。有効な値：

    • -1 (デフォルト)：すべて。

    • 0：時間変更が許可されていないタスクのみを返します。

    • 1：時間変更が許可されているタスクのみを返します。

    -1
    AllowCancel

    integer

    任意

    キャンセルを許可するかどうかを指定します。有効な値：

    • -1 (デフォルト)：すべて。

    • 0：キャンセルが許可されていないタスクのみを返します。

    • 1：キャンセルが許可されているタスクのみを返します。

    -1
    ChangeLevel

    string

    任意

    タスクレベル。有効な値：

    • all (デフォルト)：すべて。

    • S0：異常修復レベルのタスクを返します。

    • S1：システムメンテナンスレベルのタスクを返します。

    all

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    TotalRecordCount

    integer

    返されるタスクレコードの数。

    1
    RequestId

    string

    リクエスト ID。

    FAF88508-D5F8-52B1-8824-262601769E31
    PageSize

    integer

    ページごとに返されるエントリ数。有効な値：

    • 30

    • 50

    • 100

    デフォルト値：30。

    30
    PageNumber

    integer

    ページ番号。値は 0 より大きい整数で、Integer データ型の最大値を超えることはできません。デフォルト値：1。

    1
    Items

    array<object>

    運用保守タスクのリスト。

    object

    運用保守タスクのリスト。

    Status

    integer

    タスクステータス。有効な値：

    • 0：通知待ちを示します。

    • 1：通知のリトライを示します。

    • 2：ユーザー指定の時間待ちを示します。

    • 3：処理待ちを示します。

    • 4：進行中を示します。

    • 5：正常に完了したことを示します。

    • 6：失敗したことを示します。

    • 7：キャンセルされたことを示します。

    3
    PrepareInterval

    string

    開始時刻と切り替え時間の間に必要な準備時間。フォーマット：HH:mm:ss。

    04:00:00
    Deadline

    string

    タスク実行時間の調整可能範囲の最終期限。フォーマット：YYYY-MM-DDTHH:mm:ssZ。

    2020-06-11T15:59:59Z
    DBType

    string

    データベースエンジンタイプ。有効な値：

    • MySQL

    • PostgreSQL

    • Oracle

    MySQL
    TaskType

    string

    未処理イベントタスクのタイプ。有効な値：

    • DatabaseSoftwareUpgrading：データベースソフトウェアのアップグレード。

    • DatabaseHardwareMaintenance：ハードウェアのメンテナンスとアップグレード。

    • DatabaseStorageUpgrading：データベースストレージのアップグレード。

    • DatabaseProxyUpgrading：プロキシのマイナーバージョンのアップグレード。

    • all：すべてのタイプの未処理イベントの詳細をクエリします。

    DatabaseSoftwareUpgrading
    StartTime

    string

    バックグラウンドタスクが実行される時刻。フォーマット：YYYY-MM-DDTHH:mm:ssZ。

    2023-05-19T02:48:17Z
    DBVersion

    string

    カーネルバージョン番号。

    8.0
    ModifiedTime

    string

    変更時刻。フォーマット：YYYY-MM-DDTHH:mm:ssZ。

    2020-06-09T22:00:42Z
    DBClusterId

    string

    クラスター ID。

    pc-*****************
    Region

    string

    リージョンコード。

    cn-hangzhou
    ResultInfo

    string

    実行結果情報。

    userCancel
    CreatedTime

    string

    作成時刻。フォーマット：YYYY-MM-DDTHH:mm:ssZ。

    2020-06-09T22:00:42Z
    TaskId

    integer

    タスク ID。

    107202351
    SwitchTime

    string

    バックグラウンドが切り替え操作を開始する時刻。フォーマット：YYYY-MM-DDTHH:mm:ssZ。

    2020-06-09T22:00:00Z
    CurrentAVZ

    string

    現在のゾーン。

    cn-beijing-h
    InsComment

    string

    クラスターのエイリアスまたはコメント。

    test
    TaskTypeZh

    string

    タスクの理由 (中国語)。

    小版本升级
    TaskTypeEn

    string

    タスクの理由 (英語)。

    Minor version update
    ChangeLevel

    string

    イベントレベルコード。有効な値：

    • S1：システムメンテナンス。

    • S0：脅威の修正。

    S0
    ChangeLevelZh

    string

    イベントレベル (中国語)。

    系统运维
    ChangeLevelEn

    string

    イベントレベル (英語)。

    System maintenance
    ImpactZh

    string

    イベントの影響 (中国語)。

    集群闪断
    ImpactEn

    string

    イベントの影響 (英語)。

    Transient instance disconnection
    AllowChange

    integer

    時間変更が許可されているかどうかを示します。有効な値：

    • 1：ユーザーが時間を変更できることを示します。

    • 0：ユーザーが時間を変更できないことを示します。

    0
    AllowCancel

    integer

    キャンセルが許可されているかどうかを示します。有効な値：

    • 1：ユーザーがタスクをキャンセルできることを示します。

    • 0：キャンセルが許可されていないことを示します。

    0
    Impact

    string

    イベントの影響。

    TransientDisconnection
    DBNodeIds

    array

    ノード ID のリスト。

    string

    ノード ID。複数のノード ID を入力する場合は、コンマ (,) で区切ります。

    pi-t4n***********0ni,pi-t4n***********334,pi-t4n***********h07,pi-t4n***********q5i
    TaskParams

    string

    タスクパラメーター。

    { "Action": "UpgradeDBInstance" }

    例

    成功レスポンス

    JSONJSON

    {
  "TotalRecordCount": 1,
  "RequestId": "FAF88508-D5F8-52B1-8824-262601769E31",
  "PageSize": 30,
  "PageNumber": 1,
  "Items": [
    {
      "Status": 3,
      "PrepareInterval": "04:00:00",
      "Deadline": "2020-06-11T15:59:59Z",
      "DBType": "MySQL",
      "TaskType": "DatabaseSoftwareUpgrading",
      "StartTime": "2023-05-19T02:48:17Z",
      "DBVersion": "8.0",
      "ModifiedTime": "2020-06-09T22:00:42Z",
      "DBClusterId": "pc-*****************",
      "Region": "cn-hangzhou",
      "ResultInfo": "userCancel",
      "CreatedTime": "2020-06-09T22:00:42Z",
      "TaskId": 107202351,
      "SwitchTime": "2020-06-09T22:00:00Z",
      "CurrentAVZ": "cn-beijing-h",
      "InsComment": "test",
      "TaskTypeZh": "小版本升级",
      "TaskTypeEn": "Minor version update",
      "ChangeLevel": "S0",
      "ChangeLevelZh": "系统运维",
      "ChangeLevelEn": "System maintenance",
      "ImpactZh": "集群闪断",
      "ImpactEn": "Transient instance disconnection",
      "AllowChange": 0,
      "AllowCancel": 0,
      "Impact": "TransientDisconnection",
      "DBNodeIds": [
        "pi-t4n***********0ni,pi-t4n***********334,pi-t4n***********h07,pi-t4n***********q5i"
      ],
      "TaskParams": "{\n      \"Action\": \"UpgradeDBInstance\"\n}"
    }
  ]
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidPageParam.Format Page param should be a positive integer.
    400 RequiredParam.NotFound Required input param is not found.

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

    変更履歴

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