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

# Pengarsipan pesan Amazon SNS untuk pemilik topik FIFO
<a name="message-archiving-and-replay-topic-owner"></a>

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 harga [Amazon SNS](https://aws.amazon.com/sns/pricing/).

## Membuat kebijakan arsip pesan menggunakan Konsol Manajemen AWS
<a name="message-archiving-and-replay-topic-console"></a>

Gunakan opsi ini untuk membuat kebijakan arsip pesan baru menggunakan Konsol Manajemen AWS.

1. Masuk ke [Konsol Amazon SNS](https://console.aws.amazon.com/sns/home).

1. Pilih topik atau buat yang baru. Untuk mempelajari lebih lanjut tentang membuat topik, lihat [Membuat topik Amazon SNS](sns-create-topic.md).
**catatan**  
Pengarsipan dan pemutaran ulang pesan Amazon SNS hanya tersedia untuk topik FIFO application-to-application (A2A).

1. Pada halaman **Edit topik**, perluas bagian **Kebijakan arsip**.

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

1. 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 JSON kosong.
  + **Periode penyimpanan pesan** — Jumlah hari yang ditentukan untuk penyimpanan pesan.
  + **Tanggal mulai arsip** — Tanggal dari mana pelanggan dapat memutar ulang pesan.
  + **Pratinjau JSON - Pratinjau** JSON dari 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 akan 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
<a name="message-archiving-and-replay-topic-api"></a>

Untuk membuat kebijakan arsip pesan menggunakan API, Anda perlu menambahkan atribut `ArchivePolicy` ke topik Anda. Anda dapat mengatur `ArchivePolicy` menggunakan tindakan API `CreateTopic` dan`SetTopicAttributes`. `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 pengaturan`ArchivePolicy`, sebagai berikut:

```
{}
```

## Membuat kebijakan arsip pesan menggunakan SDK
<a name="message-archiving-and-replay-topic-sdk"></a>

Untuk menggunakan AWS SDK, Anda harus mengonfigurasinya dengan kredensil Anda. Untuk informasi selengkapnya, lihat [Berbagi `config` dan `credentials` file](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) di *Panduan Referensi Alat AWS SDKs dan Alat*.

Contoh kode berikut menunjukkan cara mengatur topik Amazon SNS `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 CloudFormation
<a name="message-archiving-and-replay-topic-cfn"></a>

Untuk membuat kebijakan arsip menggunakan CloudFormation lihat [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-topic.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-topic.html)di *Panduan AWS CloudFormation Pengguna*.

## Berikan akses ke arsip terenkripsi
<a name="message-archiving-and-replay-topic-kms"></a>

Sebelum pelanggan dapat mulai memutar ulang pesan dari topik terenkripsi, Anda harus menyelesaikan langkah-langkah berikut. Karena pesan sebelumnya diputar ulang, Amazon SNS perlu `Decrypt` disediakan akses ke kunci KMS yang digunakan untuk mengenkripsi pesan dalam arsip.

1. Saat Anda mengenkripsi pesan dengan kunci KMS dan menyimpannya dalam topik, Anda harus memberi Amazon SNS kemampuan untuk mendekripsi pesan ini melalui Kebijakan Utama. Untuk lebih lanjut, lihat[Berikan izin dekripsi ke Amazon SNS](#message-archiving-and-replay-topic-decrypt-permissions).

1. Aktifkan AWS KMS untuk Amazon SNS. Untuk lebih lanjut, lihat[Mengkonfigurasi izin AWS KMS](sns-key-management.md#sns-what-permissions-for-sse).

**penting**  
Saat Anda menambahkan bagian baru ke kebijakan kunci KMS Anda, jangan ubah bagian yang ada dalam kebijakan. Jika enkripsi diaktifkan pada suatu topik, dan kunci KMS dinonaktifkan atau dihapus, atau kebijakan kunci KMS tidak dikonfigurasi dengan benar untuk Amazon SNS, Amazon SNS tidak dapat memutar ulang pesan ke pelanggan Anda. 

### Berikan izin dekripsi ke Amazon SNS
<a name="message-archiving-and-replay-topic-decrypt-permissions"></a>

Agar Amazon SNS dapat mengakses pesan terenkripsi dari dalam arsip topik Anda dan memutarnya kembali ke titik akhir berlangganan, Anda harus mengaktifkan prinsip layanan Amazon SNS untuk mendekripsi pesan ini.

Berikut ini adalah contoh kebijakan yang diperlukan untuk mengizinkan prinsipal layanan Amazon SNS 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
<a name="message-archiving-and-replay-topic-cloudwatch"></a>

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](sns-logging-monitoring.md).


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

`GetTopicAttributes`API memiliki `BeginningArchiveTime` properti, yang mewakili stempel waktu tertua di mana pelanggan dapat memulai pemutaran ulang. Berikut ini merupakan contoh respons untuk tindakan API ini:

```
{
 "ArchivePolicy": {
    "MessageRetentionPeriod": "{{<integer>}}"
  },
  "BeginningArchiveTime": "{{<timestamp>}}",
  ...
}
```