Envio por push com HTTP

  • Artigo

Este artigo baseia-se em O que é a Grade de Eventos do Azure? , para fornecer informações essenciais antes de começar a usar a entrega pull e push da Grade de Eventos por HTTP. Abrange conceitos fundamentais, modelos de recursos e modos de entrega de mensagens suportados. No final deste documento, você encontrará links úteis para artigos que o orientam sobre como usar a Grade de Eventos e para artigos que oferecem informações conceituais detalhadas.

Importante

Este documento ajuda você a começar com os recursos de Grade de Eventos que usam o protocolo HTTP. Este artigo é adequado para usuários que precisam integrar aplicativos na nuvem. Se você precisar comunicar dados de dispositivos IoT, consulte Visão geral do suporte MQTT na grade de eventos do Azure.

Conceitos-chave

CloudEventos

A Grade de Eventos está em conformidade com a especificação CloudEvents 1.0 padrão aberto do CNCF usando a ligação do protocolo HTTP com o formato JSON. Isso significa que suas soluções publicam e consomem mensagens de eventos usando um formato como o exemplo a seguir:

{
    "specversion" : "1.0",
    "type" : "com.yourcompany.order.created",
    "source" : "https://yourcompany.com/orders/",
    "subject" : "O-28964",
    "id" : "A234-1234-1234",
    "time" : "2018-04-05T17:31:00Z",
    "comexampleextension1" : "value",
    "comexampleothervalue" : 5,
    "datacontenttype" : "application/json",
    "data" : {
       "orderId" : "O-28964",
       "URL" : "https://com.yourcompany/orders/O-28964"
    }
}

O que é um evento?

Um evento é a menor quantidade de informação que descreve completamente algo que aconteceu em um sistema. Muitas vezes nos referimos a um evento, como mostrado acima, como um evento discreto porque representa um fato distinto e autônomo sobre um sistema que fornece uma visão que pode ser acionável. Os exemplos incluem: com.yourcompany.Orders.OrderCreated, org.yourorg.GeneralLedger.AccountChanged, io.solutionname.Auth.MaximumNumberOfUserLoginAttemptsReached.

Nota

Usamos indistintamente os termos eventos discretos, cloudevents ou apenas eventos para nos referirmos às mensagens que informam sobre uma alteração de um estado do sistema.

Para obter mais informações sobre eventos, consulte a Terminologia da Grade de Eventos.

Outro tipo de evento

A comunidade de usuários também se refere a eventos para aqueles tipos de mensagens que carregam um ponto de dados, como uma única leitura de um dispositivo ou um único clique em uma página de aplicativo da Web. Esse tipo de evento geralmente é analisado ao longo de uma janela de tempo ou tamanho de fluxo de eventos para obter insights e executar uma ação. Na documentação do Event Grid, nos referimos a esse tipo de evento como ponto de dados, streaming de dados ou telemetria. Eles são um tipo de dados que o suporte MQTT da Grade de Eventos e os Hubs de Eventos do Azure geralmente manipulam.

Tópicos e subscrições de eventos

Os eventos publicados na Grade de Eventos aterrissam em um tópico, que é um recurso que contém logicamente todos os eventos. Uma assinatura de evento é um recurso de configuração associado a um único tópico. Entre outras coisas, você usa uma assinatura de evento para definir critérios de seleção de eventos para definir a coleção de eventos disponível para um assinante fora do conjunto total de eventos presentes em um tópico.

Diagram showing a topic and associated event subscriptions.

Entrega por push

A entrega por push é suportada para os seguintes recursos. Clique nos links para saber mais sobre cada um deles.

  • Tópicos do sistema. Use tópicos do sistema para receber eventos (do sistema) dos serviços do Azure.
  • Tópicos personalizados. Use tópicos personalizados quando quiser publicar os eventos do seu aplicativo.
  • Domínios. Os domínios representam um grupo de tópicos de domínio normalmente associados a um único aplicativo que requer o envio de eventos para diferentes grupos de usuários, organizações ou aplicativos. Uma abordagem comum é associar um tópico de domínio a um grupo de aplicativos de destino ou usuários de uma organização dentro do mesmo locatário. Uma organização pode ser uma equipa, uma divisão na empresa, uma empresa, etc.
  • Tópicos de parceiros. Use tópicos de parceiros quando quiser consumir eventos de parceiros de terceiros.

Configure uma assinatura de evento em um tópico de sistema, personalizado ou parceiro para especificar um critério de filtragem para eventos e definir um destino para um dos manipuladores de eventos suportados.

O diagrama a seguir ilustra os recursos que oferecem suporte à entrega por push com alguns dos manipuladores de eventos suportados.

High-level diagram showing all the topic types that support push delivery, namely System, Custom, Domain, and Partner topics.

Nota

Se você estiver interessado em saber mais sobre a entrega por push em namespaces de Grade de Eventos, consulte [namespace-push-delivery-overview.md].

Próximos passos

Os artigos a seguir fornecem informações sobre como usar a Grade de Eventos ou fornecem informações adicionais sobre conceitos.