Ringkasan API DescribeHistoryTasks untuk Riwayat Tugas Administratif PolarDB - PolarDB - Alibaba Cloud - PolarDB

Mengambil daftar tugas administratif historis untuk instance PolarDB for MySQL, seperti perubahan parameter, dan restart instance.

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:DescribeHistoryTasks

get

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	No	ID region. Catatan Untuk informasi lebih lanjut, lihat DescribeRegions.	cn-beijing
PageSize	integer	No	Jumlah catatan per halaman. Nilai valid: 10 hingga 100. Nilai default: 10.	10
PageNumber	integer	No	Nomor halaman. Nilai valid: bilangan bulat positif. Nilai default: 1.	1
InstanceType	string	No	Saat ini, hanya Instance yang didukung.	Instance
Status	string	No	Status tugas. Nilai valid: Scheduled: menunggu eksekusi Running: sedang dieksekusi Succeed: berhasil dieksekusi Cancelling: sedang dihentikan Canceled: dihentikan Waiting: menunggu waktu yang telah ditentukan Anda dapat memberikan daftar yang dipisahkan koma. Nilai default: kosong, yang menunjukkan semua status.	Running
InstanceId	string	No	ID resource untuk difilter. Anda dapat memberikan daftar yang dipisahkan koma hingga 30 ID. Nilai default: kosong, menunjukkan tidak ada batasan. Catatan Saat ini, hanya ID kluster PolarDB yang didukung.	pc-2zed3m89cw***
TaskId	string	No	ID tugas. Anda dapat memberikan daftar yang dipisahkan koma hingga 30 ID. Nilai default: kosong, menunjukkan tidak ada batasan.	t-0mqi38ho0cgjv***
TaskType	string	No	Jenis tugas. Anda dapat memberikan daftar yang dipisahkan koma hingga 30 jenis tugas. Nilai default: kosong, menunjukkan tidak ada batasan.	ChangeVariable
FromStartTime	string	Yes	Awal rentang waktu untuk kueri, berdasarkan waktu mulai tugas. Waktu mengikuti standar ISO8601 dan harus dalam waktu `UTC+0`. Format: `yyyy-MM-ddTHH:mm:ssZ`. Waktu paling awal yang didukung adalah 30 hari yang lalu. Jika waktu yang ditentukan lebih dari 30 hari yang lalu, akan secara otomatis dikonversi menjadi 30 hari yang lalu.	2025-01-02T11:31:03Z
ToStartTime	string	Yes	Akhir rentang waktu untuk kueri, berdasarkan waktu mulai tugas. Waktu mengikuti standar ISO8601 dan harus dalam waktu `UTC+0`. Format: `yyyy-MM-ddTHH:mm:ssZ`.	2025-01-03T11:31:03Z
FromExecTime	integer	No	Waktu eksekusi tugas minimum dalam detik. Memfilter tugas yang membutuhkan waktu lebih lama dari nilai ini. Nilai default: 0.	0
ToExecTime	integer	No	Waktu eksekusi tugas maksimum dalam detik. Memfilter tugas yang membutuhkan waktu lebih singkat dari nilai ini. Nilai default: 0.	0
ResourceGroupId	string	No	ID grup resource.	rg-************

Elemen respons

Element	Type	Description	Example
	object	Detail parameter yang dikembalikan.
PageNumber	integer	Nomor halaman dari hasil kueri.	1
RequestId	string	ID unik dari permintaan.	F90D7C14-2D1C-5B88-9CD1-23AB2CF89***
PageSize	integer	Jumlah catatan per halaman.	10
TotalCount	string	Jumlah total tugas yang memenuhi kondisi, terlepas dari faktor paging.	2
Items	array<object>	Daftar tugas.
	object	Objek tugas.
Status	string	Status akhir dari tugas. Scheduled: menunggu eksekusi Running: sedang dieksekusi Succeed: berhasil dieksekusi Failed: eksekusi gagal Cancelling: sedang dihentikan Canceled: dihentikan Waiting: menunggu waktu yang telah ditentukan	Succeed
TaskId	string	ID tugas.	t-0mqt8qhnw04ipz0***
CurrentStepName	string	Nama langkah saat ini yang sedang dieksekusi. Jika parameter ini kosong, tugas belum dimulai.	finish_task
StartTime	string	Waktu mulai dari tugas.	2025-03-03T07:25:16Z
EndTime	string	Waktu berakhir dari tugas.	2025-03-03T07:30:57Z
TaskType	string	Jenis tugas.	ChangeVariable
RemainTime	integer	Perkiraan sisa waktu eksekusi, dalam detik (s). Catatan Nilai ini hanya untuk referensi. Waktu eksekusi sebenarnya yang berlaku.	0
Progress	number	Progres penyelesaian tugas, dari 0,0 hingga 100,0.	100.0
RegionId	string	ID region.	cn-beijing
InstanceType	string	Jenis resource.	Instance
InstanceId	string	ID resource.	pc-2zed3m89cw***
InstanceName	string	Nama resource.	pc-2zed3m89cw***
DbType	string	Jenis database.	polardb_mysql
Product	string	Produk.	polardb
TaskDetail	string	Detail tugas.	{\"steps\":[{\"step_name\":\"init_task\"},{\"step_name\":\"exec_task\"},{\"step_name\":\"finish_task\"}]}
ReasonCode	string	Alasan untuk memulai tugas saat ini.	""
ActionInfo	string	Informasi operasi yang diizinkan. Catatan Fitur ini belum didukung.	{}
Uid	string	UID dari akun yang memiliki resource.	1816563541899***
CallerSource	string	Sumber permintaan. Nilai valid: System: sistem User: pengguna	User
CallerUid	string	ID dari pengguna yang meminta. Jika `CallerSource` adalah `User`, ini adalah UID pengguna.	1816563541899***

Contoh

Respons sukses

JSONformat

{
  "PageNumber": 1,
  "RequestId": "F90D7C14-2D1C-5B88-9CD1-23AB2CF89***",
  "PageSize": 10,
  "TotalCount": "2",
  "Items": [
    {
      "Status": "Succeed",
      "TaskId": "t-0mqt8qhnw04ipz0***",
      "CurrentStepName": "finish_task",
      "StartTime": "2025-03-03T07:25:16Z",
      "EndTime": "2025-03-03T07:30:57Z",
      "TaskType": "ChangeVariable",
      "RemainTime": 0,
      "Progress": 100,
      "RegionId": "cn-beijing",
      "InstanceType": "Instance",
      "InstanceId": "pc-2zed3m89cw***",
      "InstanceName": "pc-2zed3m89cw***",
      "DbType": "polardb_mysql",
      "Product": "polardb",
      "TaskDetail": "{\\\"steps\\\":[{\\\"step_name\\\":\\\"init_task\\\"},{\\\"step_name\\\":\\\"exec_task\\\"},{\\\"step_name\\\":\\\"finish_task\\\"}]}",
      "ReasonCode": "\"\"",
      "ActionInfo": "{}",
      "Uid": "1816563541899***",
      "CallerSource": "User",
      "CallerUid": "1816563541899***"
    }
  ]
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	Param.Invalid	The parameter is invalid.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.