在 Azure Event Grid 命名空間主題的訂用帳戶中,使用 Azure Event Hubs 作為處理常式目的地

事件處理常式是傳送事件的位置。 處理者會採取動作來處理事件。 以下是命名空間主題所支援的事件處理程序列表:

當你的解決方案從事件網格取得事件的速度比它處理事件還快時 ,就使用事件中心 。 一旦活動進入活動中心,您的應用程式就能依照活動中心的排程處理活動。 你可以擴展事件處理以處理即將到來的事件。

郵件標頭

以下是您會在傳送至 Event Hubs 的事件或訊息標頭中收到的屬性:

屬性名稱 說明
aeg-subscription-name 事件訂閱的名稱。
aeg-delivery-count 針對事件進行的嘗試次數。
aeg-output-event-id 系統產生的事件 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/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/resourceGroups/{resource-group}/providers/Microsoft.EventHub/namespaces/{namespace-name}/eventhubs/{eventhub-name}"
            }
          }
        }
      }
    }
  }
}

以使用者指派身分搭配 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/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/resourceGroups/{resource-group}/providers/Microsoft.EventHub/namespaces/{namespace-name}/eventhubs/{eventhub-name}"
            }
          }
        }
      }
    }
  }
}

已為 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/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/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/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/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/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/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 Event Hubs 的事件上設定自訂標頭。

如果你需要將事件發佈到事件中樞內的特定分割區,請在事件訂閱中設定 PartitionKey 屬性以指定識別目標事件中樞分割區的分割區鍵。

標頭名稱 標頭類型
PartitionKey 靜態或動態

欲了解更多資訊,請參閱 命名空間的自訂交付屬性。

Azure 入口網站

當你建立事件訂閱並將事件傳遞模式設為 推送時,你可以選擇事件中心作為事件處理程式類型,並將事件中心設定為處理程序。

顯示 [建立訂閱] 頁面的螢幕快照,頁面上將 [推送] 選為傳遞模式。

關於逐步說明,請參閱 「將事件中心用作命名空間主題的目標」。

Azure CLI

有關逐步說明,請參閱 「設定事件樞紐為目的地」。

下一步