Tópicos do sistema na Grade de Eventos do Azure

  • Artigo

O tópico da Grade de Eventos fornece um ponto de extremidade em que a fonte envia eventos. O editor cria o tópico da Grade de Eventos e decide se uma origem do evento precisa de um tópico ou mais de um tópico. Um tópico é usado para uma coleção de eventos relacionados. Para reagir a determinados tipos de evento, os assinantes decidem quais tópicos assinar.

Os tópicos personalizados são tópicos de aplicativo e de terceiros. Quando criar ou receber acesso a um tópico personalizado, você verá o tópico personalizado na assinatura. Os tópicos personalizados dão suporte à entrega push. Consulte quando usar a entrega push ou pull para ajudar a decidir se a entrega push é a abordagem certa, considerando seus requisitos.

Quando você projeta seu aplicativo, tem precisa decidir quantos tópicos devem ser criados. Para soluções relativamente grandes, crie um tópico personalizado para cada categoria de eventos relacionados. Por exemplo, considere um aplicativo que gerencia contas de usuário e outro aplicativo sobre pedidos de clientes. É improvável que todos os assinantes de eventos queiram receber eventos dos dois aplicativos. Para separar as preocupações, crie dois tópicos: um para cada aplicativo. Permita que os manipuladores de eventos assinem o tópico de acordo com os respectivos requisitos. Para soluções pequenas, você pode preferir enviar todos os eventos para um único tópico. Assinantes de evento podem filtrar par os tipos de evento que desejam.

Esquema do evento

Os tópicos personalizados dão suporte a dois tipos de esquemas de eventos: eventos de Nuvem e esquema da Grade de Eventos.

Esquema de evento de nuvem

Além do seu esquema de evento padrão, a Grade de Eventos do Azure oferece suporte nativo a eventos na implementação JSON do CloudEvents v1.0 e ligação ao protocolo HTTP. CloudEvents é uma especificação aberta para descrever dados de eventos.

O CloudEvents simplifica a interoperabilidade, fornecendo um esquema comum para publicação e consumo de eventos. Esse esquema permite ferramentas uniformes, maneiras padrão de roteamento e manipulação de eventos e uma maneira comum de desserializar seus eventos. Com um esquema comum, você pode integrar facilmente mais trabalho entre plataformas.

Observação

Para saber mais, confira Esquema de evento de Nuvem.

Esquema de eventos da Grade de Eventos

Ao usar o esquema de evento da Grade de Eventos, você pode especificar propriedades específicas do aplicativo no objeto data.

[
  {
    "topic": string,
    "subject": string,
    "id": string,
    "eventType": string,
    "eventTime": string,
    "data":{
      object-unique-to-each-publisher
    },
    "dataVersion": string,
    "metadataVersion": string
  }
]

Observação

Para saber mais, confira Esquema de evento da Grade de Eventos.

As seções a seguir fornecem links para tutoriais para criar tópicos personalizados usando os modelos portal do Azure, CLI, PowerShell e Azure Resource Manager (ARM).

Tutoriais de portal do Azure

Título Descrição
Início Rápido: como criar e encaminhar eventos personalizados com o portal do Azure Mostra como usar o portal para enviar eventos personalizados.
Início Rápido: como encaminhar eventos personalizados para o Armazenamento de Filas do Azure Descreve como enviar eventos personalizados para um Armazenamento de filas.
Como publicar para tópico personalizado Mostra como publicar um evento para um tópico personalizado.

Tutoriais de CLI do Azure

Título Descrição
Início Rápido: como criar e encaminhar eventos personalizados com a CLI do Azure Mostra como usar a CLI do Azure para enviar eventos personalizados.
CLI do Azure: criar um tópico personalizado da Grade de Eventos Script de exemplo que cria um tópico personalizado. O script recupera o ponto de extremidade e uma chave.
CLI do Azure: assinar eventos para um tópico personalizado Script de exemplo que cria uma assinatura para um tópico personalizado. Envia eventos para um WebHook.

Tutoriais de Azure PowerShell

Título Descrição
Início Rápido: como criar e encaminhar eventos personalizados com o Azure PowerShell Mostra como usar o Azure PowerShell para enviar eventos personalizados.
PowerShell: criar um tópico de Grade de Eventos personalizado Script de exemplo que cria um tópico personalizado. O script recupera o ponto de extremidade e uma chave.
PowerShell: assinar eventos para um tópico personalizado Script de exemplo que cria uma assinatura para um tópico personalizado. Envia eventos para um WebHook.

Tutoriais do modelo ARM

Título Descrição
Modelo do Gerenciador de Recursos: tópico personalizado e ponto de extremidade de WebHook Um modelo do Gerenciador de Recursos que cria um tópico personalizado e uma assinatura para esse tópico personalizado. Envia eventos para um WebHook.
Modelo do Gerenciador de Recursos: tópico personalizado e ponto de extremidade de Hubs de Eventos Um modelo do Gerenciador de Recursos que cria uma assinatura para um tópico personalizado. Envia eventos para os Hubs de Eventos do Azure.

Observação

Os Gêmeos Digitais do Azure roteiam notificações de eventos para tópicos personalizados criados com a Grade de Eventos. Para obter mais informações, confira Pontos de extremidade e rotas de evento na documentação dos Gêmeos Digitais do Azure.

Próximas etapas

Veja os artigos a seguir: