Criar uma fila FIFO do Amazon SQS e enviar uma mensagem

Você pode criar uma fila FIFO do Amazon SQS e enviar mensagens usando o console. Este tópico explica como configurar parâmetros de fila, incluindo tempo limite de visibilidade, retenção de mensagens e desduplicação, seguindo as melhores práticas de segurança, como evitar informações confidenciais em nomes de filas e ativar a criptografia no lado do servidor. Também abrange a definição de políticas de acesso, a configuração de filas de mensagens sem saída e o envio de mensagens com atributos específicos do FIFO, como ID do grupo de mensagens e ID de desduplicação.

Criar uma fila

É possível usar o console do Amazon SQS para criar filas FIFO. O console fornece valores padrão para todas as configurações, exceto para o nome da fila.

Importante

Em 17 de agosto de 2022, a criptografia do lado do servidor (SSE) padrão foi aplicada a todas as filas do Amazon SQS.

Não inclua informações de identificação pessoal (PII) nem outras informações confidenciais ou sigilosas em nomes de filas. Os nomes das filas podem ser acessados por muitos Amazon Web Services, incluindo faturamento e CloudWatch registros. Os nomes de filas não devem ser usados para dados privados ou sigilosos.

Para criar uma fila FIFO do Amazon SQS

1. Abra o console do Amazon SQS em. https://console.aws.amazon.com/sqs/

2. Selecione Criar fila.

3. Para o tipo, a fila do tipo padrão é definida por padrão. Para criar uma fila FIFO, escolha FIFO.

   nota

   Não é possível alterar o tipo de uma fila depois de criá-la.

4. Insira um Name (Nome) para a fila.

   O nome de uma fila FIFO deve terminar com o sufixo .fifo. O sufixo conta para a cota de 80 caracteres do nome da fila. Para determinar se uma fila é FIFO, você pode conferir se o nome da fila termina com o sufixo.

5. (Opcional) O console define valores padrão para os parâmetros de configuração da fila. Em Configuration (Configuração), você pode definir novos valores para os seguintes parâmetros:

   1. Em Visibility timeout (Tempo limite de visibilidade), insira a duração e as unidades. O intervalo é de 0 segundo a 12 horas. O valor padrão de é 30 segundos.

   2. Em Message retention period (Período de retenção de mensagens), insira a duração e as unidades. O intervalo é de 1 minuto a 14 dias. O valor padrão é 4 dias.

   3. Em Delivery delay (Atraso de entrega), insira a duração e as unidades. O intervalo é de 0 segundo a 15 minutos. O valor de padrão é 0 segundos.

   4. Em Maximum message size (Tamanho máximo da mensagem), insira um valor. O intervalo é de 1 KB a 256 KB. O valor padrão é 256 KB.

   5. Em Receive message wait time (Tempo de espera da mensagem), insira um valor. O intervalo é de 0 a 20 segundos. O valor padrão é 0 segundo, o que define uma sondagem curta. Qualquer valor diferente de zero define uma sondagem longa.

   6. Para uma fila FIFO, escolha Content-based deduplication (Eliminação de duplicação baseada em conteúdo) para habilitar a eliminação de duplicação baseada em conteúdo. Por padrão, essa configuração está desabilitada.

   7. (Opcional) Em uma fila FIFO, para habilitar um throughput mais alto a fim de enviar e receber mensagens na fila, escolha Enable high throughput FIFO (Habilitar FIFO de alto throughput).

      Escolher esta opção altera as opções relacionadas (Deduplication scope [Escopo de eliminação de duplicação] e FIFO throughput limit [Limite de transferência FIFO]) para as configurações necessárias a fim de habilitar a alta taxa de transferência para filas FIFO. Se você alterar qualquer uma das configurações necessárias para usar FIFO de alta taxa de transferência, a taxa de transferência normal permanecerá em vigor para a fila e a eliminação de duplicação ocorrerá conforme especificado. Para ter mais informações, consulte Throughput alto para filas FIFO no Amazon SQS e Cotas de mensagens do Amazon SQS.

6. (Opcional) Defina uma política de acesso. A política de acesso define as contas, usuários e funções que podem acessar a fila. A política de acesso também define as ações (como SendMessage, ReceiveMessage ou DeleteMessage) que os usuários podem acessar. A política padrão permite que apenas o proprietário da fila envie e receba mensagens.

   Para definir a política de acesso, realize um dos seguintes procedimentos:

   • Escolha Basic (Básico) para configurar quem pode enviar mensagens para a fila e quem pode receber mensagens dela. O console cria a política com base em suas escolhas e exibe a política de acesso resultante no painel JSON somente leitura.

   • Escolha Advanced (Avançado) para modificar a política de acesso JSON diretamente. Isso permite que você especifique um conjunto personalizado de ações que cada entidade (conta, usuário ou função) pode executar.

7. Em Redrive allow policy (Política de permissão de redirecionamento), escolha Enabled (Habilitada). Selecione uma das seguintes opções: Allow all (Permitir tudo), By queue (Por fila) ou Deny all (Negar tudo). Ao escolher By queue (Por fila), especifique uma lista de até 10 filas de origem pelo nome do recurso da Amazon (ARN).

8. O Amazon SQS fornece criptografia do lado do servidor gerenciada por padrão. Para escolher um tipo de chave de criptografia ou desabilitar a criptografia do lado do servidor gerenciada pelo Amazon SQS, expanda Encryption (Criptografia). Para obter mais informações sobre os tipos de chave de criptografia, consulte Configurar a criptografia do lado do servidor para uma fila usando chaves de criptografia gerenciadas pelo SQS e Configurar a criptografia do lado do servidor para uma fila usando o console do Amazon SQS.

   nota

   Com a SSE habilitada, as solicitações anônimas SendMessage e ReceiveMessage à fila criptografada serão rejeitadas. As práticas recomendadas de segurança do Amazon SQS não aconselham o uso de solicitações anônimas. Se você quiser enviar solicitações anônimas a uma fila do Amazon SQS, desabilite o SSE.

9. (Opcional) Para configurar uma fila de mensagens mortas para receber mensagens que não podem ser entregues, expanda Dead-letter queue (Fila de mensagens mortas).

10. (Opcional) Para adicionar tags à fila, expanda Tags.

11. Selecione Criar fila. O Amazon SQS cria a fila e exibe a página Details (Detalhes) da fila.

O Amazon SQS propaga as informações sobre a nova fila pelo sistema. Como o Amazon SQS é um sistema distribuído, você pode enfrentar um pequeno atraso antes que o console exiba a fila na página Queues (Filas).

Depois de criar uma fila, você pode enviar mensagens para ela e receber e excluir mensagens. Você também pode editar qualquer uma das definições de configuração de fila, exceto o tipo de fila.

Enviar uma mensagem

Depois de criar sua fila, você pode enviar uma mensagem para ela.

1. No painel de navegação à esquerda, escolha Queues (Filas). Na lista de filas, selecione a fila que você criou.

2. Em Actions (Ações), escolha Send and receive messages (Enviar e receber mensagens).

   O console exibe a página Send and receive messages (Enviar e receber mensagens).

3. Em Message (Mensagem), insira o texto da mensagem.

4. Para uma fila First-In-First-Out (FIFO), insira uma ID do grupo de mensagens. Para obter mais informações, consulte Lógica de entrega de filas FIFO no Amazon SQS.

5. (Opcional) Para uma fila FIFO, você pode inserir um ID de eliminação de duplicação de mensagens. Se você habilitou a eliminação de duplicação baseada em conteúdo para a fila, o ID de eliminação de duplicação de mensagens não será necessário. Para obter mais informações, consulte Lógica de entrega de filas FIFO no Amazon SQS.

6. As filas FIFO não são compatíveis com temporizadores em mensagens individuais. Para obter mais informações, consulte Temporizadores de mensagens do Amazon SQS.

7. Escolha Send Message (Enviar mensagem).

   Quando a mensagem é enviada, o console exibe uma mensagem de sucesso. Escolha View details (Visualizar os detalhes) para exibir informações sobre a mensagem enviada.