ListScanJobs - AWS Backup
Minta SintaksParameter Permintaan URIIsi PermintaanSintaks ResponsElemen ResponsKesalahanLihat Juga

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

ListScanJobs

Mengembalikan daftar pekerjaan pemindaian yang ada untuk akun yang diautentikasi selama 30 hari terakhir.

Minta Sintaks

GET /scan/jobs?ByAccountId=ByAccountId&ByBackupVaultName=ByBackupVaultName&ByCompleteAfter=ByCompleteAfter&ByCompleteBefore=ByCompleteBefore&ByMalwareScanner=ByMalwareScanner&ByRecoveryPointArn=ByRecoveryPointArn&ByResourceArn=ByResourceArn&ByResourceType=ByResourceType&ByScanResultStatus=ByScanResultStatus&ByState=ByState&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1

Parameter Permintaan URI

Permintaan menggunakan parameter URI berikut.

ByAccountId

ID akun untuk daftar pekerjaan dari. Mengembalikan hanya pekerjaan cadangan yang terkait dengan ID akun tertentu.

Jika digunakan dari akun manajemen AWS Organizations, lulus * mengembalikan semua pekerjaan di seluruh organisasi.

Pola: ^[0-9]{12}$

ByBackupVaultName

Mengembalikan hanya pekerjaan scan yang akan disimpan dalam brankas cadangan yang ditentukan. Brankas cadangan diidentifikasi dengan nama yang unik untuk akun yang digunakan untuk membuatnya dan AWS Wilayah tempat pembuatannya.

Pola: ^[a-zA-Z0-9\-\_\.]{2,50}$

ByCompleteAfter

Pengembalian hanya memindai pekerjaan yang diselesaikan setelah tanggal yang dinyatakan dalam format Unix dan Waktu Universal Terkoordinasi (UTC).

ByCompleteBefore

Mengembalikan hanya pekerjaan cadangan yang diselesaikan sebelum tanggal yang dinyatakan dalam format Unix dan Waktu Universal Terkoordinasi (UTC).

ByMalwareScanner

Mengembalikan hanya pekerjaan scan untuk scanner malware tertentu. Saat ini hanya mendukungGUARDDUTY.

Nilai Valid: GUARDDUTY

ByRecoveryPointArn

Mengembalikan hanya pekerjaan scan yang dijalankan terhadap titik pemulihan yang ditentukan.

ByResourceArn

Mengembalikan hanya pekerjaan pemindaian yang cocok dengan sumber daya yang ditentukan Amazon Resource Name (ARN).

ByResourceType

Mengembalikan pilihan pengujian pemulihan dengan nama rencana pengujian pemulihan yang ditentukan.

  • EBSuntuk Amazon Elastic Block Store

  • EC2untuk Amazon Elastic Compute Cloud

  • S3untuk Amazon Simple Storage Service (Amazon S3)

Pola: ^[a-zA-Z0-9\-\_\.]{1,50}$

Nilai Valid: EBS | EC2 | S3

ByScanResultStatus

Mengembalikan hanya pekerjaan scan untuk hasil scan tertentu:

  • THREATS_FOUND

  • NO_THREATS_FOUND

Nilai Valid: NO_THREATS_FOUND | THREATS_FOUND

ByState

Mengembalikan hanya pekerjaan scan untuk status pekerjaan pemindaian tertentu.

Nilai Valid: CANCELED | COMPLETED | COMPLETED_WITH_ISSUES | CREATED | FAILED | RUNNING

MaxResults

Jumlah maksimum item yang akan dikembalikan.

Rentang yang Valid: Nilai minimum 1. Nilai maksimum 1000.

Rentang yang Valid: Nilai minimum 1. Nilai maksimum 1000.

NextToken

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

Permintaan tidak memiliki isi permintaan.

Sintaks Respons

HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "ScanJobs": [ 
      { 
         "AccountId": "string",
         "BackupVaultArn": "string",
         "BackupVaultName": "string",
         "CompletionDate": number,
         "CreatedBy": { 
            "BackupPlanArn": "string",
            "BackupPlanId": "string",
            "BackupPlanVersion": "string",
            "BackupRuleId": "string"
         },
         "CreationDate": number,
         "IamRoleArn": "string",
         "MalwareScanner": "string",
         "RecoveryPointArn": "string",
         "ResourceArn": "string",
         "ResourceName": "string",
         "ResourceType": "string",
         "ScanBaseRecoveryPointArn": "string",
         "ScanId": "string",
         "ScanJobId": "string",
         "ScanMode": "string",
         "ScannerRoleArn": "string",
         "ScanResult": { 
            "ScanResultStatus": "string"
         },
         "State": "string",
         "StatusMessage": "string"
      }
   ]
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

NextToken

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

ScanJobs

Array struktur yang berisi metadata tentang pekerjaan pemindaian Anda dikembalikan dalam format JSON.

Tipe: Array objek ScanJob

Kesalahan

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini: