Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# ListBackupJobs
<a name="API_ListBackupJobs"></a>

Mengembalikan daftar pekerjaan cadangan yang ada untuk akun yang diautentikasi selama 30 hari terakhir. Untuk jangka waktu yang lebih lama, pertimbangkan untuk menggunakan [alat pemantauan](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html) ini.

## Minta Sintaks
<a name="API_ListBackupJobs_RequestSyntax"></a>

```
GET /backup-jobs/?accountId=ByAccountId&backupVaultName=ByBackupVaultName&completeAfter=ByCompleteAfter&completeBefore=ByCompleteBefore&createdAfter=ByCreatedAfter&createdBefore=ByCreatedBefore&maxResults=MaxResults&messageCategory=ByMessageCategory&nextToken=NextToken&parentJobId=ByParentJobId&resourceArn=ByResourceArn&resourceType=ByResourceType&state=ByState HTTP/1.1
```

## Parameter Permintaan URI
<a name="API_ListBackupJobs_RequestParameters"></a>

Permintaan menggunakan parameter URI berikut.

 ** [ByAccountId](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByAccountId"></a>
ID akun untuk daftar pekerjaan dari. Mengembalikan hanya pekerjaan cadangan yang terkait dengan ID akun tertentu.  
Jika digunakan dari akun AWS Organizations manajemen, lulus `*` mengembalikan semua pekerjaan di seluruh organisasi.  
Pola: `^[0-9]{12}$` 

 ** [ByBackupVaultName](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByBackupVaultName"></a>
Mengembalikan hanya pekerjaan cadangan yang akan disimpan di brankas cadangan yang ditentukan. Vault cadangan diidentifikasi berdasarkan nama yang unik untuk akun yang digunakan untuk membuatnya dan Wilayah AWS tempatnya dibuat.  
Pola: `^[a-zA-Z0-9\-\_]{2,50}$` 

 ** [ByCompleteAfter](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByCompleteAfter"></a>
Mengembalikan hanya pekerjaan cadangan yang diselesaikan setelah tanggal yang dinyatakan dalam format Unix dan Waktu Universal Terkoordinasi (UTC).

 ** [ByCompleteBefore](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByCompleteBefore"></a>
Mengembalikan hanya pekerjaan cadangan yang diselesaikan sebelum tanggal yang dinyatakan dalam format Unix dan Waktu Universal Terkoordinasi (UTC).

 ** [ByCreatedAfter](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByCreatedAfter"></a>
Mengembalikan hanya pekerjaan cadangan yang dibuat setelah tanggal yang ditentukan.

 ** [ByCreatedBefore](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByCreatedBefore"></a>
Mengembalikan hanya pekerjaan cadangan yang dibuat sebelum tanggal yang ditentukan.

 ** [ByMessageCategory](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByMessageCategory"></a>
Ini adalah parameter opsional yang dapat digunakan untuk menyaring pekerjaan dengan MessageCategory yang cocok dengan nilai yang Anda masukkan.  
Contoh string dapat mencakup`AccessDenied`,, `SUCCESS``AGGREGATE_ALL`, dan`InvalidParameters`.  
Lihat [Monitoring](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html)   
Wildcard () mengembalikan jumlah semua kategori pesan.  
 `AGGREGATE_ALL`agregat jumlah pekerjaan untuk semua kategori pesan dan mengembalikan jumlah.

 ** [ByParentJobId](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByParentJobId"></a>
Ini adalah filter untuk mencantumkan pekerjaan anak (bersarang) berdasarkan ID pekerjaan orang tua.

 ** [ByResourceArn](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByResourceArn"></a>
Mengembalikan hanya pekerjaan cadangan yang cocok dengan sumber daya yang ditentukan Amazon Resource Name (ARN).

 ** [ByResourceType](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByResourceType"></a>
Mengembalikan hanya pekerjaan cadangan untuk sumber daya yang ditentukan:  
+  `Aurora`untuk Amazon Aurora
+  `CloudFormation`untuk AWS CloudFormation 
+  `DocumentDB`untuk Amazon DocumentDB (dengan kompatibilitas MongoDB)
+  `DynamoDB`untuk Amazon DynamoDB
+  `EBS`untuk Amazon Elastic Block Store
+  `EC2`untuk Amazon Elastic Compute Cloud
+  `EFS`untuk Amazon Elastic File System
+  `EKS`untuk Layanan Amazon Elastic Kubernetes
+  `FSx`untuk Amazon FSx
+  `Neptune`untuk Amazon Neptunus
+  `RDS`untuk Amazon Relational Database Service
+  `Redshift`untuk Amazon Redshift
+  `S3`untuk Amazon Simple Storage Service (Amazon S3)
+  `SAP HANA on Amazon EC2`untuk database SAP HANA pada instans Amazon Elastic Compute Cloud
+  `Storage Gateway`untuk AWS Storage Gateway 
+  `Timestream`untuk Amazon Timestream
+  `VirtualMachine`untuk mesin VMware virtual
Pola: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [ByState](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByState"></a>
Mengembalikan hanya pekerjaan cadangan yang berada dalam keadaan tertentu.  
 `Completed with issues`adalah status yang hanya ditemukan di AWS Backup konsol. Untuk API, status ini mengacu pada pekerjaan dengan status `COMPLETED` dan a `MessageCategory` dengan nilai selain`SUCCESS`; yaitu, status selesai tetapi dilengkapi dengan pesan status.  
Untuk mendapatkan jumlah pekerjaan`Completed with issues`, jalankan dua permintaan GET, dan kurangi nomor kedua yang lebih kecil:  
DAPATKAN /backup-jobs/? State=Selesai  
DAPATKAN /backup-jobs/? messageCategory=Success&state=Selesai  
Nilai Valid: `CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL` 

 ** [MaxResults](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-MaxResults"></a>
Jumlah maksimum item yang akan dikembalikan.  
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 1000.

 ** [NextToken](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-NextToken"></a>
Item berikutnya mengikuti sebagian daftar item yang dikembalikan. Misalnya, jika permintaan dibuat untuk mengembalikan `MaxResults` jumlah item, `NextToken` memungkinkan Anda mengembalikan lebih banyak item dalam daftar Anda mulai dari lokasi yang ditunjukkan oleh token berikutnya.

## Isi Permintaan
<a name="API_ListBackupJobs_RequestBody"></a>

Permintaan tidak memiliki isi permintaan.

## Sintaks Respons
<a name="API_ListBackupJobs_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupJobs": [ 
      { 
         "AccountId": "string",
         "BackupJobId": "string",
         "BackupOptions": { 
            "string" : "string" 
         },
         "BackupSizeInBytes": number,
         "BackupType": "string",
         "BackupVaultArn": "string",
         "BackupVaultName": "string",
         "BytesTransferred": number,
         "CompletionDate": number,
         "CreatedBy": { 
            "BackupPlanArn": "string",
            "BackupPlanId": "string",
            "BackupPlanName": "string",
            "BackupPlanVersion": "string",
            "BackupRuleCron": "string",
            "BackupRuleId": "string",
            "BackupRuleName": "string",
            "BackupRuleTimezone": "string"
         },
         "CreationDate": number,
         "EncryptionKeyArn": "string",
         "ExpectedCompletionDate": number,
         "IamRoleArn": "string",
         "InitiationDate": number,
         "IsEncrypted": boolean,
         "IsParent": boolean,
         "MessageCategory": "string",
         "ParentJobId": "string",
         "PercentDone": "string",
         "RecoveryPointArn": "string",
         "RecoveryPointLifecycle": { 
            "DeleteAfterDays": number,
            "DeleteAfterEvent": "string",
            "MoveToColdStorageAfterDays": number,
            "OptInToArchiveForSupportedResources": boolean
         },
         "ResourceArn": "string",
         "ResourceName": "string",
         "ResourceType": "string",
         "StartBy": number,
         "State": "string",
         "StatusMessage": "string",
         "VaultLockState": "string",
         "VaultType": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elemen Respons
<a name="API_ListBackupJobs_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [BackupJobs](#API_ListBackupJobs_ResponseSyntax) **   <a name="Backup-ListBackupJobs-response-BackupJobs"></a>
Array struktur yang berisi metadata tentang pekerjaan cadangan Anda dikembalikan dalam format JSON.  
Tipe: Array objek [BackupJob](API_BackupJob.md)

 ** [NextToken](#API_ListBackupJobs_ResponseSyntax) **   <a name="Backup-ListBackupJobs-response-NextToken"></a>
Item berikutnya mengikuti sebagian daftar item yang dikembalikan. Misalnya, jika permintaan dibuat untuk mengembalikan `MaxResults` jumlah item, `NextToken` memungkinkan Anda mengembalikan lebih banyak item dalam daftar Anda mulai dari lokasi yang ditunjukkan oleh token berikutnya.  
Tipe: String

## Kesalahan
<a name="API_ListBackupJobs_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Jenis Kesalahan Umum](CommonErrors.md).

 ** InvalidParameterValueException **   
Menunjukkan bahwa ada sesuatu yang salah dengan nilai parameter. Misalnya, nilainya di luar jangkauan.    
 ** Context **   
  
 ** Type **   

Kode Status HTTP: 400

 ** ServiceUnavailableException **   
Permintaan gagal karena kegagalan sementara server.    
 ** Context **   
  
 ** Type **   

Kode Status HTTP: 500

## Lihat Juga
<a name="API_ListBackupJobs_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListBackupJobs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListBackupJobs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListBackupJobs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListBackupJobs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListBackupJobs) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListBackupJobs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListBackupJobs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListBackupJobs) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListBackupJobs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListBackupJobs)