Simple Message Queue (formerly MNS):Primeiros passos com tópicos

Pré-requisitos

Ativar o Simple Message Queue (formerly MNS) e conceder permissões

Criar uma fila

1. Faça login no console do Simple Message Queue (formerly MNS).

2. No painel de navegação à esquerda, escolha Queue Model > Queues.

3. Na barra de navegação superior, selecione uma região.

4. Na página Queues, clique em Create Queue.

5. No painel Create Queue, configure os parâmetros a seguir e clique em OK.

   • Name: Nome da fila.

   • Queue Type: Selecione um tipo de fila.

     • Standard Queue: Envia e consome mensagens normais. A ordem de consumo não é garantida.

     • FIFO Queue: Garante o consumo das mensagens do mesmo grupo na ordem de envio.

   • Maximum Message Length: Comprimento máximo do corpo da mensagem enviada à fila.

   • Long Polling Period: Tempo máximo de espera de uma solicitação ReceiveMessage quando não há mensagens disponíveis na fila. Defina como 0 para desativar o long polling ou use um valor diferente de zero para ativá-lo.

   • Visibility Timeout Period: Período em que a mensagem permanece no estado Inactive após a recuperação da fila. Para mais informações, consulte Visibilidade da mensagem.

   • Message Retention Period: Tempo de vida máximo da mensagem na fila. Após esse período, o sistema exclui a mensagem, independentemente de sua recuperação.

   • Message Delay Period: Tempo de espera antes do consumo de uma mensagem enviada à fila.

   • Enable Logging Feature: Define se o Log Management deve ser ativado. Ao ativar este recurso, o sistema envia automaticamente os logs de operação desta fila para o Logstore especificado. Consulte rastreamentos de mensagens, latência e outras informações nos logs. Para mais detalhes, veja Log Management.

   A fila criada aparece na página Queues.

Criar um tópico

1. Faça login no console do Simple Message Queue (formerly MNS).

2. No painel de navegação à esquerda, escolha Topic Model > Topics.

3. Na barra de navegação superior, selecione uma região.

4. Na página Topics, clique em Create Topic.

5. No painel Create Topic, configure os parâmetros a seguir e clique em OK.

   • Name: Nome do tópico.

   • Topic Type: Selecione um tipo de tópico.

     • Standard Topic: Envia e consome mensagens normais. A ordem de consumo não é garantida.

     • FIFO Topic: Garante o consumo das mensagens do mesmo grupo na ordem de envio.

   • Maximum Message Length: Comprimento máximo do corpo da mensagem enviada ao tópico.

   • Enable Logging Feature: Define se o Log Management deve ser ativado. Ao ativar este recurso, o sistema envia automaticamente os logs de operação deste tópico para o Logstore especificado. Consulte rastreamentos de mensagens, latência e outras informações nos logs. Para mais detalhes, veja Log Management.

   A página Topic Details do tópico é exibida.

Criar uma assinatura

Crie uma assinatura para enviar mensagens do tópico para uma fila.

1. Na página Topics, localize o tópico e, na coluna Actions, clique em View Subscriptions.

2. No painel View Subscriptions For Topic, clique na aba Subscriptions.

3. Na página Subscriptions, clique em Create Subscription.

4. No painel Create Subscription, configure os parâmetros a seguir e clique em OK.

   • Name: Nome da assinatura.

   • Subscription: Tipo de envio. Padrão: HTTP.

   • Receiver Endpoint: Endpoint para entrega de mensagens.

   • Opcional: Message Filtering Tag: Tag para filtragem de mensagens.

   • Retry Policy: Política de nova tentativa para envios de mensagens com falha.

     Políticas de nova tentativa disponíveis:

     • Nova tentativa com backoff

     • Nova tentativa com decaimento exponencial

   • Message Format: Formato das mensagens enviadas ao endpoint.

     Formatos de mensagem disponíveis:

     • SIMPLIFIED

     • JSON

     • XML

   A assinatura criada aparece na página Subscriptions.

Publicar uma mensagem

Publique uma mensagem em um tópico. O sistema enviará a mensagem para a fila inscrita.

1. Na página Topics, localize o tópico e, na coluna Actions, clique em Publish Message.

2. Na página Publish Message To Topic, configure os parâmetros a seguir e clique em Publish Message.

   • Message Content: Corpo da mensagem a publicar.

   • (Opcional) Message Tag: Tag para filtragem de mensagens.

   • Subscription Type: Tipo de assinatura de destino. Este exemplo usa uma fila.

   A mensagem "Message sent successfully" é exibida.

Receber uma mensagem

Recupere a mensagem publicada da fila para verificar a entrega.

1. Na página Queues, localize a fila e, na coluna Action, escolha More > Send Messages.

2. Opcional: Na página Send/Receive Messages For Queue, na seção Receive Message, clique em Edit Parameters of Receiving Messages. No painel Edit Parameters of Receiving Messages, configure Receive Times e Polling Period e clique em OK.

3. Na página Send/Receive Messages For Queue, na seção Receive Message, clique em Receive Message.

   As mensagens da fila aparecem na seção Receive Message.

4. Opcional: Na lista de mensagens, localize a mensagem e, na coluna Actions, clique em Details. Na caixa de diálogo Message Details, visualize o corpo da mensagem e outras informações.

Excluir a fila

1. Na página Queues, localize a fila e, na coluna Actions, escolha More > Delete.

2. Na caixa de diálogo Prompt, leia as informações e clique em OK.

   A fila é removida da página Queues.

Excluir o tópico

1. Na página Topics, localize o tópico e, na coluna Actions, escolha More > Delete.

2. Na caixa de diálogo Prompt, leia as informações e clique em OK.

   O tópico é removido da página Topic List.

   Aviso

   A exclusão de um tópico remove permanentemente todos os seus dados.