Tüm Ürünler
Search
Belge Merkezi

:Yedekleme görevlerini sorgulama

Son Güncelleme:Oct 02, 2026

Bir ApsaraDB RDS örneğinin yedekleme görevlerini sorgulamak için DescribeBackupTasks API işlemini çağırabilirsiniz.

Hata ayıklama

OpenAPI Explorer, imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için işlem örnek kodlarını dinamik olarak oluşturur.

İstek parametreleri

Parameter Type Required Example Description
Action String Yes DescribeBackupTasks

Gerçekleştirmek istediğiniz işlem. Değeri DescribeBackupTasks olarak belirtin.

DBInstanceId String Yes rm-uf6wjk5xxxxxxx

Örneğin ID'si.

ClientToken String No ETnLKlblzczshOTUbOCzxxxxxxx

İsteğin idempotensini (tekrarlanabilirliğini) sağlamak için kullanılan istemci belirteci. Bu değeri istemci tarafında üretebilirsiniz ancak farklı istekler arasında benzersiz olduğundan emin olmalısınız. Belirteç yalnızca ASCII karakterleri içerebilir ve uzunluğu 64 karakteri aşamaz.

Flag String No None

Gizli bir parametredir.

BackupJobId Integer No 4762614

Sorgulanacak tekil yedekleme görevinin ID'si.

BackupMode String No Automated

Sorgulanacak yedekleme görevlerinin kullandığı yedekleme modu. Geçerli değerler:

  • Automated
  • Manual
BackupJobStatus String No NoStart

Sorgulanacak yedekleme görevlerinin durumu. Geçerli değerler:

  • NoStart: Başlamamış yedekleme görevlerini sorgular.
  • Progressing: Devam eden yedekleme görevlerini sorgular.

Varsayılan olarak bu işlem, her iki durumdaki yedekleme görevlerini döndürür.

Yanıt parametreleri

Parameter Type Example Description
Items Array of BackupJob

Yedekleme görevlerinden oluşan bir dizi.

BackupJob
BackupId String 346650271

Yedekleme görevi tarafından oluşturulan yedekleme setinin ID'si.

Not Eğer BackupStatus parametresinin dönüş değeri Finished ise, oluşturulan yedekleme setinin ID'sini almak için BackupJobId parametresini belirtmeniz gerekir.
BackupJobId String 4762614

Yedekleme görevinin ID'si.

BackupProgressStatus String NoStart

Yedekleme programının durumu. Geçerli değerler:

  • NoStart: Yedekleme programı başlamadı.
  • Preparing: Yedekleme programı yedeklemeye hazırlanıyor.
  • Waiting: Yedekleme programı bekliyor.
  • Uploading: Yedekleme programı yedekleme dosyasını yüklüyor.
  • Checking: Yedekleme programı yüklenen yedekleme dosyasını kontrol ediyor.
  • Finished: Yedekleme programı yedeklemeyi tamamladı.
BackupStatus String NoStart

Yedekleme görevinin durumu. Geçerli değerler:

  • NoStart: Yedekleme görevi başlamadı.
  • Checking: Yedekleme görevi yedekleme ayarlarını kontrol ediyor.
  • Preparing: Yedekleme görevi yedeklemeye hazırlanıyor.
  • Waiting: Yedekleme görevi bekliyor.
  • Uploading: Yedekleme görevi yedekleme dosyasını yüklüyor.
  • Finished: Yedekleme görevi tamamlandı.
  • Failed: Yedekleme görevi başarısız oldu.
Not Bu parametre yalnızca bir yedekleme görevi çalıştırıldığında döndürülür.
JobMode String Automated

Yedekleme görevinin yedekleme modu. Geçerli değerler:

  • Automated
  • Manual
Process String 25

Yedekleme görevinin ilerleme durumu. Birim: %.

TaskAction String NormalBackupTask

Yedekleme görevinin türü. Geçerli değerler:

  • TempBackupTask: geçici yedekleme görevi
  • NormalBackupTask: normal yedekleme görevi
RequestId String 90496720-2319-42A8-87CD-FCE4DF95EBED

İsteğin ID'si.

Örnekler

Örnek istekler

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

Başarılı yanıt örnekleri

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

Hata kodları

Hata kodlarının listesi için API Hata Merkezi adresini ziyaret edin.