Identificateurs de files d'attente et de messages Amazon SQS - Amazon Simple Queue Service

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Identificateurs de files d'attente et de messages Amazon SQS

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 laRé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'attentequi 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 la.fifosuffixe. Le suffixe compte dans le quota de noms de file d'attente de 80 caractères. Pour déterminer si une file d'attente estFIFO, vous pouvez vérifier si le nom de la file d'attente 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, consultez ListQueues.

ID de message

Chaque message reçoit un système attribuéID de messagequ'Amazon SQS vous renvoie dans leSendMessageré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=

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

Pour plus d'informations sur les identifiants suivants, consultezTraitement en une seule foiset l'Référence d'API Amazon Simple Queue Service.

ID de déduplication du message

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 ID de déduplication de message sont acceptés avec succès, mais ne sont pas livrés pendant l'intervalle de déduplication de 5 minutes.

ID de groupe de messages

La balise spécifiant 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 (cependant, les messages appartenant à différents groupes de messages peuvent être traités hors d'ordre).

Numéro de séquence

Nombre important et non consécutif qu'Amazon SQS attribue à chaque message.