Simple Message Queue (formerly MNS):Operações de tópicos

Pré-requisitos

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

Criar um tópico

1. Faça login no console do Simple Message Queue (antigo 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 o 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: tamanho máximo do corpo da mensagem enviado ao tópico.

   • Enable Logging Feature: define se o Gerenciamento de Logs deve ser ativado. Ao ativar esse 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 Gerenciamento de Logs.

   O sistema redireciona você para a página Topic Details do tópico.

Editar um tópico

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

2. No painel Edit Topic Parameter, modifique a configuração do tópico e clique em OK.

   A configuração atualizada do tópico aparece na seção Basic Information da página Topic Details.

Localizar tópicos

1. Na página Topics, insira um prefixo do nome do tópico (como test) na caixa de pesquisa e clique no ícone .

   A lista exibe todos os tópicos cujos nomes começam com test.

Visualizar detalhes do tópico

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

2. A página Topic Details apresenta informações detalhadas sobre o tópico.

Obter endpoints

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

2. Na página Topic Details, na seção Endpoint, localize os endpoints de Internet Access e Internal Access.

   Nota

   Os endpoints suportam acesso via HTTP e HTTPS.

Criar uma assinatura

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

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

3. No painel de navegação à esquerda, escolha Topic Model > Subscriptions.

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

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

   • Topic Name: selecione o tópico ao qual esta assinatura pertence.

   • Subscription Name: nome da assinatura. Deve começar com uma letra, pode conter letras, dígitos e hifens (-), e não deve exceder 255 caracteres.

   • Subscription: tipo de push da assinatura. O valor padrão é HTTP. Para mais informações, consulte Tipos de assinatura.

   • Receiver Endpoint: endereço do endpoint do receptor.

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

   • Retry Policy: política de nova tentativa aplicada quando o push da mensagem falha ao alcançar o endpoint.

     Políticas de nova tentativa disponíveis:

     • BACKOFF_RETRY: realiza três novas tentativas em intervalos aleatórios de 10 a 20 segundos.

     • DECAY_RETRY: realiza 176 novas tentativas. O intervalo entre tentativas aumenta exponencialmente até 512 segundos, totalizando um dia de duração. Os intervalos específicos são: 1, 2, 4, 8, 16, 32, 64, 128, 256, 512, 512, ..., 512 (totalizando 167 novas tentativas com intervalos de 512 segundos).

   • Message Format: formato das mensagens enviadas ao endpoint.

     • SIMPLIFIED: o corpo da mensagem contém apenas o conteúdo publicado pelo usuário, sem atributos. Exemplo:

       {1:"a", 2:"b"}

     • JSON: o corpo da mensagem está no formato JSON e contém tanto o conteúdo quanto seus atributos. Exemplo:

       {
           "TopicOwner":"TopicOwner",
           "TopicName":"TopicName",
           "Subscriber":"Subscriber",
           "SubscriptionName":"SubscriptionName",
           "MessageId":"6CC4D900CA59A2CD-1-15180534A8F-20000****",
           "Message":"xxxxx",
           "MessageMD5":"F1E92841751D795AB325861034B5****",
           "MessageTag":"important",
           "PublishTime":"1449556920975"
       }

     • XML: o corpo da mensagem está no formato XML e contém tanto o conteúdo quanto seus atributos. Exemplo:

       <?xml version="1.0" encoding="utf-8"?>
           <Notification xlmns="http://mns.aliyuncs.com/doc/v1/">
               <TopicOwner>TopicOwner</TopicOwner>
               <TopicName>TopicName</TopicName>
               <Subscriber>Subscriber</Subscriber>
               <SubscriptionName>SubscriptionName</SubscriptionName>
               <MessageId>6CC4D900CA59A2CD-1-15180534A8F-20000****</MessageId>
               <Message>{1:"a", 2:"b"}</Message>
               <MessageMD5>F1E92841751D795AB325861034B5****</MessageMD5>
               <MessageTag>important</MessageTag>
               <PublishTime>1449556920975</MessagePublishTime>
           </Notification>

   A nova assinatura aparece na página Subscriptions.

Editar uma assinatura

1. Na página Subscriptions, localize a assinatura desejada e clique em Edit na coluna Actions.

2. No painel Edit Subscription Parameter, modifique a política de nova tentativa e clique em OK.

Localizar assinaturas

1. Na página Subscriptions, insira um prefixo do nome da assinatura (como test) na caixa de pesquisa e clique no ícone .

   A lista exibe todas as assinaturas cujos nomes começam com test.

Publicar uma mensagem

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

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

   • Message Content: corpo da mensagem.

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

   • Subscription Type: tipo de assinatura para o qual a mensagem será enviada. Para mais informações, consulte Tipos de assinatura.

   Uma notificação "Mensagem enviada com sucesso" aparece na página.

Visualizar métricas do tópico

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

2. Na seção Cloud Monitor da página Topic Details, visualize as métricas de monitoramento do tópico.

   Nota

   Para mais informações sobre regras de alerta, consulte Criar uma regra de alerta.

Excluir uma assinatura

1. Na página Subscriptions, localize a assinatura desejada. Na coluna Actions, clique em Delete.

2. Na caixa de diálogo Prompt, leia a mensagem e clique em OK.

   A assinatura é removida da página Subscriptions.

Excluir um tópico

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

2. Na caixa de diálogo Prompt, leia a mensagem e clique em OK.

   O tópico é removido da página Topics.

   Aviso

   Após a exclusão de um tópico, seus dados não podem ser recuperados.