DescribeEvents - Amazon DocumentDB

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

DescribeEvents

Mengembalikan peristiwa yang terkait dengan instans, grup keamanan, snapshot, dan grup parameter DB selama 14 hari terakhir. Anda dapat memperoleh peristiwa khusus untuk instans DB, grup keamanan, snapshot, atau grup parameter tertentu dengan memberikan nama sebagai parameter. Secara default, peristiwa jam terakhir dikembalikan.

Parameter Permintaan

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat Parameter Umum.

Duration

Jumlah menit untuk mengambil peristiwa.

Default: 60

Tipe: Integer

Wajib: Tidak

EndTime

Akhir interval waktu untuk mengambil peristiwa, ditentukan dalam format ISO 8601.

Contoh: 2009-07-08T18:00Z

Tipe: Timestamp

Diperlukan: Tidak

EventCategories. EventCategory.N

Daftar kategori peristiwa yang memicu notifikasi untuk langganan notifikasi peristiwa.

Tipe: Array string

Diperlukan: Tidak

Filter.Filter.N

Parameter ini saat ini tidak didukung.

Tipe: Array objek Filter

Diperlukan: Tidak

Marker

Token pagination opsional yang disediakan oleh permintaan sebelumnya. Jika parameter ini ditentukan, respons hanya menyertakan catatan di luar penanda, hingga nilai yang ditentukan dengan MaxRecords.

Tipe: String

Wajib: Tidak

MaxRecords

Jumlah maksimum catatan yang akan dikembalikan dalam respons. Jika lebih banyak catatan ada daripada nilai MaxRecords yang ditentukan, token pagination / pemberian nomor halaman (penanda) disertakan dalam respons sehingga hasil yang tersisa dapat diambil.

Default: 100

Kendala: Minimum 20, maksimum 100.

Tipe: Integer

Wajib: Tidak

SourceIdentifier

Pengidentifikasi sumber peristiwa yang peristiwanya dikembalikan. Jika tidak ditentukan, maka semua sumber disertakan dalam respons.

Batasan:

  • Jika SourceIdentifier disediakan, SourceType juga harus disediakan.

  • Jika jenis sumber adalah DBInstance, sebuah DBInstanceIdentifier harus disediakan.

  • Jika jenis sumber adalah DBSecurityGroup, sebuah DBSecurityGroupName harus disediakan.

  • Jika jenis sumber adalah DBParameterGroup, sebuah DBParameterGroupName harus disediakan.

  • Jika jenis sumber adalah DBSnapshot, sebuah DBSnapshotIdentifier harus disediakan.

  • Tidak dapat diakhiri dengan tanda hubung atau mengandung dua tanda hubung berturut-turut.

Tipe: String

Wajib: Tidak

SourceType

Sumber peristiwa untuk mengambil peristiwa. Jika tidak ada nilai yang ditentukan, semua peristiwa dikembalikan.

Jenis: String

Nilai yang Valid: db-instance | db-parameter-group | db-security-group | db-snapshot | db-cluster | db-cluster-snapshot

Diperlukan: Tidak

StartTime

Awal interval waktu untuk mengambil peristiwa, ditentukan dalam format ISO 8601.

Contoh: 2009-07-08T18:00Z

Tipe: Timestamp

Diperlukan: Tidak

Elemen Respons

Elemen-elemen berikut dikembalikan oleh layanan.

Peristiwa.Event.N

Informasi mendetail tentang satu atau lebih peristiwa.

Tipe: Array objek Event

Marker

Token pagination opsional yang disediakan oleh permintaan sebelumnya. Jika parameter ini ditentukan, respons hanya menyertakan catatan di luar penanda, hingga nilai yang ditentukan dengan MaxRecords.

Jenis: String

Kesalahan

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

Lihat Juga

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