Hub de eventos como um manipulador de eventos para os eventos da Grade de Eventos do Azure

Artigo
09/19/2023

Um manipulador de eventos é o local para o qual o evento é enviado. O manipulador usa uma ação para processar o evento. Vários serviços do Azure são automaticamente configurados para lidar com os eventos, e o Hubs de Eventos do Azure é um deles.

Use o Hubs de Eventos quando sua solução receber eventos da Grade de Eventos mais rápido do que é capaz de processar. Quando os eventos estiverem em um hub de eventos, seu aplicativo poderá processar a partir do hub de eventos em seu próprio agendamento. Você pode dimensionar o processamento dos eventos para manipular os eventos de entrada.

Tutoriais

Veja os exemplos a seguir:

Title	Descrição
Início Rápido: Encaminhar eventos personalizados para os Hubs de Eventos do Azure com a CLI do Azure	Envia um evento personalizado para um hub de eventos para processamento por um aplicativo.
Modelo do Resource Manager: Criar um tópico personalizado de Grade de Eventos e enviar eventos para um hub 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.

Cabeçalhos de mensagem

Estas são as propriedades que você recebe nos cabeçalhos das mensagens:

Nome da propriedade	Descrição
aeg-subscription-name	Nome da assinatura do evento.
aeg-delivery-count	Número de tentativas feitas para o evento.
aeg-event-type	Tipo do evento. Pode ser um dos seguintes valores: SubscriptionValidation Notificação SubscriptionDeletion
aeg-metadata-version	A versão de metadados do evento. Para o esquema de evento da Grade de Eventos, essa propriedade representa a versão de metadados e, para o esquema de evento da nuvem, ela representa a versão de especificação.
aeg-data-version	Versão de dados do evento. Para o esquema de evento da Grade de Eventos, essa propriedade representa a versão dos dados e para o esquema de evento da nuvem, ela não se aplica.
aeg-output-event-id	ID do evento da Grade de Eventos.

Exemplos de REST (para PUT)

Hub de Eventos

{
  "properties": 
  {
    "destination": 
    {
      "endpointType": "EventHub",
      "properties": 
      {
        "resourceId": "/subscriptions/<AZURE SUBSCRIPTION ID>/resourceGroups/<RESOURCE GROUP NAME>/providers/Microsoft.EventHub/namespaces/<EVENT HUBS NAMESPACE NAME>/eventhubs/<EVENT HUB NAME>"
      }
    },
    "eventDeliverySchema": "EventGridSchema"
  }
}

Hub de eventos – entrega com identidade gerenciada

{
  "properties": {
    "deliveryWithResourceIdentity": 
    {
      "identity": 
      {
        "type": "SystemAssigned"
      },
      "destination": 
      {
        "endpointType": "EventHub",
        "properties": 
        {
          "resourceId": "/subscriptions/<AZURE SUBSCRIPTION ID>/resourceGroups/<RESOURCE GROUP NAME>/providers/Microsoft.EventHub/namespaces/<EVENT HUBS NAMESPACE NAME>/eventhubs/<EVENT HUB NAME>"
        }
      }
    },
    "eventDeliverySchema": "EventGridSchema"
  }
}

Propriedades de entrega

As assinaturas de evento permitem que você configure cabeçalhos HTTP que estão incluídos nos eventos entregues. Essa funcionalidade permite que você defina cabeçalhos personalizados exigidos pelo destino. Você pode definir os cabeçalhos personalizados nos eventos que são entregues aos Hubs de Eventos do Azure.

Se você precisar publicar eventos em uma partição específica dentro de um hub de eventos, defina a propriedade PartitionKey na sua assinatura de evento para especificar a chave de partição que identifica a partição do hub de eventos de destino.

Nome do cabeçalho	Tipo de cabeçalho
`PartitionKey`	Estático ou dinâmico

Para obter mais informações, confira Propriedades de entrega personalizadas.

Próximas etapas

Consulte o artigo Manipuladores de eventos para obter uma lista dos manipuladores de eventos compatíveis.

Compartilhar via