Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
ListBackupJobSummaries
Ini adalah permintaan untuk ringkasan pekerjaan cadangan yang dibuat atau berjalan dalam 30 hari terakhir. Anda dapat menyertakan parameter accountID, State,,, ResourceType, MessageCategory AggregationPeriod MaxResults, NextToken atau untuk memfilter hasil.
Permintaan ini menampilkan ringkasan yang berisi Wilayah, Akun, Negara Bagian, ResourceType, MessageCategory, StartTime,, EndTime, dan Hitungan pekerjaan yang disertakan.
Sintaks Permintaan
GET /audit/backup-job-summaries?AccountId=AccountId
&AggregationPeriod=AggregationPeriod
&MaxResults=MaxResults
&MessageCategory=MessageCategory
&NextToken=NextToken
&ResourceType=ResourceType
&State=State
HTTP/1.1
URIParameter Permintaan
Permintaan menggunakan URI parameter berikut.
- AccountId
-
Mengembalikan jumlah pekerjaan untuk akun tertentu.
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_ALL
agregat jumlah pekerjaan dari semua akun dalam organisasi yang diautentikasi, lalu mengembalikan jumlahnya.Pola:
^[0-9]{12}$
- AggregationPeriod
-
Periode untuk hasil yang dikembalikan.
-
ONE_DAY
- Jumlah pekerjaan harian selama 14 hari sebelumnya. -
SEVEN_DAYS
- Jumlah pekerjaan agregat untuk 7 hari sebelumnya. -
FOURTEEN_DAYS
- Jumlah pekerjaan agregat selama 14 hari sebelumnya.
Nilai Valid:
ONE_DAY | SEVEN_DAYS | FOURTEEN_DAYS
-
- 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.
- MessageCategory
-
Parameter ini mengembalikan jumlah pekerjaan untuk kategori pesan tertentu.
Contoh string yang diterima meliputi
AccessDenied
,Success
, danInvalidParameters
. Lihat Monitoring untuk daftar MessageCategory string yang diterima.Nilai ANY mengembalikan jumlah semua kategori pesan.
AGGREGATE_ALL
agregat jumlah pekerjaan untuk semua kategori pesan dan mengembalikan jumlah. - NextToken
-
Item berikutnya mengikuti sebagian daftar sumber daya yang dikembalikan. Misalnya, jika permintaan dibuat untuk mengembalikan
MaxResults
jumlah sumber daya,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_ALL
agregat jumlah pekerjaan untuk semua jenis sumber daya dan mengembalikan jumlah.Jenis AWS sumber daya yang akan dicadangkan; misalnya, volume Amazon Elastic Block Store (AmazonEBS) atau database Amazon Relational Database Service (RDSAmazon).
Pola:
^[a-zA-Z0-9\-\_\.]{1,50}$
- State
-
Parameter ini mengembalikan jumlah pekerjaan untuk pekerjaan dengan status tertentu.
Nilai ANY mengembalikan jumlah semua negara.
AGGREGATE_ALL
agregat jumlah pekerjaan untuk semua negara bagian dan mengembalikan jumlah.Completed with issues
adalah status yang hanya ditemukan di AWS Backup konsol. UntukAPI, status ini mengacu pada pekerjaan dengan statusCOMPLETED
dan aMessageCategory
dengan nilai selainSUCCESS
; yaitu, status selesai tetapi dilengkapi dengan pesan status. Untuk mendapatkan jumlah pekerjaanCompleted with issues
, jalankan dua GET permintaan, dan kurangi nomor kedua yang lebih kecil:GET/audit/? backup-job-summaries AggregationPeriod= FOURTEEN _ DAYS &Negara = COMPLETED
GET/audit/? backup-job-summaries AggregationPeriod= FOURTEEN _ DAYS & MessageCategory = SUCCESS &Negara = COMPLETED
Nilai Valid:
CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL | AGGREGATE_ALL | ANY
Isi Permintaan
Permintaan tidak memiliki isi permintaan.
Sintaks Respons
HTTP/1.1 200
Content-type: application/json
{
"AggregationPeriod": "string",
"BackupJobSummaries": [
{
"AccountId": "string",
"Count": number,
"EndTime": number,
"MessageCategory": "string",
"Region": "string",
"ResourceType": "string",
"StartTime": number,
"State": "string"
}
],
"NextToken": "string"
}
Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Data berikut dikembalikan dalam JSON format oleh layanan.
- AggregationPeriod
-
Periode untuk hasil yang dikembalikan.
-
ONE_DAY
- Jumlah pekerjaan harian selama 14 hari sebelumnya. -
SEVEN_DAYS
- Jumlah pekerjaan agregat untuk 7 hari sebelumnya. -
FOURTEEN_DAYS
- Jumlah pekerjaan agregat selama 14 hari sebelumnya.
Tipe: String
-
- BackupJobSummaries
-
Informasi ringkasan.
Tipe: Array objek BackupJobSummary
- NextToken
-
Item berikutnya mengikuti sebagian daftar sumber daya yang dikembalikan. Misalnya, jika permintaan dibuat untuk mengembalikan
MaxResults
jumlah sumber daya,NextToken
memungkinkan Anda mengembalikan lebih banyak item dalam daftar Anda mulai dari lokasi yang ditunjukkan oleh token berikutnya.Tipe: String
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.
HTTPKode Status: 400
- ServiceUnavailableException
-
Permintaan gagal karena kegagalan sementara server.
HTTPKode Status: 500
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan ini API di salah satu bahasa khusus AWS SDKs, lihat berikut ini: