Rubrique Amazon SQS et identifiants de message

Cette section décrit les identifiants des files d'attente standard et FIFO. Ces identifiants peuvent vous aider à trouver et à manipuler des files d'attente et des messages spécifiques.

Identifiants pour les files d'attente Amazon SQS Standard et FIFO

Pour plus d'informations sur les identifiants suivants, consultez la référence d'API Amazon Simple Queue Service.

Nom et URL de la file d'attente

Lorsque vous créez une file d'attente, vous devez indiquer un nom unique pour le compte et la région AWS. Amazon SQS attribue à chaque file d'attente que vous créez un identifiant appelé URL de file d'attente qui inclut le nom de la file d'attente et d'autres composants Amazon SQS. Chaque fois que vous souhaitez effectuer une action au niveau d'une file d'attente, vous devez fournir cette URL.

Le nom d'une file d'attente FIFO doit se terminer par le.fifo suffixe. Le suffixe est pris en compte dans le quota de noms de file d'attente de 80 caractères. Pour déterminer si une file d'attente est FIFO, vous pouvez vérifier si le nom de la file se termine par le suffixe.

L'URL suivante est celle d'une file d'attente nommée MyQueue, qui appartient à un utilisateur dont le numéro de compte AWS est 123456789012.

https://sqs.us-east-2.amazonaws.com/123456789012/MyQueue

Vous pouvez extraire l'URL d'une file d'attente par programmation en listant vos files d'attente et en analysant la chaîne qui suit le numéro de compte. Pour plus d'informations, veuillez consulter ListQueues.

ID de message

Chaque message reçoit un identifiant de message attribué par le système qu'Amazon SQS vous renvoie dans laSendMessage réponse. Cet identifiant est utile pour identifier les messages. (Cependant, vous avez besoin du descripteur de réception d'un message pour le supprimer.) La longueur maximale d'un ID de message est de 100 caractères.

Descripteur de réception

Chaque fois que vous recevez un message d'une file d'attente, vous recevez un descripteur de réception correspondant. Cette gestion est associée à la réception du message, et non au message lui-même. Pour supprimer le message ou pour en modifier la visibilité, vous devez fournir le descripteur de réception (et non l'ID du message). C'est pourquoi vous devez toujours recevoir un message avant de pouvoir le supprimer (vous ne pouvez pas placer un message dans la file d'attente, puis le rappeler). La longueur maximale d'un descripteur de réception est de 1 024 caractères.

Important

Si vous recevez un message plusieurs fois, chaque fois que vous le recevez, vous obtenez un descripteur de réception différent. Lorsque vous demandez la suppression du message, vous devez fournir le descripteur de réception le plus récent. Dans le cas contraire, la suppression peut ne pas fonctionner.

Voici un exemple de descripteur de réception (réparti sur trois lignes).

MbZj6wDWli+JvwwJaBV+3dcjk2YW2vA3+STFFljTM8tJJg6HRG6PYSasuWXPJB+Cw
Lj1FjgXUv1uSj1gUPAWV66FU/WeR4mq2OKpEGYWbnLmpRCJVAyeMjeU5ZBdtcQ+QE
auMZc8ZRv37sIW2iJKq3M9MFx1YvV11A2x/KSbkJ0=

Identifiants supplémentaires pour les files d'attente FIFO Amazon SQS

Pour plus d'informations sur les identificateurs suivants, consultez le GuideTraitement en une seule fois de référence de l'API Amazon Simple Queue Service.

ID de déduplication du message

Le jeton utilisé pour la déduplication des messages envoyés. Si un message avec un ID de déduplication de message particulier est envoyé avec succès, tous les messages envoyés avec le même identifiant de déduplication des messages sont acceptés avec succès mais ne sont pas remis pendant l'intervalle de déduplication de 5 minutes.

ID de groupe de messages

La balise qui spécifie qu'un message appartient à un groupe de messages spécifique. Les messages appartenant au même groupe de messages sont toujours traités un à la fois, dans un ordre strict par rapport au groupe de messages (toutefois, les messages appartenant à des groupes de messages différents peuvent être traités dans le désordre).

Numéro de séquence

Le grand nombre non consécutif qu'Amazon SQS attribue à chaque message.