Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Pengarsipan SNS pesan Amazon untuk pemilik FIFO topik
Pengarsipan pesan menyediakan kemampuan untuk mengarsipkan satu salinan dari semua pesan yang dipublikasikan ke topik Anda. Anda dapat menyimpan pesan yang dipublikasikan dalam topik Anda dengan mengaktifkan kebijakan arsip pesan pada topik, yang memungkinkan pengarsipan pesan untuk semua langganan yang ditautkan ke topik tersebut. Pesan dapat diarsipkan minimal satu hari hingga maksimal 365 hari.
Biaya tambahan berlaku saat menetapkan kebijakan arsip. Untuk informasi harga, lihat SNSharga Amazon
Membuat kebijakan arsip pesan menggunakan AWS Management Console
Gunakan opsi ini untuk membuat kebijakan arsip pesan baru menggunakan AWS Management Console.
Masuk ke SNSkonsol Amazon
. -
Pilih topik atau buat yang baru. Untuk mempelajari lebih lanjut tentang membuat topik, lihat Membuat SNS topik Amazon.
catatan
Pengarsipan dan pemutaran ulang SNS pesan Amazon hanya tersedia untuk topik application-to-application (A2A). FIFO
-
Pada halaman Edit topik, perluas bagian Kebijakan arsip.
-
Aktifkan fitur Kebijakan arsip, dan masukkan jumlah hari yang ingin Anda arsipkan pesan dalam topik.
-
Pilih Simpan perubahan.
Untuk melihat, mengedit, dan menonaktifkan kebijakan topik pengarsipan pesan
-
Pada halaman Detail topik, kebijakan Retensi menampilkan status kebijakan arsip, termasuk jumlah hari yang disetel. Pilih tab Kebijakan arsip untuk melihat detail arsip pesan berikut:
-
Status — Status arsip dan pemutaran ulang muncul sebagai aktif saat kebijakan arsip diterapkan. Status arsip dan pemutaran ulang muncul sebagai tidak aktif saat kebijakan arsip disetel ke objek kosongJSON.
-
Periode penyimpanan pesan — Jumlah hari yang ditentukan untuk penyimpanan pesan.
-
Tanggal mulai arsip — Tanggal dari mana pelanggan dapat memutar ulang pesan.
-
JSONpratinjau — JSON Pratinjau kebijakan arsip.
-
-
(Opsional) Untuk mengedit kebijakan arsip, buka halaman ringkasan topik dan pilih Edit.
-
(Opsional) Untuk menonaktifkan kebijakan arsip, buka halaman ringkasan topik dan pilih Edit. Nonaktifkan Kebijakan Arsip dan pilih Simpan perubahan.
-
(Opsional) Untuk menghapus topik dengan kebijakan arsip, Anda harus terlebih dahulu menonaktifkan kebijakan arsip seperti yang dijelaskan sebelumnya.
penting
Untuk menghindari penghapusan pesan yang tidak disengaja, Anda tidak dapat menghapus topik dengan kebijakan arsip pesan aktif. Kebijakan arsip pesan topik harus dinonaktifkan sebelum topik dapat dihapus. Saat Anda menonaktifkan kebijakan arsip pesan, Amazon SNS menghapus semua pesan yang diarsipkan. Saat menghapus topik, langganan dihapus, dan pesan apa pun yang sedang transit mungkin tidak terkirim.
Membuat kebijakan arsip pesan menggunakan API
Untuk membuat kebijakan arsip pesan menggunakanAPI, Anda perlu menambahkan atribut ArchivePolicy
ke topik Anda. Anda dapat mengatur ArchivePolicy
menggunakan API tindakan CreateTopic
danSetTopicAttributes
. ArchivePolicy
memiliki nilai tunggal,MessageRetentionPeriod
, yang mewakili jumlah hari Amazon SNS menyimpan pesan. Untuk mengaktifkan pengarsipan pesan untuk topik Anda, setel MessageRetentionPeriod
ke nilai integer lebih besar dari nol. Misalnya, untuk menyimpan pesan dalam arsip Anda selama 30 hari, setel ArchivePolicy
ke:
{ "ArchivePolicy": { "MessageRetentionPeriod": "30" } }
Untuk menonaktifkan pengarsipan pesan untuk topik Anda, dan menghapus arsip, batalkan pengaturanArchivePolicy
, sebagai berikut:
{}
Membuat kebijakan arsip pesan menggunakan SDK
Untuk menggunakan AWS SDK, Anda harus mengkonfigurasinya dengan kredensil Anda. Untuk informasi selengkapnya, lihat Berbagi config
dan credentials
file di Panduan Referensi Alat AWS SDKs dan Alat.
Contoh kode berikut menunjukkan cara mengatur SNS topik Amazon ArchivePolicy
untuk menyimpan semua pesan yang dipublikasikan ke topik selama 30 hari.
// Specify the ARN of the Amazon SNS topic to set the ArchivePolicy for. String topicArn = "arn:aws:sns:us-east-2:123456789012:MyArchiveTopic.fifo"; // Set the MessageRetentionPeriod to 30 days for the ArchivePolicy. String archivePolicy = "{\"MessageRetentionPeriod\":\"30\"}"; // Set the ArchivePolicy for the Amazon SNS topic SetTopicAttributesRequest request = new SetTopicAttributesRequest() .withTopicArn(topicArn) .withAttributeName("ArchivePolicy") .withAttributeValue(archivePolicy); sns.setTopicAttributes(request);
Membuat kebijakan arsip pesan menggunakan AWS CloudFormation
Untuk membuat kebijakan arsip menggunakan AWS CloudFormation lihat AWS::SNS::Topic
di Panduan AWS CloudFormation Pengguna.
Berikan akses ke arsip terenkripsi
Sebelum pelanggan dapat mulai memutar ulang pesan dari topik terenkripsi, Anda harus menyelesaikan langkah-langkah berikut. Karena pesan sebelumnya diputar ulang, Amazon SNS perlu menyediakan Decrypt
akses ke KMS kunci yang digunakan untuk mengenkripsi pesan dalam arsip.
-
Saat Anda mengenkripsi pesan dengan KMS kunci dan menyimpannya dalam topik, Anda harus memberi Amazon SNS kemampuan untuk mendekripsi pesan ini melalui Kebijakan Utama. Untuk lebih lanjut, lihatBerikan izin dekripsi ke Amazon SNS.
-
Aktifkan AWS KMS untuk AmazonSNS. Untuk lebih lanjut, lihatMengkonfigurasi izin AWS KMS.
penting
Ketika Anda menambahkan bagian baru ke kebijakan KMS utama Anda, jangan mengubah bagian yang ada dalam kebijakan. Jika enkripsi diaktifkan pada suatu topik, dan KMS kuncinya dinonaktifkan atau dihapus, atau kebijakan KMS kunci tidak dikonfigurasi dengan benar untuk AmazonSNS, Amazon SNS tidak dapat memutar ulang pesan ke pelanggan Anda.
Berikan izin dekripsi ke Amazon SNS
SNSAgar Amazon dapat mengakses pesan terenkripsi dari dalam arsip topik Anda dan memutarnya kembali ke titik akhir berlangganan, Anda harus mengaktifkan prinsip SNS layanan Amazon untuk mendekripsi pesan ini.
Berikut ini adalah contoh kebijakan yang diperlukan untuk mengizinkan kepala SNS layanan Amazon mendekripsi pesan yang disimpan selama pemutaran ulang pesan historis dari dalam topik Anda.
{ "Sid": "Allow SNS to decrypt archived messages", "Effect": "Allow", "Principal": { "Service": "sns.amazonaws.com" }, "Action": [ "kms:Decrypt", "kms:GenerateDataKey" ], "Resource": "*" }
Pantau metrik arsip pesan menggunakan Amazon CloudWatch
Anda dapat memantau pesan yang diarsipkan menggunakan Amazon CloudWatch menggunakan metrik berikut. Agar diberi tahu tentang anomali pada beban kerja Anda dan membantu menghindari dampak, Anda dapat mengonfigurasi CloudWatch alarm Amazon pada metrik ini. Untuk detail selengkapnya, lihat Pencatatan dan pemantauan di Amazon SNS.
Metrik | Deskripsi |
---|---|
ApproximateNumberOfMessagesArchived |
Menyediakan pemilik topik dengan jumlah agregat pesan yang diarsipkan dalam arsip topik, pada resolusi 60 menit. |
ApproximateNumberOfBytesArchived |
Menyediakan pemilik topik dengan jumlah agregat byte yang diarsipkan, di semua pesan dalam arsip topik, pada resolusi 60 menit. |
NumberOfMessagesArchiveProcessing |
Memberikan pemilik topik dengan jumlah pesan yang disimpan ke arsip topik selama interval dalam resolusi 1 menit. |
NumberOfBytesArchiveProcessing |
Menyediakan pemilik topik dengan jumlah agregat byte yang disimpan ke arsip topik selama interval dalam resolusi 1 menit. |
Ini GetTopicAttributes
API memiliki BeginningArchiveTime
properti, yang mewakili stempel waktu tertua di mana pelanggan dapat memulai pemutaran ulang. Berikut ini merupakan contoh respons untuk API tindakan ini:
{ "ArchivePolicy": { "MessageRetentionPeriod": "
<integer>
" }, "BeginningArchiveTime": "<timestamp>
", ... }