Menetapkan Konfigurasi Notifikasi Vault (PUT notification-configuration) - Amazon Glacier
DeskripsiPermintaanResponsContohBagian TerkaitLihat Juga

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

Jika Anda mencari solusi penyimpanan arsip, sebaiknya gunakan kelas penyimpanan Amazon Glacier di Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval, dan S3 Glacier Deep Archive. Untuk mempelajari lebih lanjut tentang opsi penyimpanan ini, lihat kelas penyimpanan Amazon Glacier.

Amazon Glacier (layanan berbasis brankas mandiri asli) tidak akan lagi menerima pelanggan baru mulai 15 Desember 2025, tanpa berdampak pada pelanggan yang sudah ada. Amazon Glacier adalah layanan mandiri dengan miliknya APIs sendiri yang menyimpan data di brankas dan berbeda dari Amazon S3 dan kelas penyimpanan Amazon S3 Glacier. Data Anda yang ada akan tetap aman dan dapat diakses di Amazon Glacier tanpa batas waktu. Tidak diperlukan migrasi. Untuk penyimpanan arsip jangka panjang berbiaya rendah, AWS rekomendasikan kelas penyimpanan Amazon S3 Glacier, yang memberikan pengalaman pelanggan yang unggul dengan APIs berbasis ember S3, ketersediaan penuh, biaya lebih rendah, Wilayah AWS dan integrasi layanan. AWS Jika Anda ingin meningkatkan kemampuan, pertimbangkan untuk bermigrasi ke kelas penyimpanan Amazon S3 Glacier dengan menggunakan Panduan Solusi AWS kami untuk mentransfer data dari kubah Amazon Glacier ke kelas penyimpanan Amazon S3 Glacier.

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

Menetapkan Konfigurasi Notifikasi Vault (PUT notification-configuration)

Deskripsi

Mengambil arsip dan inventaris brankas adalah operasi asinkron di Amazon Glacier (Amazon Glacier) di mana Anda harus terlebih dahulu memulai pekerjaan dan menunggu pekerjaan selesai sebelum Anda dapat mengunduh hasil pekerjaan. Anda dapat mengonfigurasi vault untuk mengirim pesan ke topik Amazon Simple Notification Service (Amazon SNS) ketika tugas ini selesai. Anda dapat menggunakan operasi ini untuk menetapkan konfigurasi notifikasi di vault. Untuk informasi selengkapnya, lihat Mengkonfigurasi Pemberitahuan Vault di Amazon Glacier.

Untuk mengonfigurasi notifikasi vault, kirim permintaan PUT ke subsumber daya notification-configuration dari vault. Konfigurasi notifikasi spesifik dengan vault; Oleh karena itu, juga disebut sebagai subsumber daya vault. Permintaan harus menyertakan dokumen JSON yang menyediakan topik Amazon Simple Notification Service (Amazon SNS) dan acara yang Anda inginkan Amazon Glacier mengirim notifikasi ke topik tersebut.

Anda dapat mengonfigurasi vault untuk menerbitkan notifikasi untuk peristiwa vault berikut:

  • ArchiveRetrievalCompleted— Peristiwa ini terjadi ketika tugas yang dimulai untuk pengambilan arsip selesai (Memulai Tugas (POST jobs)). Status tugas yang selesai dapat Succeeded atau Failed. Notifikasi yang dikirim ke topik SNS adalah output yang sama seperti yang dikembalikan dari Mendeskripsikan Tugas (GET JobID).

  • InventoryRetrievalCompleted— Peristiwa ini terjadi ketika tugas yang dimulai untuk pengambilan inventaris selesai (Memulai Tugas (POST jobs)). Status tugas yang selesai dapat Succeeded atau Failed. Notifikasi yang dikirim ke topik SNS adalah output yang sama seperti yang dikembalikan dari Mendeskripsikan Tugas (GET JobID).

Topik Amazon SNS harus memberikan izin ke vault agar diizinkan untuk menerbitkan notifikasi ke topik.

Permintaan

Untuk menetapkan konfigurasi notifikasi di vault, kirim permintaan PUT ke URI dari subsumber daya notification-configuration dari vault. Anda menentukan konfigurasi dalam isi permintaan. Konfigurasi termasuk nama topik Amazon SNS dan array peristiwa yang memicu notifikasi untuk setiap topik.

Sintaksis

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

{
   "SNSTopic": String,
   "Events":[String, ...] 
}

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

JSON dalam isi permintaan berisi bidang berikut.

Peristiwa

Sebuah array dari satu atau beberapa acara yang Anda ingin Amazon Glacier untuk mengirim pemberitahuan.

Nilai yang Valid: ArchiveRetrievalCompleted | InventoryRetrievalCompleted

Wajib: ya

Tipe: Array

SNSTopic

ARN topik Amazon SNS. Untuk informasi selengkapnya, buka Memulai Amazon SNS di Panduan Memulai Amazon Simple Notification Service.

Wajib: ya

Tipe: String

Respons

Sebagai tanggapan, Amazon Glacier (Amazon Glacier) 204 No Content kembali jika konfigurasi notifikasi diterima.

Sintaksis

HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date

Header Respons

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

Isi Respons

Operasi ini tidak mengembalikan isi respons.

Kesalahan

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

Contoh

Contoh berikut menunjukkan cara mengonfigurasi notifikasi vault.

Contoh Permintaan

Permintaan berikut menetapkan konfigurasi notifikasi examplevault sehingga notifikasi untuk dua peristiwa (ArchiveRetrievalCompleted dan InventoryRetrievalCompleted) dikirim ke topik Amazon SNS arn:aws:sns:us-west-2:012345678901:mytopic.

PUT /-/vaults/examplevault/notification-policy 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

{ 
   "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"],
   "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic"       
}

Contoh Respons

Respons yang berhasil mengembalikan 204 No Content.

HTTP/1.1 204 No Content
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT

Lihat Juga

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