Identifiants de files d'attente et de messages Amazon SQS

Cette section décrit les identifiants des files d'attentes 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

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 les autres composants Amazon SQS. Chaque fois que vous souhaitez effectuer une action au niveau d'une file d'attente, vous devez fournir cette URL.

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 ID de message attribué par le système qu'Amazon SQS vous renvoie dans la réponse SendMessage. Cet identifiant est utile pour identifier les messages. 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=