Definisi, model, dan properti subscription MNS - Simple Message Queue (formerly MNS)

Subscription mendefinisikan cara konsumen menerima pesan dari topik di Simple Message Queue (formerly MNS).

Hubungan definisi dan model

Di Simple Message Queue (formerly MNS), subscription adalah aturan yang didaftarkan oleh konsumen pada suatu topik untuk menerima pesan. Asosiasikan sebuah topik dengan satu atau beberapa subscription guna menyesuaikan aturan dorong (push) dan target pengiriman.

Gambar berikut menunjukkan bagaimana subscription masuk ke dalam model perpesanan Simple Message Queue (formerly MNS).

Fitur

Multiple subscription types: Satu topik dapat memiliki beberapa subscription. Setiap subscription sesuai dengan tipe endpoint yang berbeda.
Multiple subscriptions for messages: Satu topik dapat memiliki beberapa subscription, dan setiap subscription menerima semua pesan dari topik tersebut.

Properti Subskripsi

Subscription name

Definisi: Mengidentifikasi subscription. Harus unik untuk setiap subscriber dan topik.
Nilai: String hingga 255 karakter. Nama harus dimulai dengan huruf dan dapat berisi huruf, angka, serta tanda hubung (-).

Subscription type

Definisi: Jenis endpoint yang berlangganan pesan.
Nilai: Queue, HTTP service, Short Message Service, Direct Mail, dan Mobile Push. Subscription types.

Catatan

Batas laju dorong (TPS) bervariasi tergantung tipe subscription:

Subscription antrian standar: Batas dorong default adalah 20.000 TPS.
Subscription layanan HTTP(S): Batas dorong default adalah 2.000 TPS.

Melebihi batas ini akan memicu throttling, yang dapat menunda pengiriman pesan. Untuk menaikkan batas, kirimkan tiket.

Endpoint

Definisi: Endpoint yang menerima pesan.
Nilai:
- Jika Subscription type diatur ke HTTP, masukkan alamat HTTP yang dimulai dengan http:// atau https://.
- Jika Subscription type diatur ke queue, masukkan nama antrian.
- Jika Subscription type diatur ke Short Message Service, masukkan nomor telepon.
- Jika Subscription type diatur ke mailbox, masukkan alamat email.
- Jika Subscription type diatur ke mobile terminal, masukkan AppKey.

Message filtering tag

Definisi: Tag yang digunakan untuk memfilter pesan yang dikirimkan ke subscription ini. Message filtering.
Nilai: String hingga 16 karakter. Saat ini, hanya satu tag yang didukung.

Retry policy (NotifyStrategy)

Definisi: Menentukan kebijakan pengulangan ketika dorong pesan ke endpoint gagal. Jika gagal, Simple Message Queue (formerly MNS) melakukan pengulangan berdasarkan kebijakan tersebut. Setelah semua upaya pengulangan habis, Simple Message Queue (formerly MNS) membuang pesan tersebut dan melanjutkan ke pesan berikutnya.
Nilai:
- BACKOFF_RETRY: Dorong pesan diulang 3 kali. Interval antar pengulangan adalah nilai acak antara 10 hingga 20 detik.
- EXPONENTIAL_DECAY_RETRY: Dorong pesan diulang 176 kali dalam durasi total 1 hari. Interval pengulangan meningkat secara eksponensial dari 1 detik hingga maksimum 512 detik. Interval pengulangan spesifiknya adalah 1, 2, 4, 8, 16, 32, 64, 128, 256, 512, diikuti oleh 166 pengulangan dengan interval 512 detik.

Message format (NotifyContentFormat)

Definisi: Menentukan format pesan yang didorong ke endpoint.

Nilai:

SIMPLIFIED: Isi pesan hanya berisi konten yang dipublikasikan, tanpa atribut pesan. Contoh:
```
{1:"a", 2:"b"}
```

JSON: Isi pesan dalam format JSON dan mencakup konten beserta atributnya. Contoh:

{
    "TopicOwner":"TopicOwner",
    "TopicName":"TopicName",
    "Subscriber":"Subscriber",
    "SubscriptionName":"SubscriptionName",
    "MessageId":"6CC4D900CA59A2CD-1-15180534A8F-20000****",
    "Message":"xxxxx",
    "MessageMD5":"F1E92841751D795AB325861034B5****",
    "MessageTag":"important",
    "PublishTime":"1449556920975"
}

XML: Isi pesan dalam format XML dan mencakup konten beserta atributnya. Contoh:

<?xml version="1.0" encoding="utf-8"?>
    <Notification xlmns="http://mns.aliyuncs.com/doc/v1/">
        <TopicOwner>TopicOwner</TopicOwner>
        <TopicName>TopicName</TopicName>
        <Subscriber>Subscriber</Subscriber>
        <SubscriptionName>SubscriptionName</SubscriptionName>
        <MessageId>6CC4D900CA59A2CD-1-15180534A8F-20000****</MessageId>
        <Message>{1:"a", 2:"b"}</Message>
        <MessageMD5>F1E92841751D795AB325861034B5****</MessageMD5>
        <MessageTag>important</MessageTag>
        <PublishTime>1449556920975</MessagePublishTime>
    </Notification>

Catatan

Untuk tipe subscription Short Message Service dan mailbox, hanya format pesan SIMPLIFIED yang didukung.