Menetapkan Konfigurasi Notifikasi Vault (PUT notification-configuration)

Deskripsi

Mengambil arsip dan inventaris vault adalah operasi asinkron di Amazon S3 Glacier (S3 Glacier) tempat Anda pertama kali memulai tugas dan menunggu tugas selesai sebelum Anda dapat mengunduh output tugas. 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 Mengonfigurasi Notifikasi Vault di Amazon S3 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 mencakup dokumen JSON yang menyediakan topik dan peristiwa Amazon Simple Notification Service (Amazon SNS) tempat Anda ingin S3 Glacier mengirim notifikasi ke topik.

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

Nilai AccountId adalah ID Akun AWS dari akun yang memiliki vault. Anda dapat menentukan ID Akun AWS atau secara opsional satu '-' (tanda hubung), dalam hal ini, Amazon S3 Glacier menggunakan ID Akun AWS yang terkait dengan kredensial 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.

Event

Array dari satu atau lebih peristiwa yang Anda ingin S3 Glacier untuk mengirim notifikasi.

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 respons, Amazon S3 Glacier (S3 Glacier) mengembalikan 204 No Content 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 dan pesan kesalahan Amazon S3 Glacier, 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

Bagian Terkait

• Mendapatkan Notifikasi Vault (GET notification-configuration)

• Menghapus Notifikasi Vault (DELETE notification-configuration)

• Identity and Access Management untuk Amazon S3 Glacier

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu dari SDK Amazon spesifik bahasa, lihat berikut ini:

• AWS Command Line Interface