Mendapatkan Notifikasi Vault (GET notification-configuration) - Amazon S3 Glacier

Halaman ini hanya untuk pelanggan lama layanan S3 Glacier menggunakan Vaults dan REST API asli dari tahun 2012.

Jika Anda mencari solusi penyimpanan arsip, kami sarankan untuk menggunakan kelas penyimpanan S3 Glacier di Amazon S3, Pengambilan Instan Gletser S3, Pengambilan Fleksibel Gletser S3, dan S3 Glacier Deep Archive. Untuk mempelajari lebih lanjut tentang opsi penyimpanan ini, lihat Kelas penyimpanan S3 Glacier dan Penyimpanan data jangka panjang menggunakan kelas penyimpanan S3 Glacier di Panduan Pengguna Amazon S3. Kelas penyimpanan ini menggunakan Amazon S3 API, tersedia di semua wilayah, dan dapat dikelola dalam konsol Amazon S3. Mereka menawarkan fitur seperti Analisis Biaya Penyimpanan, Lensa Penyimpanan, fitur enkripsi opsional canggih, dan banyak lagi.

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

Mendapatkan Notifikasi Vault (GET notification-configuration)

Deskripsi

Operasi ini mengambil subsumber daya notification-configuration yang ditetapkan di vault (lihat Menetapkan Konfigurasi Notifikasi Vault (PUT notification-configuration). Jika konfigurasi notifikasi untuk vault tidak ditetapkan, operasi mengembalikan kesalahan 404 Not Found. Untuk informasi selengkapnya tentang notifikasi vault, lihat Mengonfigurasi Notifikasi Vault di Amazon S3 Glacier.

Permintaan

Untuk mengambil informasi konfigurasi notifikasi, kirim permintaan GET ke URI dari subsumber daya notification-configuration vault.

Sintaks

GET /AccountId/vaults/VaultName/notification-configuration HTTP/1.1 Host: glacier.Region.amazonaws.com Date: Date Authorization: SignatureValue x-amz-glacier-version: 2012-06-01

catatan

AccountIdNilainya adalah Akun AWS ID akun yang memiliki brankas. Anda dapat menentukan Akun AWS ID atau secara opsional satu '-' (tanda hubung), dalam hal ini Amazon S3 Glacier menggunakan Akun AWS ID yang terkait dengan kredenal yang digunakan untuk menandatangani permintaan. Jika Anda menggunakan ID akun, jangan sertakan tanda hubung ('-') di ID.

Parameter Permintaan

Operasi ini tidak menggunakan parameter permintaan.

Header Permintaan

Operasi ini hanya menggunakan header permintaan yang umum untuk semua operasi. Untuk informasi selengkapnya tentang header permintaan umum, lihat Header Permintaan Umum.

Isi Permintaan

Operasi ini tidak memiliki isi permintaan.

Respons

Sintaks

HTTP/1.1 200 OK x-amzn-RequestId: x-amzn-RequestId Date: Date Content-Type: application/json Content-Length: length { "Events": [ String, ... ], "SNSTopic": String }

Header Respons

Operasi ini hanya menggunakan header respons yang umum untuk sebagian besar respons. Untuk informasi tentang header permintaan umum, lihat Header Respons Umum.

Isi Respons

Isi respons berisi bidang JSON berikut.

Peristiwa

Daftar satu atau beberapa peristiwa tempat Amazon S3 Glacier (S3 Glacier) akan mengirimkan notifikasi ke topik Amazon SNS yang ditentukan. Untuk informasi tentang peristiwa vault tempat Anda dapat mengonfigurasi vault untuk menerbitkan notifikasi, lihat Menetapkan Konfigurasi Notifikasi Vault (PUT notification-configuration).

Tipe: Array

SNSTopic

Amazon Resource Name (ARN topik Amazon Simple Notification Service (Amazon SNS). Untuk informasi selengkapnya, lihat Memulai Amazon SNS di Panduan Memulai Amazon Simple Notification Service.

Tipe: String

Kesalahan

Untuk informasi tentang pengecualian dan pesan kesalahan Amazon S3 Glacier, lihat Respons Kesalahan.

Contoh

Contoh berikut menunjukkan cara mengambil konfigurasi notifikasi untuk vault.

Contoh Permintaan

Dalam contoh ini, permintaan GET dikirim ke subsumber daya notification-configuration dari vault.

GET /-/vaults/examplevault/notification-configuration HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-glacier-version: 2012-06-01 Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

Contoh Respons

Respons yang berhasil menunjukkan dokumen konfigurasi pencatatan audit di isi respons dalam format JSON. Dalam contoh ini, konfigurasi menunjukkan notifikasi untuk dua peristiwa (ArchiveRetrievalCompleted dan InventoryRetrievalCompleted) dikirim ke topik Amazon SNS arn:aws:sns:us-west-2:012345678901:mytopic.

HTTP/1.1 200 OK x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT Content-Type: application/json Content-Length: 150 { "Events": [ "ArchiveRetrievalCompleted", "InventoryRetrievalCompleted" ], "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic" }

Lihat Juga

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