Tópicos do sistema na Grade de Eventos do Azure

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, formas padrão de roteamento e tratamento 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

Os guias de início rápido ou tutoriais a seguir mostram como criar um tópico, enviar pares para o ponto de extremidade do tópico e roteá-los para destinos com suporte usando o 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

Os guias de início rápido ou tutoriais a seguir mostram como criar um tópico, enviar pares para o ponto de extremidade do tópico e roteá-los para destinos com suporte usando a 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

Os guias de início rápido ou tutoriais a seguir mostram como criar um tópico, enviar pares para o ponto de extremidade do tópico e roteá-los para destinos com suporte usando o 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

Os guias de início rápido ou tutoriais a seguir mostram como criar um tópico e criar uma assinatura para o tópico usando modelos do 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.

Conteúdo relacionado

Veja os artigos a seguir:

• Tópicos do sistema
• Domínios