All Products
Search

This Product

    :Kueri tugas backup

    Document Center

    :Kueri tugas backup

    Last Updated:May 27, 2026

    Anda dapat memanggil operasi DescribeBackupTasks untuk mengkueri tugas backup dari instans ApsaraDB RDS.

    Debugging

    OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi ini untuk berbagai SDK.

    Parameter permintaan

    Parameter Type Required Example Description
    Action String Yes DescribeBackupTasks

    Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeBackupTasks.
    DBInstanceId String Yes rm-uf6wjk5xxxxxxx

    ID instans.
    ClientToken String No ETnLKlblzczshOTUbOCzxxxxxxx

    Token client yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan client untuk menghasilkan nilainya, tetapi harus memastikan bahwa nilainya unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter.
    Flag String No None

    Parameter tersembunyi.
    BackupJobId Integer No 4762614

    ID tugas backup tunggal yang akan dikueri.
    BackupMode String No Automated

    Mode backup yang digunakan oleh tugas backup yang akan dikueri. Nilai yang valid:

    • Automated
    • Manual
    BackupJobStatus String No NoStart

    Status tugas backup yang akan dikueri. Nilai yang valid:

    • NoStart: menentukan untuk mengkueri tugas backup yang belum dimulai.
    • Progressing: menentukan untuk mengkueri tugas backup yang sedang berlangsung.

    Secara default, operasi ini mengembalikan tugas backup dalam kedua status tersebut.

    Parameter respons

    Parameter Type Example Description
    Items Array of BackupJob

    Array yang berisi tugas backup.
    BackupJob
    BackupId String 346650271

    ID set cadangan yang dihasilkan oleh tugas backup.

    Catatan Jika nilai kembali parameter BackupStatus adalah Finished, Anda harus menentukan parameter BackupJobId untuk mendapatkan ID set cadangan yang dihasilkan.
    BackupJobId String 4762614

    ID tugas backup.
    BackupProgressStatus String NoStart

    Status program backup. Nilai yang valid:

    • NoStart: Program backup belum dimulai.
    • Preparing: Program backup sedang mempersiapkan backup.
    • Waiting: Program backup sedang menunggu.
    • Uploading: Program backup sedang mengunggah file backup.
    • Checking: Program backup sedang memeriksa file backup yang diunggah.
    • Finished: Program backup telah menyelesaikan backup.
    BackupStatus String NoStart

    Status tugas backup. Nilai yang valid:

    • NoStart: Tugas backup belum dimulai.
    • Checking: Tugas backup sedang memeriksa pengaturan backup.
    • Preparing: Tugas backup sedang mempersiapkan backup.
    • Waiting: Tugas backup sedang menunggu.
    • Uploading: Tugas backup sedang mengunggah file backup.
    • Finished: Tugas backup selesai.
    • Failed Tugas backup gagal.
    Catatan Parameter ini hanya dikembalikan ketika tugas backup dieksekusi.
    JobMode String Automated

    Mode backup dari tugas backup. Nilai yang valid:

    • Automated
    • Manual
    Process String 25

    Progres tugas backup. Satuan: %.
    TaskAction String NormalBackupTask

    Jenis tugas backup. Nilai yang valid:

    • TempBackupTask: tugas backup temporary
    • NormalBackupTask: tugas backup reguler
    RequestId String 90496720-2319-42A8-87CD-FCE4DF95EBED

    ID permintaan.

    Contoh

    Contoh permintaan

    http(s)://rds.aliyuncs.com/? Action=DescribeBackupTasks
&DBInstanceId=rm-uf6wjk5xxxxxxx
&<Common request parameters>

    Contoh respons sukses

    XML format

    <DescribeBackupTasksResponse>
	  <Items>
		    <BackupJob>
			      <JobMode>Automated</JobMode>
			      <BackupProgressStatus>NoStart</BackupProgressStatus>
			      <TaskAction>NormalBackupTask</TaskAction>
			      <BackupStatus>NoStart</BackupStatus>
			      <BackupJobId>4762614</BackupJobId>
		    </BackupJob>
	  </Items>
	  <RequestId>90496720-2319-42A8-87CD-FCE4DF95EBED</RequestId>
</DescribeBackupTasksResponse>

    JSON format

    {
    "Items": {
        "BackupJob": [
            {
                "JobMode": "Automated",
                "BackupProgressStatus": "NoStart",
                "TaskAction": "NormalBackupTask",
                "BackupStatus": "NoStart",
                "BackupJobId": 4762614
            }
        ]
    },
    "RequestId": "90496720-2319-42A8-87CD-FCE4DF95EBED"
}

    Kode kesalahan

    Untuk daftar kode kesalahan, kunjungi API Error Center.