**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](https://aws.amazon.com/s3/storage-classes/glacier/).

Amazon Glacier (layanan berbasis brankas mandiri asli) tidak lagi menerima pelanggan baru. 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](https://aws.amazon.com/s3/storage-classes/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](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/).

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)
<a name="api-vault-notifications-put"></a>

## Deskripsi
<a name="api-vault-notifications-put-description"></a>

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](configuring-notifications.md). 

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)](api-initiate-job-post.md)). 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)](api-describe-job-get.md).
+ **`InventoryRetrievalCompleted`—** Peristiwa ini terjadi ketika tugas yang dimulai untuk pengambilan inventaris selesai ([Memulai Tugas (POST jobs)](api-initiate-job-post.md)). 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)](api-describe-job-get.md).

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

## Permintaan
<a name="api-vault-notifications-put-requests"></a>

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
<a name="api-vault-notifications-put-requests-syntax"></a>

```
 1. PUT /AccountId/vaults/VaultName/notification-configuration HTTP/1.1
 2. Host: glacier.Region.amazonaws.com
 3. Date: Date
 4. Authorization: SignatureValue
 5. x-amz-glacier-version: 2012-06-01
 6. 
 7. {
 8.    "SNSTopic": String,
 9.    "Events":[String, ...] 
10. }
```

 

**catatan**  
`AccountId`Nilainya 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
<a name="api-vault-notifications-put-requests-parameters"></a>

Operasi ini tidak menggunakan parameter permintaan.

### Header Permintaan
<a name="api-vault-notifications-put-requests-headers"></a>

Operasi ini hanya menggunakan header permintaan yang umum untuk semua operasi. Untuk informasi selengkapnya tentang header permintaan umum, lihat [Header Permintaan Umum](api-common-request-headers.md).

### Isi Permintaan
<a name="api-vault-notifications-put-requests-elements"></a>

 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` \$1 `InventoryRetrievalCompleted`   
*Wajib*: ya  
*Tipe*: Array

**SNSTopic**  
ARN topik Amazon SNS. Untuk informasi selengkapnya, buka [Memulai Amazon SNS](https://docs.aws.amazon.com/sns/latest/gsg/Welcome.html) di *Panduan Memulai Amazon Simple Notification Service*.  
*Wajib*: ya  
*Tipe*: String

## Respons
<a name="api-vault-notifications-put-responses"></a>

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

### Sintaksis
<a name="api-vault-notifications-put-responses-elements"></a>

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

### Header Respons
<a name="api-vault-notifications-put-responses-headers"></a>

Operasi ini hanya menggunakan header permintaan yang umum untuk semua operasi. Untuk informasi selengkapnya tentang header permintaan umum, lihat [Header Permintaan Umum](api-common-request-headers.md).

### Isi Respons
<a name="api-vault-notifications-put-responses-body"></a>

Operasi ini tidak mengembalikan isi respons.

### Kesalahan
<a name="api-vault-notifications-put-responses-errors"></a>

Untuk informasi tentang pengecualian Amazon Glacier dan pesan kesalahan, lihat. [Respons Kesalahan](api-error-responses.md)

## Contoh
<a name="api-vault-notifications-put-examples"></a>

Contoh berikut menunjukkan cara mengonfigurasi notifikasi vault.

### Contoh Permintaan
<a name="api-vault-notifications-put-example-request"></a>

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

```
 1. PUT /-/vaults/examplevault/notification-policy HTTP/1.1
 2. Host: glacier.us-west-2.amazonaws.com
 3. x-amz-Date: 20170210T120000Z
 4. x-amz-glacier-version: 2012-06-01
 5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
 6. 
 7. { 
 8.    "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"],
 9.    "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic"       
10. }
```

### Contoh Respons
<a name="api-vault-notifications-put-example-response"></a>

Respons yang berhasil mengembalikan `204 No Content`.

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

## Bagian Terkait
<a name="related-sections-vault-notifications-put"></a>

 
+ [Mendapatkan Notifikasi Vault (GET notification-configuration)](api-vault-notifications-get.md)
+ [Menghapus Notifikasi Vault (DELETE notification-configuration)](api-vault-notifications-delete.md)
+ [Identity and Access Management untuk Amazon Glacier](security-iam.md)

## Lihat Juga
<a name="api-vault-notifications-put_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu Amazon khusus bahasa SDKs, lihat berikut ini:
+  [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/set-vault-notifications.html)