Azure Event Hubs als handlerbestemming in abonnementen op Azure Event Grid-naamruimteonderwerpen

Artikel
05/21/2024

Een gebeurtenis-handler is de plaats waar de gebeurtenis wordt verzonden. De handler voert een actie uit om de gebeurtenis te verwerken. Hier volgt de lijst met ondersteunde gebeurtenis-handlers voor naamruimteonderwerpen:

Gebruik Event Hubs wanneer uw oplossing sneller gebeurtenissen van Event Grid ontvangt dan de gebeurtenissen kunnen worden verwerkt. Zodra de gebeurtenissen zich in een Event Hub bevinden, kan uw toepassing gebeurtenissen van de Event Hub op een eigen schema verwerken. U kunt de verwerking van uw gebeurtenissen schalen om de binnenkomende gebeurtenissen af te handelen.

Berichtkoppen

Dit zijn de eigenschappen die u ontvangt in de koptekst van een gebeurtenis of bericht dat naar Event Hubs wordt verzonden:

Eigenschapsnaam	Beschrijving
`aeg-subscription-name`	Naam van het gebeurtenisabonnement.
`aeg-delivery-count`	Aantal pogingen voor de gebeurtenis.
`aeg-output-event-id`	Door het systeem gegenereerde gebeurtenis-id.
`aeg-compatibility-mode-enabled`	Deze eigenschap is alleen beschikbaar en ingesteld wanneer deze wordt geleverd via Event Grid-naamruimten. Momenteel is de enige mogelijke waarde onwaar. Het is bedoeld om gebeurtenis-handlers te helpen onderscheid te maken tussen gebeurtenissen die worden geleverd via Event Grid-naamruimten versus aangepaste onderwerpen/systeemonderwerpen/partnernaamruimten, enzovoort.
`aeg-metadata-version`	Metagegevensversie van de gebeurtenis. Vertegenwoordigt de specificatieversie voor het cloud-gebeurtenisschema.

REST-voorbeelden

Gebeurtenisabonnement met Event Hubs als gebeurtenis-handler met behulp van door het systeem toegewezen identiteit

{
  "properties": {
    "deliveryConfiguration": {
      "deliveryMode": "Push",
      "push": {
        "deliveryWithResourceIdentity": {
          "identity": {
            "type": "SystemAssigned"
          },
          "destination": {
            "endpointType": "EventHub",
            "properties": {
              "resourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/{resource-group}/providers/Microsoft.EventHub/namespaces/{namespace-name}/eventhubs/{eventhub-name}"
            }
          }
        }
      }
    }
  }
}

Gebeurtenisabonnement met Event Hubs als gebeurtenis-handler met behulp van door de gebruiker toegewezen identiteit

{
  "properties": {
    "deliveryConfiguration": {
      "deliveryMode": "Push",
      "push": {
        "deliveryWithResourceIdentity": {
          "identity": {
            "type": "UserAssigned",
            "userAssignedIdentities": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/{resource-group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{user-identity-name}"
          },
          "destination": {
            "endpointType": "EventHub",
            "properties": {
              "resourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/{resource-group}/providers/Microsoft.EventHub/namespaces/{namespace-name}/eventhubs/{eventhub-name}"
            }
          }
        }
      }
    }
  }
}

Gebeurtenisabonnement met deadletterbestemming geconfigureerd op een Event Hubs-gebeurtenis-handler

{
  "properties": {
    "deliveryConfiguration": {
      "deliveryMode": "Push",
      "push": {
        "deliveryWithResourceIdentity": {
          "identity": {
            "type": "UserAssigned",
            "userAssignedIdentities": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/{resource-group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{user-identity-name}"
          },
          "destination": {
            "endpointType": "EventHub",
            "properties": {
              "resourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/{resource-group}/providers/Microsoft.EventHub/namespaces/{namespace-name}/eventhubs/{eventhub-name}"
            }
          }
        },
        "deadLetterDestinationWithResourceIdentity": {
          "identity": {
            "type": "UserAssigned",
            "userAssignedIdentities": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/{resource-group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{user-identity-name}"
          },
          "deadLetterDestination": {
            "endpointType": "StorageBlob",
            "properties": {
              "resourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/{resource-group}/providers/Microsoft.Storage/storageAccounts/{storage-account-name}",
              "blobContainerName": "{blob-container-name}"
            }
          }
        }
      }
    }
  }
}

Gebeurtenisabonnement met leveringseigenschappen die zijn geconfigureerd op een Event Hubs-gebeurtenis-handler

{
  "properties": {
    "deliveryConfiguration": {
      "deliveryMode": "Push",
      "push": {
        "deliveryWithResourceIdentity": {
          "identity": {
            "type": "SystemAssigned"
          },
          "destination": {
            "endpointType": "EventHub",
            "properties": {
              "resourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/{resource-group}/providers/Microsoft.EventHub/namespaces/{namespace-name}/eventhubs/{eventhub-name}",
              "deliveryAttributeMappings": [
                {
                  "name": "somestaticname",
                  "type": "Static",
                  "properties": {
                    "value": "somestaticvalue"
                  }
                },
                {
                  "name": "somedynamicname",
                  "type": "Dynamic",
                  "properties": {
                    "sourceField": "subject"
                  }
                }
              ]
            }
          }
        }
      }
    }
  }
}

Event Hubs-specifieke leveringseigenschappen

Met gebeurtenisabonnementen kunt u HTTP-headers instellen die zijn opgenomen in bezorgde gebeurtenissen. Met deze mogelijkheid kunt u aangepaste headers instellen die nodig zijn voor de bestemming. U kunt aangepaste headers instellen voor de gebeurtenissen die worden geleverd aan Azure Event Hubs.

Als u gebeurtenissen wilt publiceren naar een specifieke partitie binnen een Event Hub, stelt u de PartitionKey eigenschap voor uw gebeurtenisabonnement in om de partitiesleutel op te geven die de doel-Event Hub-partitie identificeert.

Headernaam	Kopteksttype
`PartitionKey`	Statisch of dynamisch

Zie Aangepaste leveringseigenschappen voor naamruimten voor meer informatie.

Azure Portal

Wanneer u een gebeurtenisabonnement maakt met de gebeurtenisleveringsmodus die is ingesteld op Push, kunt u Event Hubs selecteren als het type gebeurtenis-handler en een Event Hub configureren als handler.

Zie Event Hubs een bestemming gebruiken voor naamruimteonderwerpen voor stapsgewijze instructies.

Azure-CLI

Zie Event Hubs een bestemming configureren voor stapsgewijze instructies.

Volgende stappen

Pushlevering van Event Grid-naamruimten.

Delen via