Dela via


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/00000000-0000-0000-0000-000000000000/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/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{user-identity-name}"
          },
          "destination": {
            "endpointType": "EventHub",
            "properties": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/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/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{user-identity-name}"
          },
          "destination": {
            "endpointType": "EventHub",
            "properties": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.EventHub/namespaces/{namespace-name}/eventhubs/{eventhub-name}"
            }
          }
        },
        "deadLetterDestinationWithResourceIdentity": {
          "identity": {
            "type": "UserAssigned",
            "userAssignedIdentities": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{user-identity-name}"
          },
          "deadLetterDestination": {
            "endpointType": "StorageBlob",
            "properties": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/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/00000000-0000-0000-0000-000000000000/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.

Skärmbild som visar sidan Skapa prenumeration med Push valt för leveransläge.

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.

Nästa steg