Azure Event Hubs jako cíl obslužné rutiny v odběrech témat oboru názvů služby Azure Event Grid

Článek
05/21/2024

Obslužná rutina události je místo, kde se událost odesílá. Obslužná rutina provede akci ke zpracování události. Tady je seznam podporovaných obslužných rutin událostí pro témata oboru názvů:

Event Hubs použijte, když vaše řešení získává události z Event Gridu rychleji, než dokáže zpracovat události. Jakmile jsou události v centru událostí, může vaše aplikace zpracovávat události z centra událostí podle vlastního plánu. Zpracování událostí můžete škálovat tak, aby zpracovával příchozí události.

Záhlaví zpráv

Tady jsou vlastnosti, které obdržíte v hlavičce události nebo zprávy odeslané do služby Event Hubs:

Název vlastnosti	Popis
`aeg-subscription-name`	Název odběru události.
`aeg-delivery-count`	Počet pokusů o událost
`aeg-output-event-id`	ID události vygenerované systémem
`aeg-compatibility-mode-enabled`	Tato vlastnost je dostupná a nastavená pouze při doručování přes obory názvů Služby Event Grid. V současné době je jediná možná hodnota false. Účelem je pomoct obslužným rutinám událostí rozlišovat mezi událostmi dodanými prostřednictvím oborů názvů Event Gridu a vlastních témat/ témat systému/ partnerských oborů názvů atd.
`aeg-metadata-version`	Verze metadat události Představuje verzi specifikace pro schéma cloudových událostí.

Příklady REST

Odběr událostí se službou Event Hubs jako obslužnou rutinou události pomocí identity přiřazené systémem

{
  "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}"
            }
          }
        }
      }
    }
  }
}

Odběr událostí se službou Event Hubs jako obslužnou rutinou události pomocí identity přiřazené uživatelem

{
  "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}"
            }
          }
        }
      }
    }
  }
}

Odběr událostí s cílem deadletter nakonfigurovaným pro obslužnou rutinu události Event Hubs

{
  "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}"
            }
          }
        }
      }
    }
  }
}

Odběr událostí s vlastnostmi doručení nakonfigurovanými u obslužné rutiny události Event Hubs

{
  "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"
                  }
                }
              ]
            }
          }
        }
      }
    }
  }
}

Vlastnosti doručení specifické pro službu Event Hubs

Odběry událostí umožňují nastavit hlavičky HTTP, které jsou součástí doručených událostí. Tato funkce umožňuje nastavit vlastní hlavičky, které cíl vyžaduje. U událostí, které se doručují do služby Azure Event Hubs, můžete nastavit vlastní hlavičky.

Pokud potřebujete publikovat události do konkrétního oddílu v centru událostí, nastavte PartitionKey vlastnost odběru událostí tak, aby určila klíč oddílu, který identifikuje cílový oddíl centra událostí.

Název hlavičky	Typ záhlaví
`PartitionKey`	Statické nebo dynamické

Další informace naleznete v tématu Vlastní vlastnosti doručení v oborech názvů.

portál Azure

Při vytváření odběru událostí s režimem doručování událostí nastaveným na Push můžete jako typ obslužné rutiny události vybrat službu Event Hubs a nakonfigurovat centrum událostí jako obslužnou rutinu.

Podrobné pokyny najdete v tématu Použití služby Event Hubs jako cíle pro témata oboru názvů.

Azure CLI

Podrobné pokyny najdete v tématu Konfigurace služby Event Hubs jako cíle.

Další kroky

Doručování nabízených oznámení obory názvů Event Gridu

Sdílet prostřednictvím