ListScanJobSummaries - 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.

ListScanJobSummaries

Ini adalah permintaan untuk ringkasan pekerjaan pemindaian yang dibuat atau dijalankan dalam 30 hari terakhir.

Minta Sintaks

GET /audit/scan-job-summaries?AccountId=AccountId&AggregationPeriod=AggregationPeriod&MalwareScanner=MalwareScanner&MaxResults=MaxResults&NextToken=NextToken&ResourceType=ResourceType&ScanResultStatus=ScanResultStatus&State=State HTTP/1.1

Parameter Permintaan URI

Permintaan menggunakan parameter URI berikut.

AccountId

Mengembalikan jumlah pekerjaan untuk akun yang ditentukan.

Jika permintaan dikirim dari akun anggota atau akun yang bukan bagian dari AWS Organizations, pekerjaan dalam akun pemohon akan dikembalikan.

Akun root, admin, dan administrator yang didelegasikan dapat menggunakan nilai tersebut ANY untuk mengembalikan jumlah pekerjaan dari setiap akun di organisasi.

AGGREGATE_ALLagregat jumlah pekerjaan dari semua akun dalam organisasi yang diautentikasi, lalu mengembalikan jumlahnya.

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

AggregationPeriod

Periode untuk hasil yang dikembalikan.

  • ONE_DAYJumlah pekerjaan harian untuk 1 hari sebelumnya.

  • SEVEN_DAYSJumlah pekerjaan harian selama 7 hari sebelumnya.

  • FOURTEEN_DAYSJumlah pekerjaan harian selama 14 hari sebelumnya.

Nilai Valid: ONE_DAY | SEVEN_DAYS | FOURTEEN_DAYS

MalwareScanner

Mengembalikan hanya pekerjaan scan untuk scanner malware tertentu. Saat ini satu-satunya MalwareScanner adalahGUARDDUTY. Tapi lapangan juga mendukungANY, danAGGREGATE_ALL.

Nilai Valid: GUARDDUTY

MaxResults

Jumlah maksimum item yang akan dikembalikan.

Nilainya adalah bilangan bulat. Rentang nilai yang diterima adalah dari 1 hingga 500.

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.

ResourceType

Mengembalikan jumlah pekerjaan untuk jenis sumber daya tertentu. Gunakan permintaan GetSupportedResourceTypes untuk mendapatkan string untuk jenis sumber daya yang didukung.

Nilai ANY mengembalikan jumlah semua jenis sumber daya.

AGGREGATE_ALLagregat jumlah pekerjaan untuk semua jenis sumber daya dan mengembalikan jumlah.

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

ScanResultStatus

Mengembalikan hanya pekerjaan scan untuk hasil scan tertentu.

Nilai Valid: NO_THREATS_FOUND | THREATS_FOUND

State

Mengembalikan hanya pekerjaan scan untuk status pekerjaan pemindaian yang ditentukan.

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

Isi Permintaan

Permintaan tidak memiliki isi permintaan.

Sintaks Respons

HTTP/1.1 200
Content-type: application/json

{
   "AggregationPeriod": "string",
   "NextToken": "string",
   "ScanJobSummaries": [ 
      { 
         "AccountId": "string",
         "Count": number,
         "EndTime": number,
         "MalwareScanner": "string",
         "Region": "string",
         "ResourceType": "string",
         "ScanResultStatus": "string",
         "StartTime": number,
         "State": "string"
      }
   ]
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

AggregationPeriod

Periode untuk hasil yang dikembalikan.

  • ONE_DAYJumlah pekerjaan harian untuk 1 hari sebelumnya.

  • SEVEN_DAYSJumlah pekerjaan harian selama 7 hari sebelumnya.

  • FOURTEEN_DAYSJumlah pekerjaan harian selama 14 hari sebelumnya.

Nilai yang Valid: 'ONE_DAY' | 'SEVEN_DAYS' | 'FOURTEEN_DAYS'

Tipe: String

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

ScanJobSummaries

Informasi ringkasan.

Tipe: Array objek ScanJobSummary

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: