Центры событий Azure в качестве назначения обработчика в подписках для Сетка событий Azure разделов пространства имен

Статья
02/22/2024

Обработчик событий — это место, куда отправляются события. Обработчик выполняет действие для обработки события. Ниже приведен список поддерживаемых обработчиков событий для разделов пространства имен:

Центры событий можно использовать, если решение получает больше событий от Сетки событий, чем может обработать. Когда события находятся в концентраторе событий, приложение может обрабатывать такие события по собственному расписанию. Вы можете расширить параметры обработки входящих событий.

Заголовки сообщений

Ниже приведены свойства, которые вы получаете в заголовке события или сообщения, отправленные в Центры событий:

Имя свойства	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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/{resource-group}/providers/Microsoft.EventHub/namespaces/{namespace-name}/eventhubs/{eventhub-name}"
            }
          }
        }
      }
    }
  }
}

Подписка на события с Центрами событий в качестве обработчика событий с помощью удостоверения, назначенного пользователем

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

Подписка на события с назначением deadletter, настроенная в обработчике событий Центров событий

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

Подписка на события с свойствами доставки, настроенными в обработчике событий Центров событий

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

Свойства доставки в Центрах событий

Подписки на события позволяют настраивать заголовки HTTP, которые включаются в доставляемые события. Эта возможность позволяет задать пользовательские заголовки, необходимые для назначения. Пользовательские заголовки можно задавать для событий, которые доставляются в Центры событий Azure:

Если вам необходимо опубликовать события в определенной секции концентратора событий, задайте свойство PartitionKey в подписке на событие, чтобы указать ключ целевой секции в концентраторе событий.

Имя заголовка	Тип заголовка
`PartitionKey`	Статическая или динамическая

Дополнительные сведения см. в разделе "Настраиваемые свойства доставки" в пространствах имен.

Портал Azure

При создании подписки на события с режимом доставки событий, установленным в качестве обработчика событий, можно выбрать Центры событий в качестве типа обработчика событий и настроить концентратор событий в качестве обработчика.

Пошаговые инструкции см. в разделе "Использование Центров событий" для разделов пространства имен.

Azure CLI

Пошаговые инструкции см. в разделе "Настройка центров событий" назначения.

Следующие шаги

Принудительная доставка пространств имен сетки событий.

Поделиться через