Центры событий Azure в качестве назначения обработчика в подписках для Сетка событий Azure разделов пространства имен
Обработчик событий — это место, куда отправляются события. Обработчик выполняет действие для обработки события. Ниже приведен список поддерживаемых обработчиков событий для разделов пространства имен:
Центры событий можно использовать, если решение получает больше событий от Сетки событий, чем может обработать. Когда события находятся в концентраторе событий, приложение может обрабатывать такие события по собственному расписанию. Вы можете расширить параметры обработки входящих событий.
Заголовки сообщений
Ниже приведены свойства, которые вы получаете в заголовке события или сообщения, отправленные в Центры событий:
| Имя свойства | Description |
|---|---|
aeg-subscription-name |
Имя подписки на события. |
aeg-delivery-count |
Число попыток, выполненных для события. |
aeg-output-event-id |
Идентификатор события, созданного системой. |
aeg-compatibility-mode-enabled |
Это свойство доступно только при доставке через пространства имен Сетки событий. В настоящее время единственным возможным значением является false. Он предназначен для того, чтобы помочь обработчикам событий различать события, предоставляемые с помощью пространств имен сетки событий, и пользовательских разделов сетки событий, системных разделов, пространств имен партнеров и т. д. |
aeg-metadata-version |
Версия метаданных события. Представляет версию спецификации для схемы облачных событий. |
Примеры REST
Подписка на события с Центрами событий в качестве обработчика событий с помощью назначенного системой удостоверения
{
"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}"
}
}
}
}
}
}
}
Подписка на события с Центрами событий в качестве обработчика событий с помощью удостоверения, назначенного пользователем
{
"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}"
}
}
}
}
}
}
}
Подписка на события с назначением deadletter, настроенная в обработчике событий Центров событий
{
"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}"
}
}
}
}
}
}
}
Подписка на события с свойствами доставки, настроенными в обработчике событий Центров событий
{
"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"
}
}
]
}
}
}
}
}
}
}
Свойства доставки в Центрах событий
Подписки на события позволяют настраивать заголовки HTTP, которые включаются в доставляемые события. Эта возможность позволяет задать пользовательские заголовки, необходимые для назначения. Пользовательские заголовки можно задавать для событий, которые доставляются в Центры событий Azure:
Если вам необходимо опубликовать события в определенной секции концентратора событий, задайте свойство PartitionKey в подписке на событие, чтобы указать ключ целевой секции в концентраторе событий.
| Имя заголовка | Тип заголовка |
|---|---|
PartitionKey |
Статическая или динамическая |
Дополнительные сведения см. в разделе "Настраиваемые свойства доставки" в пространствах имен.
Портал Azure
При создании подписки на события с режимом доставки событий, установленным в качестве обработчика событий, можно выбрать Центры событий в качестве типа обработчика событий и настроить концентратор событий в качестве обработчика.
Пошаговые инструкции см. в разделе "Использование Центров событий" для разделов пространства имен.
Azure CLI
Пошаговые инструкции см. в разделе "Настройка центров событий" назначения.
Следующие шаги
- Принудительная доставка пространств имен сетки событий.