MNS subscription definition, model, and properties - Simple Message Queue (formerly MNS): Central de Documentação do Alibaba Cloud

As assinaturas definem como os consumidores recebem mensagens dos tópicos no Simple Message Queue (formerly MNS).

Definição e relação do modelo

No Simple Message Queue (formerly MNS), a assinatura é uma regra que o consumidor registra em um tópico para receber mensagens. Associe um tópico a uma ou mais assinaturas para personalizar as regras de push e os destinos de entrega.

A figura a seguir ilustra como as assinaturas se integram ao modelo de mensagens do Simple Message Queue (formerly MNS).

Recursos

Diversos tipos de assinatura: Um tópico pode ter várias assinaturas. Cada uma corresponde a um tipo diferente de endpoint.
Múltiplas assinaturas para mensagens: É possível associar várias assinaturas a um único tópico. Dessa forma, cada assinatura recebe todas as mensagens publicadas nele.

Propriedades da assinatura

Nome da assinatura

Definição: Identifica a assinatura. Deve ser exclusivo por assinante e tópico.
Valor: String de até 255 caracteres. O nome deve começar com uma letra e pode conter letras, dígitos e hifens (-).

Tipo de assinatura

Definição: Tipo de endpoint que assina as mensagens.
Valores: Fila, serviço HTTP, Short Message Service, Direct Mail e Mobile Push. Tipos de assinatura.

Nota

Os limites de taxa de push (TPS) variam conforme o tipo de assinatura:

Assinatura de fila padrão: Limite de push de 20.000 TPS.
Assinatura de serviço HTTP(S): Limite de push de 2.000 TPS.

Exceder esses limites aciona o throttling, o que pode atrasar a entrega das mensagens. Para aumentar os limites, envie um ticket.

Endpoint

Definição: Endpoint que recebe as mensagens.
Valor:
- Se o Subscription type estiver definido como HTTP, insira um endereço HTTP que comece com http:// ou https://.
- Caso o Subscription type seja fila, insira o nome da fila.
- Quando o Subscription type for Short Message Service, insira o número de telefone.
- Para o Subscription type configurado como caixa de correio, insira o endereço de e-mail.
- Se o Subscription type estiver definido como terminal móvel, insira a AppKey.

Tag de filtragem de mensagens

Definição: Tag utilizada para filtrar as mensagens entregues a esta assinatura. Filtragem de mensagens.
Valor: String de até 16 caracteres. Atualmente, há suporte para apenas uma tag.

Política de nova tentativa (NotifyStrategy)

Definição: Especifica a política de nova tentativa quando falha o push de uma mensagem para o endpoint. Em caso de falha, o Simple Message Queue (formerly MNS) tenta novamente com base na política definida. Após esgotar todas as tentativas, o Simple Message Queue (formerly MNS) descarta a mensagem e passa para a próxima.
Valores:
- BACKOFF_RETRY: O sistema tenta enviar a mensagem 3 vezes. O intervalo entre as tentativas é um valor aleatório entre 10 e 20 segundos.
- EXPONENTIAL_DECAY_RETRY: O push da mensagem é tentado 176 vezes durante um período total de 1 dia. O intervalo aumenta exponencialmente de 1 segundo até o máximo de 512 segundos. Os intervalos específicos são 1, 2, 4, 8, 16, 32, 64, 128, 256 e 512 segundos, seguidos por 166 tentativas com intervalo fixo de 512 segundos.

Formato da mensagem (NotifyContentFormat)

Definição: Determina o formato das mensagens enviadas ao endpoint.

Valores:

SIMPLIFIED: O corpo da mensagem contém apenas o conteúdo publicado, sem atributos. Exemplo:
```
{1:"a", 2:"b"}
```

JSON: O corpo da mensagem está no formato JSON e inclui tanto o conteúdo quanto os 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 inclui tanto o conteúdo quanto os 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>

Nota

Para os tipos de assinatura Short Message Service e caixa de correio, há suporte apenas para o formato de mensagem SIMPLIFIED.