Tópicos personalizados na Grade de Eventos do Azure

  • Artigo

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

Os tópicos personalizados são tópicos de aplicativos e de terceiros. Quando você cria ou recebe acesso a um tópico personalizado, você vê esse tópico personalizado em sua assinatura. Tópicos personalizados suportam entrega push. Consulte quando usar a entrega por push ou push para ajudá-lo a decidir se a entrega por push é a abordagem certa de acordo com suas necessidades.

Ao projetar seu aplicativo, você tem que decidir quantos tópicos criar. 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 eventos de ambos os aplicativos. Para segregar preocupações, crie dois tópicos: um para cada aplicativo. Permita que os manipuladores de eventos se inscrevam no tópico de acordo com suas necessidades. Para soluções pequenas, você pode preferir enviar todos os eventos para um único tópico. Os subscritores de eventos podem filtrar os tipos de eventos que pretendem.

Esquema de eventos

Os tópicos personalizados suportam dois tipos de esquemas de eventos: eventos na nuvem e esquema de grade de eventos.

Esquema de eventos da cloud

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

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

Nota

Para obter mais informações, consulte Esquema de eventos na nuvem.

Esquema de eventos do Event Grid

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

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

Nota

Para obter mais informações, consulte Esquema de eventos da grade de eventos.

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

Tutoriais do portal do Azure

Title Description
Guia de início rápido: criar e rotear eventos personalizados com o portal do Azure Mostra como usar o portal para enviar eventos personalizados.
Guia de início rápido: rotear eventos personalizados para o armazenamento de filas do Azure Descreve como enviar eventos personalizados para um armazenamento de fila.
Como: postar no tópico personalizado Mostra como postar um evento em um tópico personalizado.

Tutoriais da CLI do Azure

Title Description
Guia de início rápido: criar e rotear eventos personalizados com a CLI do Azure Mostra como usar a CLI do Azure para enviar eventos personalizados.
CLI do Azure: criar 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: inscrever-se em eventos para um tópico personalizado Script de exemplo que cria uma assinatura para um tópico personalizado. Ele envia eventos para um WebHook.

Tutoriais do Azure PowerShell

Title Description
Guia de início rápido: criar e rotear eventos personalizados com o Azure PowerShell Mostra como usar o Azure PowerShell para enviar eventos personalizados.
PowerShell: criar 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.
PowerShell: inscrever-se em eventos para um tópico personalizado Script de exemplo que cria uma assinatura para um tópico personalizado. Ele envia eventos para um WebHook.

Tutoriais de modelo ARM

Title Description
Modelo do Gerenciador de Recursos: tópico personalizado e ponto de extremidade WebHook Um modelo do Resource Manager que cria um tópico personalizado e uma assinatura para esse tópico personalizado. Ele envia eventos para um WebHook.
Modelo do Gerenciador de Recursos: tópico personalizado e ponto de extremidade de Hubs de Eventos Um modelo do Resource Manager que cria uma assinatura para um tópico personalizado. Ele envia eventos para um Hubs de Eventos do Azure.

Nota

Os Gêmeos Digitais do Azure podem rotear notificações de eventos para tópicos personalizados que você cria com a Grade de Eventos. Para obter mais informações, consulte Pontos de extremidade e rotas de eventos na documentação do Azure Digital Twins.

Próximos passos

Consulte os seguintes artigos: