MNS subscription definition, model, and properties - Simple Message Queue (formerly MNS)

Les abonnements définissent la manière dont les consommateurs reçoivent les messages des topics dans Simple Message Queue (formerly MNS).

Définition et relation avec le modèle

Dans Simple Message Queue (formerly MNS), un abonnement est une règle qu'un consommateur enregistre sur un topic pour recevoir des messages. Associez un topic à un ou plusieurs abonnements afin de personnaliser les règles d'envoi et les cibles de livraison.

Le schéma ci-dessous illustre l'intégration des abonnements dans le modèle de messagerie de Simple Message Queue (formerly MNS).

Fonctionnalités

Plusieurs types d'abonnement : Un topic peut disposer de plusieurs abonnements. Chaque abonnement correspond à un type d'endpoint différent.
Abonnements multiples pour les messages : Un topic peut avoir plusieurs abonnements, et chaque abonnement reçoit tous les messages publiés sur ce topic.

Propriétés de l'abonnement

Nom de l'abonnement

Définition : Identifie l'abonnement. Doit être unique par abonné et par topic.
Valeur : Chaîne de caractères pouvant contenir jusqu'à 255 caractères. Le nom doit commencer par une lettre et peut contenir des lettres, des chiffres et des traits d'union (-).

Type d'abonnement

Définition : Type d'endpoint qui s'abonne aux messages.
Valeurs : Queue, service HTTP, Short Message Service, Direct Mail et Mobile Push. Consultez la section Types d'abonnement.

Remarque

Les limites de débit d'envoi (TPS) varient selon le type d'abonnement :

Abonnement à une file d'attente standard : La limite d'envoi par défaut est de 20 000 TPS.
Abonnement à un service HTTP(S) : La limite d'envoi par défaut est de 2 000 TPS.

Le dépassement de ces limites déclenche une limitation de débit, susceptible de retarder la livraison des messages. Pour augmenter ces limites, soumettez un ticket.

Endpoint

Définition : Endpoint qui reçoit les messages.
Valeur :
- Si le paramètre Subscription type est défini sur HTTP, saisissez une adresse HTTP commençant par http:// ou https://.
- Si le paramètre Subscription type est défini sur queue, saisissez le nom de la file d'attente.
- Si le paramètre Subscription type est défini sur Short Message Service, saisissez le numéro de téléphone.
- Si le paramètre Subscription type est défini sur mailbox, saisissez l'adresse e-mail.
- Si le paramètre Subscription type est défini sur mobile terminal, saisissez l'AppKey.

Tag de filtrage des messages

Définition : Tag utilisé pour filtrer les messages livrés à cet abonnement. Consultez la section Filtrage des messages.
Valeur : Chaîne de caractères pouvant contenir jusqu'à 16 caractères. Actuellement, un seul tag est pris en charge.

Politique de nouvelle tentative (NotifyStrategy)

Définition : Spécifie la politique de nouvelle tentative lorsqu'une opération d'envoi vers un endpoint échoue. En cas d'échec, Simple Message Queue (formerly MNS) effectue de nouvelles tentatives selon la politique configurée. Une fois toutes les tentatives épuisées, Simple Message Queue (formerly MNS) ignore le message et passe au suivant.
Valeurs :
- BACKOFF_RETRY : L'opération d'envoi du message fait l'objet de 3 nouvelles tentatives. L'intervalle entre les tentatives est une valeur aléatoire comprise entre 10 et 20 secondes.
- EXPONENTIAL_DECAY_RETRY : L'opération d'envoi du message fait l'objet de 176 nouvelles tentatives sur une durée totale de 1 jour. L'intervalle de nouvelle tentative augmente de façon exponentielle, passant de 1 seconde à un maximum de 512 secondes. Les intervalles spécifiques sont de 1, 2, 4, 8, 16, 32, 64, 128, 256 et 512 secondes, suivis de 166 nouvelles tentatives avec un intervalle de 512 secondes.

Format du message (NotifyContentFormat)

Définition : Spécifie le format des messages envoyés vers l'endpoint.

Valeurs :

SIMPLIFIED : Le corps du message contient uniquement le contenu publié, sans les attributs du message. Exemple :
```
{1:"a", 2:"b"}
```

JSON : Le corps du message est au format JSON et inclut à la fois le contenu et les attributs. Exemple :

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

XML : Le corps du message est au format XML et inclut à la fois le contenu et les attributs. Exemple :

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

Remarque

Pour les types d'abonnement Short Message Service et mailbox, seul le format de message SIMPLIFIED est pris en charge.