All Products
Search
Document Center

PolarDB:DescribeActiveOperationTasks

Last Updated:Jun 10, 2026

Mengkueri event operasi dan pemeliharaan untuk instans.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

polardb:DescribeActiveOperationTasks

get

*全部资源

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

RegionId

string

Yes

ID Wilayah event yang tertunda.

Catatan

Anda dapat memanggil operasi DescribeRegions untuk mengkueri Wilayah yang tersedia.

cn-beijing

TaskType

string

No

Tipe Tugas event yang tertunda. Nilai valid:

  • DatabaseSoftwareUpgrading: Peningkatan perangkat lunak database

  • DatabaseHardwareMaintenance: pemeliharaan dan Peningkatan perangkat keras

  • DatabaseStorageUpgrading: Peningkatan penyimpanan database

  • DatabaseProxyUpgrading: Peningkatan versi minor proxy

  • all: mengembalikan semua tipe event yang tertunda

Catatan

Ketika Region diatur ke all, TaskType juga harus diatur ke all.

DatabaseProxyUpgrading

PageSize

integer

No

Jumlah entri per halaman. Nilai valid:

  • 30 (default)

  • 50

  • 100.

30

PageNumber

integer

No

Nomor halaman. Nilai harus lebih besar dari 0 dan tidak boleh melebihi nilai maksimum Tipe data Integer. Nilai default: 1.

1

DBType

string

No

Tipe mesin database. Nilai valid:

  • MySQL

  • PostgreSQL

  • Oracle.

MySQL

Status

integer

No

Status Tugas. Nilai valid:

  • -1: semua Tugas.

  • 3: Tugas yang tertunda.

  • 4: Tugas yang sedang berlangsung.

  • 5: Tugas yang berhasil diselesaikan.

  • 6: Tugas yang gagal.

  • 7: Tugas yang dibatalkan.

-1

DBClusterId

string

No

ID Kluster.

Catatan

Anda dapat memanggil operasi DescribeDBClusters untuk mengkueri detail semua Kluster di bawah akun Anda, termasuk ID Kluster.

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

AllowChange

integer

No

Apakah akan mengizinkan modifikasi pengatur waktu. Nilai valid:

  • -1 (default): semua.

  • 0: hanya mengembalikan Tugas yang tidak mengizinkan modifikasi pengatur waktu.

  • 1: hanya mengembalikan Tugas yang mengizinkan modifikasi pengatur waktu.

-1

AllowCancel

integer

No

Apakah akan mengizinkan pembatalan. Nilai valid:

  • -1 (default): semua.

  • 0: hanya mengembalikan Tugas yang tidak mengizinkan pembatalan.

  • 1: hanya mengembalikan Tugas yang mengizinkan pembatalan.

-1

ChangeLevel

string

No

Tingkat Tugas. Nilai valid:

  • all (default): semua.

  • S0: mengembalikan Tugas pada tingkat perbaikan abnormal.

  • S1: mengembalikan Tugas pada tingkat pemeliharaan sistem.

all

Elemen respons

Element

Type

Description

Example

object

TotalRecordCount

integer

The number of task records returned.

1

RequestId

string

The request ID.

FAF88508-D5F8-52B1-8824-262601769E31

PageSize

integer

The number of entries returned per page. Valid values:

  • 30

  • 50

  • 100

Default value: 30.

30

PageNumber

integer

The page number. The value must be greater than 0 and cannot exceed the maximum value of the Integer data type. Default value: 1.

1

Items

array<object>

The list of O&M tasks.

object

The list of O&M tasks.

Status

integer

The task status. Valid values:

  • 0: indicates waiting for notification.

  • 1: indicates retry notification.

  • 2: indicates waiting for user-specified time.

  • 3: indicates waiting for processing.

  • 4: indicates in progress.

  • 5: indicates successfully completed.

  • 6: indicates failed.

  • 7: indicates canceled.

3

PrepareInterval

string

The preparation time required between the start time and the switch time. Format: HH:mm:ss.

04:00:00

Deadline

string

The latest deadline for the adjustable range of task execution time. Format: YYYY-MM-DDTHH:mm:ssZ.

2020-06-11T15:59:59Z

DBType

string

The database engine type. Valid values:

  • MySQL

  • PostgreSQL

  • Oracle

MySQL

TaskType

string

The type of the pending event task. Valid values:

  • DatabaseSoftwareUpgrading: database software upgrade.

  • DatabaseHardwareMaintenance: hardware maintenance and upgrade.

  • DatabaseStorageUpgrading: database storage upgrade.

  • DatabaseProxyUpgrading: proxy minor version upgrade.

  • all: returns all types of pending events.

DatabaseSoftwareUpgrading

StartTime

string

The time when the background task is executed. Format: YYYY-MM-DDTHH:mm:ssZ.

2023-05-19T02:48:17Z

DBVersion

string

The kernel version number.

8.0

ModifiedTime

string

The modification time. Format: YYYY-MM-DDTHH:mm:ssZ.

2020-06-09T22:00:42Z

DBClusterId

string

The cluster ID.

pc-*****************

Region

string

The region code.

cn-hangzhou

ResultInfo

string

The execution result information.

userCancel

CreatedTime

string

The creation time. Format: YYYY-MM-DDTHH:mm:ssZ.

2020-06-09T22:00:42Z

TaskId

integer

The task ID.

107202351

SwitchTime

string

The time when the background initiates the switch operation. Format: YYYY-MM-DDTHH:mm:ssZ.

2020-06-09T22:00:00Z

CurrentAVZ

string

The current zone.

cn-beijing-h

InsComment

string

The cluster alias or cluster comment.

test

TaskTypeZh

string

The task reason in Chinese.

小版本升级

TaskTypeEn

string

The task reason in English.

Minor version update

ChangeLevel

string

The event level code. Valid values:

  • S1: system maintenance.

  • S0: threat fix.

S0

ChangeLevelZh

string

The event level (Chinese).

系统运维

ChangeLevelEn

string

The event level (English).

System maintenance

ImpactZh

string

The event impact (Chinese).

集群闪断

ImpactEn

string

The event impact (English).

Transient instance disconnection

AllowChange

integer

Indicates whether time modification is allowed. Valid values:

  • 1: indicates that users are allowed to modify the time.

  • 0: indicates that users are not allowed to modify the time.

0

AllowCancel

integer

Indicates whether cancellation is allowed. Valid values:

  • 1: indicates that users are allowed to cancel the task.

  • 0: indicates that cancellation is not allowed.

0

Impact

string

The event impact.

TransientDisconnection

DBNodeIds

array

The list of node IDs.

string

The node ID. Multiple node IDs can be entered, separated by commas (,).

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

TaskParams

string

The task parameters.

{ "Action": "UpgradeDBInstance" }

Contoh

Respons sukses

JSONformat

{
  "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}"
    }
  ]
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

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

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.