Utilisation de l'attribut de message de time-to-live (TTL) Amazon SNS pour les notifications push mobile

Amazon Simple Notification Service (Amazon SNS) prend en charge la définition d'un attribut de message de time-to-live (TTL) pour les messages de notification push mobile. Cela s'ajoute à la capacité existante de définir le TTL dans le corps du message Amazon SNS pour les services de notification push mobiles qui le prennent en charge, tels qu'Amazon Device Messaging (ADM) et Firebase Cloud Messaging (FCM) lors de l'envoi vers Android.

L'attribut de message TTL est utilisé pour spécifier des métadonnées d'expiration relatives à un message. Cela vous permet d'indiquer le temps mis par le service de notification push, tel qu'Apple Push Notification Service (APNs) ou FCM, pour diffuser le message au point de terminaison. Si, pour une raison quelconque (telle que la mise hors tension de l'appareil mobile), le message ne peut pas être diffusé dans la durée de vie spécifiée, il est supprimé et aucune autre tentative de diffusion n'est effectuée. Pour spécifier le TTL dans les attributs des messages, vous pouvez utiliser les AWS Management Console kits de développement AWS logiciel (SDK) ou l'API de requête.

Attributs de message TTL pour les services de notification push

Voici une liste des attributs de message TTL pour les services de notification push que vous pouvez utiliser pour définir lors de l'utilisation des AWS SDK ou de l'API de requête :

Service de notification push	Attribut de message TTL
Amazon Device Messaging (ADM)	AWS.SNS.MOBILE.ADM.TTL
Apple Push Notification service (APNs).	AWS.SNS.MOBILE.APNS.TTL
Apple Push Notification Service Sandbox (APNs_SANDBOX)	AWS.SNS.MOBILE.APNS_SANDBOX.TTL
Baidu Cloud Push (Baidu)	AWS.SNS.MOBILE.BAIDU.TTL
Firebase Cloud Messaging (FCM lors de l'envoi vers Android)	AWS.SNS.MOBILE.FCM.TTL
Services de notification push Windows (WNS)	AWS.SNS.MOBILE.WNS.TTL

Chacun des services de notification push gère la durée de vie différemment. Amazon SNS fournit une vue abstraite de la durée de vie pour tous les services de notification push, ce qui facilite la spécification de la durée de vie. Lorsque vous utilisez le AWS Management Console pour spécifier le TTL (en secondes), vous ne devez saisir la valeur TTL qu'une seule fois et Amazon SNS calculera ensuite le TTL pour chacun des services de notification push sélectionnés lors de la publication du message.

La durée de vie est relative à l'heure de publication. Avant de remettre un message de notification push à un service de notification push spécifique, Amazon SNS calcule la durée de conservation (la durée entre l'horodatage de publication et juste avant sa remise à un service de notification push) pour la notification push et transmet la durée de vie restante au service de notification push spécifique. Si la durée de vie est inférieure à la durée de conservation, Amazon SNS ne tente pas d'effectuer la publication.

Si vous spécifiez un TTL pour un message de notification push, la valeur TTL doit être un entier positif, sauf si la valeur de 0 a une signification spécifique pour le service de notification push, comme dans le cas des APN et du FCM (lors de l'envoi vers Android). Si la valeur de durée de vie est définie sur0 et que le service de notification push n'a pas de signification spécifique pour 0, Amazon SNS supprime le message. Pour plus d'informations sur la définition du paramètre de durée de vie sur 0 lors de l'utilisation d'APNs, consultez le Tableau A-3 Identificateurs d'élément pour les notifications à distance dans la documentation Binary Provider API.

Ordre de priorité pour déterminer la durée de vie

La priorité utilisée par Amazon SNS pour déterminer la durée de vie pour un message de notification push se fonde sur l'ordre suivant, où le plus petit nombre a la priorité la plus élevée :

1. Durée de vie de l'attribut de message

2. Durée de vie du corps du message

3. Durée de vie par défaut du service de notification push (varie selon le service)

4. Durée de vie par défaut d'Amazon SNS (4 semaines)

Si vous définissez des valeurs de durée de vie différentes (une dans les attributs de message et une autre dans le corps du message) pour le même message, Amazon SNS modifie la durée de vie dans le corps du message pour qu'elle corresponde à celle spécifiée dans l'attribut du message.

Spécifier le TTL à l'aide du AWS Management Console

1. Connectez-vous à la console Amazon SNS.

2. Dans le panneau de navigation, choisissez Mobile, Notifications Push.

3. Sur la page Notifications Push mobile, dans la section Applications de plateforme, sélectionnez une application.

4. Sur la MyApplicationpage, dans la section Points de terminaison, choisissez un point de terminaison d'application, puis choisissez Publier le message.

5. Dans la section Détails du message, saisissez la valeur de la durée de vie (la durée, en secondes, pendant laquelle le service de notification push doit diffuser le message au point de terminaison).

6. Choisissez Publier le message.