Identificadores de mensagens e filas do Amazon SQS - Amazon Simple Queue Service

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Identificadores de mensagens e filas do Amazon SQS

Esta seção descreve os identificadores de filas padrão e FIFO. Esses identificadores podem ajudar a localizar e manipular filas e mensagens específicas.

Identificadores de filas padrão do Amazon SQS

Para obter mais informações sobre os seguintes identificadores, consulte a Referência da API do Amazon Simple Storage Service.

Nome e URL da fila

Ao criar uma nova fila, você deve especificar o nome de uma fila exclusivo para sua conta e região da AWS . O Amazon SQS atribui a cada fila que você cria um identificador chamado URL da fila, que inclui o nome da fila e outros componentes do Amazon SQS. Sempre que você desejar executar uma ação em uma fila, forneça o URL da fila.

O seguinte URL é de uma fila chamada MyQueue, de propriedade de um usuário com o número de conta da AWS 123456789012.

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

É possível recuperar o URL de uma fila programaticamente listando as filas e analisando a string que segue o número da conta. Para ter mais informações, consulte ListQueues.

ID de mensagem

Cada mensagem recebe um ID da mensagem atribuído pelo sistema que o Amazon SQS retorna para você na resposta SendMessage. Esse identificador é útil para identificar mensagens. O tamanho máximo de um ID de mensagem é 100 caracteres.

Identificador de recebimento

Toda vez que você recebe uma mensagem de uma fila, recebe um identificador de recebimento dessa mensagem. Esse identificador é associado à ação de recebimento da mensagem, e não à mensagem. Para excluir a mensagem ou alterar a visibilidade da mensagem, você deve fornecer o identificador de recebimento (não o ID de mensagem). Desse modo, você sempre deve receber uma mensagem antes de excluí-la (você não pode colocar uma mensagem na fila e, em seguida, recuperá-la). O tamanho máximo de um identificador de recebimento é 1024 caracteres.

Importante

Se você receber uma mensagem mais de uma vez, cada vez que recebê-la, obterá um identificador de recebimento diferente. Você deve fornecer o identificador de recebimento recebido mais recentemente ao solicitar a exclusão da mensagem (caso contrário, a mensagem pode não ser excluída).

Veja a seguir um exemplo de um identificador de recebimento (quebrado em três linhas).

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