:QueueMessage

Paramètres

• MessageId

  • Identifiant du message.

  • Ce paramètre est renvoyé lors de l'appel aux opérations SendMessage, BatchSendMessage, ReceiveMessage, BatchReceiveMessage, PeekMessage ou BatchPeekMessage.

  • Chaque message d'une file d'attente possède un identifiant unique.

  • Lorsque vous envoyez un message à une file d'attente, SMQ génère un identifiant pour ce message. Une fois généré, cet identifiant est immuable. Utilisez-le pour vérifier l'intégrité des données.

• NextVisibleTime

  • Instant auquel le message devient consommable. Cette valeur correspond à un horodatage UNIX indiquant le nombre de millisecondes écoulées depuis le 1er janvier 1970 à 00:00:00 UTC (époque Unix).

  • Ce paramètre est renvoyé lors de l'appel aux opérations ReceiveMessage, BatchReceiveMessage ou ChangeMessageVisibility.

• ReceiptHandle

  • Jeton de réception du message.

  • Ce paramètre est renvoyé lors de l'appel aux opérations ReceiveMessage, BatchReceiveMessage ou ChangeMessageVisibility.

  • Utilisez le jeton de réception pour modifier ou supprimer un message à l'état Inactive. Le jeton reste valide jusqu'à l'instant défini par le paramètre NextVisibleTime. Si vous utilisez le jeton après cet instant, SMQ renvoie l'erreur MessageNotExist.

  • Chaque jeton de réception est utilisable une seule fois. Il expire dès que l'état du message associé change.

• MessageBody

  • Corps du message.

  • Ce paramètre est renvoyé lors de l'appel aux opérations ReceiveMessage, BatchReceiveMessage, PeekMessage ou BatchPeekMessage.

• MessageBodyMD5

  • Empreinte MD5 du corps du message.

  • Ce paramètre est renvoyé lors de l'appel aux opérations SendMessage, BatchSendMessage, ReceiveMessage, BatchReceiveMessage, PeekMessage ou BatchPeekMessage.

• EnqueueTime

  • Instant d'envoi du message dans la file d'attente. Cette valeur correspond à un horodatage UNIX indiquant le nombre de millisecondes écoulées depuis le 1er janvier 1970 à 00:00:00 UTC (époque Unix).

  • Ce paramètre est renvoyé lors de l'appel aux opérations ReceiveMessage, BatchReceiveMessage, PeekMessage ou BatchPeekMessage.

• FirstDequeueTime

  • Instant de la première consommation du message. Cette valeur correspond à un horodatage UNIX indiquant le nombre de millisecondes écoulées depuis le 1er janvier 1970 à 00:00:00 UTC (époque Unix).

  • Ce paramètre est renvoyé lors de l'appel aux opérations ReceiveMessage, BatchReceiveMessage, PeekMessage ou BatchPeekMessage.

  • Si le message n'a jamais été consommé, la valeur de ce paramètre est identique à celle du paramètre EnqueueTime.

• DequeueCount

  • Nombre total de tentatives de consommation du message.

  • Ce paramètre est renvoyé lors de l'appel aux opérations ReceiveMessage, BatchReceiveMessage, PeekMessage ou BatchPeekMessage.

• Priority

  • Priorité du message. Valeurs possibles : de 1 à 16. La valeur 1 représente la priorité la plus élevée.

  • Ce paramètre est renvoyé lors de l'appel aux opérations ReceiveMessage, BatchReceiveMessage, PeekMessage ou BatchPeekMessage.

  • Si une file d'attente contient des messages de priorités différentes, les messages prioritaires sont consommés en premier lors de l'appel à l'opération ReceiveMessage.

  • SMQ ne garantit pas l'ordre de consommation des messages en raison du cloisonnement des données (data striping).

Types de messages

Delayed messages

État des messages

• Lorsqu'un message standard est envoyé à une file d'attente standard, il se trouve à l'état Active. Après réception, il passe à l'état Inactive. Il y reste pendant la durée définie par le paramètre VisibilityTimeout. S'il n'est pas consommé durant cette période, il revient à l'état Active. S'il est supprimé durant cette période, il passe à l'état Deleted.

• Lorsqu'un message standard est envoyé à une file d'attente différée, il se trouve à l'état Delayed. À l'issue de la période définie par le paramètre DelaySeconds, le message passe à l'état Active.

• Lorsqu'un message différé est envoyé à une file d'attente, il se trouve à l'état Delayed. À l'issue de la période définie par le paramètre DelaySeconds, le message passe à l'état Active.

• La durée maximale de conservation d'un message dans une file d'attente est définie par le paramètre MessageRetentionPeriod. Une fois cette période écoulée, le message passe à l'état Expired, puis est recyclé par le ramasse-miettes (garbage collector).

• Seuls les messages à l'état Active peuvent être reçus.