Центры событий Azure Event Hubs в качестве пункта назначения обработчика в подписках на темы пространства имен Azure Event Grid.

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

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

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

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

Имя свойства Описание
aeg-subscription-name Имя подписки на событие.
aeg-delivery-count Количество попыток, выполненных для события.
aeg-output-event-id Идентификатор события, созданного системой.
aeg-compatibility-mode-enabled Это свойство доступно и устанавливается только при доставке через пространства имен Event Grid. В настоящее время единственным возможным значением является false. Он предназначен для того, чтобы помочь обработчикам событий различать события, поступающие из пространств имен Event Grid, пользовательских тем Event Grid, системных тем, партнерских пространств имен и т. д.
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}"
            }
          }
        }
      }
    }
  }
}

Подписка на события со свойствами доставки, настроенными в обработчике событий 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"
                  }
                }
              ]
            }
          }
        }
      }
    }
  }
}

Специальные свойства доставки для Event Hubs (Центры событий)

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

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

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

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

Портал Azure

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

Снимок экрана, на котором показана страница

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

Azure CLI (Интерфейс командной строки для Azure)

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

Дальнейшие действия

  • Last updated on