Azure Event Hubs som ett hanteringsmål i prenumerationer på Azure Event Grid-namnområdesämnen
En händelsehanterare är den plats där händelsen skickas. Hanteraren vidtar en åtgärd för att bearbeta händelsen. Här är listan över händelsehanterare som stöds för namnområdesavsnitt:
Använd Event Hubs när din lösning hämtar händelser från Event Grid snabbare än den kan bearbeta händelserna. När händelserna finns i en händelsehubb kan ditt program bearbeta händelser från händelsehubben enligt sitt eget schema. Du kan skala händelsebearbetningen för att hantera inkommande händelser.
Meddelanderubriker
Här är de egenskaper som du får i rubriken för en händelse eller ett meddelande som skickas till Event Hubs:
| Egenskapsnamn | beskrivning |
|---|---|
aeg-subscription-name |
Namn på händelseprenumerationen. |
aeg-delivery-count |
Antal försök som gjorts för händelsen. |
aeg-output-event-id |
Systemgenererat händelse-ID. |
aeg-compatibility-mode-enabled |
Den här egenskapen är endast tillgänglig och anges när den levereras via Event Grid-namnområden. För närvarande är det enda möjliga värdet falskt. Den är avsedd att hjälpa händelsehanterare att skilja mellan händelser som levereras via Event Grid-namnområden jämfört med anpassade Event Grid-ämnen/systemämnen/partnernamnområden osv. |
aeg-metadata-version |
Metadataversion av händelsen. Representerar specifikationsversionen för molnhändelseschemat. |
REST-exempel
Händelseprenumeration med Event Hubs som händelsehanterare med systemtilldelad identitet
{
"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}"
}
}
}
}
}
}
}
Händelseprenumeration med Event Hubs som händelsehanterare med användartilldelad identitet
{
"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}"
}
}
}
}
}
}
}
Händelseprenumeration med deadletter-mål konfigurerat på en Händelsehubbs-händelsehanterare
{
"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}"
}
}
}
}
}
}
}
Händelseprenumeration med leveransegenskaper som konfigurerats för en Händelsehubbs-händelsehanterare
{
"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"
}
}
]
}
}
}
}
}
}
}
Specifika leveransegenskaper för Event Hubs
Med händelseprenumerationer kan du konfigurera HTTP-huvuden som ingår i levererade händelser. Med den här funktionen kan du ange anpassade rubriker som målet kräver. Du kan ange anpassade rubriker för de händelser som levereras till Azure Event Hubs.
Om du behöver publicera händelser till en specifik partition i en händelsehubb anger du PartitionKey egenskapen för din händelseprenumeration för att ange partitionsnyckeln som identifierar målhändelsehubbpartitionen.
| Huvudnamn | Rubriktyp |
|---|---|
PartitionKey |
Statisk eller dynamisk |
Mer information finns i Anpassade leveransegenskaper på namnområden.
Azure Portal
När du skapar en händelseprenumeration med händelseleveransläget inställt på Push kan du välja Event Hubs som typ av händelsehanterare och konfigurera en händelsehubb som hanterare.
Stegvisa instruktioner finns i Använda Event Hubs som mål för namnområdesavsnitt.
Azure CLI
Stegvisa instruktioner finns i Konfigurera Event Hubs som mål.