Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Ulangan pesan Amazon SNS untuk pelanggan topik FIFO
Pemutaran ulang Amazon SNS memungkinkan pelanggan topik untuk mengambil dan mengirimkan ulang pesan yang diarsipkan dari penyimpanan data topik ke titik akhir berlangganan.
+ Pesan dapat diputar ulang segera setelah langganan dibuat.
+ Pesan yang diputar ulang mempertahankan konten yang sama,`MessageId`, dan `Timestamp` seperti aslinya.
+ Pesan menyertakan `Replayed` atribut untuk menunjukkan bahwa itu adalah pesan yang diputar ulang.
+ Untuk memutar ulang hanya pesan tertentu, terapkan kebijakan filter ke langganan Anda.
Untuk informasi lebih lanjut tentang memfilter pesan, lihat[Filter pesan yang diputar ulang](#message-archiving-and-replay-subscription-filtering).
## Membuat kebijakan pemutaran ulang pesan menggunakan Konsol Manajemen AWS
Gunakan opsi ini untuk membuat kebijakan replay baru menggunakan. Konsol Manajemen AWS
1. Masuk ke [Konsol Amazon SNS](https://console.aws.amazon.com/sns/home).
1. Pilih langganan topik atau buat yang baru. Untuk mempelajari lebih lanjut tentang membuat langganan, lihat[Membuat langganan ke topik Amazon SNS](sns-create-subscribe-endpoint-to-topic.md).
1. **Untuk memulai pemutaran ulang pesan, buka drop-down Putar ulang dan pilih **Mulai replay**.**
1. Dari modal **Replay timeframe**, buat pilihan berikut:
1. **Pilih tanggal dan waktu mulai putar ulang - Pilih **tanggal**** (YYYY/MM/DDformat) dan **waktu** (format 24 jam jam: mm: ss) dari mana Anda ingin mulai memutar ulang pesan yang diarsipkan. Waktu mulai harus lebih lambat dari awal perkiraan waktu arsip.
1. **(Opsional) Pilih tanggal dan waktu akhir pemutaran ulang** - Pilih **tanggal** (YYYY/MM/DDformat) dan **waktu** (format 24 jam jam: mm: ss) saat Anda ingin berhenti memutar ulang pesan yang diarsipkan.
1. Pilih **Mulai putar ulang**.
1. (Opsional) Untuk **menghentikan pemutaran** ulang pesan, buka halaman **Detail langganan** dan pilih **Hentikan pemutaran ulang dari tarik-turun Putar** **Ulang**.
1. (Opsional) Untuk **memantau** metrik pemutaran ulang pesan dari dalam alur kerja ini menggunakan CloudWatch, lihat. [Pantau metrik pemutaran ulang pesan menggunakan Amazon CloudWatch](#message-archiving-and-replay-subscription-cloudwatch)
**Untuk melihat dan mengedit kebijakan pemutaran ulang pesan**
Anda dapat melakukan tindakan berikut dari halaman **Detail langganan**:
+ Untuk **melihat** status pemutaran ulang pesan, bidang **status Putar ulang** menampilkan nilai berikut:
+ **Selesai** — Putar ulang telah berhasil mengirim ulang semua pesan, dan sekarang mengirimkan pesan yang baru diterbitkan.
+ **Sedang berlangsung** - Putar ulang saat ini memutar ulang pesan yang dipilih.
+ **Gagal** - Pemutaran ulang tidak dapat diselesaikan.
+ **Tertunda** - Status default saat pemutaran ulang dimulai.
+ (Opsional) Untuk **mengubah** kebijakan pemutaran ulang pesan, buka halaman **Detail langganan** dan pilih **Mulai memutar ulang dari tarik-turun Putar** **Ulang**. Memulai replay akan menggantikan replay yang ada.
## Menambahkan kebijakan pemutaran ulang ke langganan menggunakan API
Untuk memutar ulang pesan yang diarsipkan, gunakan atribut. `ReplayPolicy` `ReplayPolicy`dapat digunakan dengan tindakan `SetSubscriptionAttributes` API `Subscribe` dan. Kebijakan ini memiliki nilai-nilai berikut:
+ **`StartingPoint`**(Wajib) — Sinyal dari mana harus mulai memutar ulang pesan.
+ **`EndingPoint`**(Opsional) — Sinyal kapan harus berhenti memutar ulang pesan. Jika `EndingPoint` dihilangkan, maka pemutaran ulang akan berlanjut hingga terjebak hingga waktu saat ini.
+ **`PointType`**(Wajib) - Mengatur jenis titik awal dan akhir. Saat ini, nilai yang didukung untuk `PointType` adalah`Timestamp`.
Misalnya, untuk memulihkan dari kegagalan hilir dan mengirim ulang semua pesan selama dua jam pada 1 Oktober 2023, gunakan tindakan `SetSubscriptionAttributes` API untuk menetapkan sebagai `ReplayPolicy` berikut:
```
{
"PointType":"Timestamp",
"StartingPoint":"2023-10-01T10:00:00.000Z",
"EndingPoint":"2023-10-01T12:00:00.000Z"
}
```
Untuk memutar ulang semua pesan yang dikirim ke topik per 1 Oktober 2023, dan terus menerima semua pesan yang baru diterbitkan ke topik Anda, gunakan tindakan `SetSubscriptionAttributes` API untuk menyetel langganan Anda sebagai berikut: `ReplayPolicy`
```
{
"PointType":"Timestamp",
"StartingPoint":"2023-10-01T00:00:00.000Z"
}
```
Untuk memverifikasi bahwa pesan telah diputar ulang, atribut boolean ditambahkan ke setiap pesan yang `Replayed` diputar ulang.
## Menambahkan kebijakan pemutaran ulang ke langganan menggunakan SDK
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 langganan untuk mengirim ulang pesan dari arsip topik Amazon SNS FIFO untuk jangka waktu 2 jam pada 1 Oktober 2023. `ReplayPolicy`
```
// Specify the ARN of the Amazon SNS subscription to initiate the ReplayPolicy on.
String subscriptionArn =
"arn:aws:sns:us-east-2:123456789012:MyArchiveTopic.fifo:1d2a3e9d-7f2f-447c-88ae-03f1c68294da";
// Set the ReplayPolicy to replay messages from the topic's archive
// for a 2 hour time period on October 1st 2023 between 10am and 12pm UTC.
String replayPolicy =
"{\"PointType\":\"Timestamp\",\"StartingPoint\":\"2023-10-01T10:00:00.000Z\",\"EndingPoint\":\"2023-10-01T12:00:00.000Z\"}";
// Set the ArchivePolicy for the Amazon SNS topic
SetSubscriptionAttributesRequest request = new SetSubscriptionAttributesRequest()
.withSubscriptionArn(subscriptionArn)
.withAttributeName("ReplayPolicy")
.withAttributeValue(replayPolicy);
sns.setSubscriptionAttributes(request);
```
## Memahami EndingPoint
Saat Anda `ReplayPolicy` menerapkan langganan Amazon SNS, `EndingPoint` nilainya opsional. Jika tidak `EndingPoint` disediakan, pemutaran ulang akan dimulai dari yang ditentukan `StartingPoint` dan berlanjut hingga mengikuti waktu saat ini, termasuk memproses pesan yang baru diterbitkan. Setelah tertangkap, langganan akan berfungsi sebagai langganan reguler, menerima pesan baru saat dipublikasikan.
Jika `EndingPoint` ditentukan, layanan akan memutar ulang pesan dari `StartingPoint` atas ke `EndingPoint` dan kemudian berhenti. **Tindakan ini secara efektif menghentikan langganan.** Saat langganan dijeda, pesan yang baru diterbitkan tidak akan dikirimkan ke titik akhir berlangganan.
Untuk melanjutkan pengiriman pesan, terapkan yang baru `ReplayPolicy` tanpa memberikan`EndingPoint`, dan atur `StartingPoint` ke titik waktu yang diinginkan untuk terus menerima pesan. Misalnya, untuk melanjutkan langganan dari tempat pemutaran ulang sebelumnya selesai, atur yang baru `StartingPoint` ke yang disediakan `EndingPoint` sebelumnya.
## Filter pesan yang diputar ulang
Pemfilteran pesan Amazon SNS memungkinkan Anda mengontrol pesan yang diputar ulang yang diputar ulang Amazon SNS ke titik akhir pelanggan Anda. Saat pemfilteran pesan dan pengarsipan pesan diaktifkan, Amazon SNS pertama-tama mengambil pesan dari penyimpanan data topik, lalu menerapkan pesan terhadap langganan. `FilterPolicy` Pesan dikirim ke titik akhir berlangganan saat ada kecocokan, jika tidak, pesan akan disaring. Untuk informasi selengkapnya, lihat [Kebijakan filter langganan Amazon SNS](sns-subscription-filter-policies.md).
## Pantau metrik pemutaran ulang pesan menggunakan Amazon CloudWatch
Anda dapat memantau pesan replay 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 |
| --- | --- |
| **NumberOfReplayedNotificationsDelivered** | Menyediakan pelanggan dengan jumlah agregat pesan yang diputar ulang dari arsip topik, pada resolusi 1 menit. |
| **NumberOfReplayedNotificationsFailed** | Menyediakan pelanggan dengan jumlah agregat pesan yang diputar ulang yang gagal disampaikan dari arsip topik, pada resolusi 1 menit. |