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.

1. Masuk ke SNSkonsol Amazon.

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

3. Pada halaman Edit topik, perluas bagian Kebijakan arsip.

4. Aktifkan fitur Kebijakan arsip, dan masukkan jumlah hari yang ingin Anda arsipkan pesan dalam topik.

5. 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. ArchivePolicymemiliki 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::Topicdi 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.

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

2. 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>",
  ...
}