Azure 事件方格中的自訂主題

事件方格主題提供來源傳送事件的端點。 發行者會建立一個事件方格主題，並決定事件來源需要一或多個主題。 主題會用於相關事件的集合。 為了回應某些事件類型，訂閱者會決定要訂閱的主題。

自訂主題是應用程式和協力廠商的主題。 您建立或獲得自訂主題的存取權時，會在您的訂用帳戶中看見該自訂主題。 自訂主題支援推送傳遞。 請參閱使用提取或推送傳遞的時機，以協助您決定推送傳遞是否為符合您需求的正確方法。

在設計應用程式時，您必需決定要建立多少個主題。 對於相對大型的解決方案，請為每個類別的相關事件建立自訂主題。 例如，請考慮管理使用者帳戶的應用程式，以及關於客戶訂單的另一個應用程式。 不太可能所有事件訂閱者都想要來自這兩個應用程式的事件。 若要區分疑慮，請建立兩個主題：每個應用程式各一個主題。 讓事件處理常式根據其需求訂閱主題。 針對小型解決方案，您可能會偏好將所有事件傳送至單一主題。 事件訂閱者可以篩選出他們想要的事件類型。

結構描述

自訂主題支援兩種類型的事件結構描述：雲端事件和事件方格結構描述。

雲端事件結構描述

除了預設事件結構描述以外，Azure 事件方格在本質上也支援 CloudEvents v1.0 的 JSON 實作和 HTTP 通訊協定繫結中的事件。 CloudEvents 是用來說明事件資料的開放式規格。

CloudEvents 提供用以發佈和取用事件的常見事件結構描述，可簡化互通性。 此結構描述可支援統一的工具、路由和處理事件的標準方式，以及將您事件還原序列化的常見方式。 您可以利用通用結構描述更輕鬆地整合跨平台的工作。

注意

如需詳細資訊，請參閱雲端事件結構描述。

Event Grid 事件結構描述

當您使用事件方格事件結構描述時，可以在資料物件中指定應用程式特定的屬性。

[
  {
    "topic": string,
    "subject": string,
    "id": string,
    "eventType": string,
    "eventTime": string,
    "data":{
      object-unique-to-each-publisher
    },
    "dataVersion": string,
    "metadataVersion": string
  }
]

注意

如需詳細資訊，請參閱事件方格事件結構描述。

下列各節提供教學課程的連結，可以使用 Azure 入口網站、CLI、PowerShell 和 Azure Resource Manager (ARM) 範本來建立自訂主題。

Azure 入口網站教學課程

下列快速入門或教學課程說明如何建立主題、將偶數傳送至主題的端點，並使用 Azure 入口網站 將它們路由傳送至支援的目的地。

標題	描述
快速入門：使用 Azure 入口網站建立和路由傳送自訂事件	示範如何使用入口網站傳送自訂事件。
快速入門：將自訂事件路由到 Azure 佇列儲存體	描述如何將自訂事件傳送至佇列儲存體。
如何：張貼到自訂主題	示範如何將事件張貼到自訂主題。

Azure CLI 教學課程

下列快速入門或教學課程說明如何建立主題、將偶數傳送至主題的端點，並使用 Azure CLI 將它們路由傳送至支援的目的地。

標題	描述
快速入門：使用 Azure CLI 建立和路由傳送自訂事件	示範如何使用 Azure CLI 傳送自訂事件。
Azure CLI：建立事件方格自訂主題	建立自訂主題的範例指令碼。 指令碼會擷取端點和金鑰。
Azure CLI：訂閱自訂主題的事件	建立自訂主題訂用帳戶的範例指令碼。 它會將事件傳送到 WebHook。

Azure PowerShell 教學課程

下列快速入門或教學課程說明如何建立主題、將偶數傳送至主題的端點，並使用 Azure PowerShell 將它們路由傳送至支援的目的地。

標題	描述
快速入門：使用 Azure PowerShell 建立和路由傳送自訂事件	示範如何使用 Azure PowerShell 傳送自訂事件。
PowerShell：建立事件方格自訂主題	建立自訂主題的範例指令碼。 指令碼會擷取端點和金鑰。
PowerShell：訂閱自訂主題的事件	建立自訂主題訂用帳戶的範例指令碼。 它會將事件傳送到 WebHook。

ARM 範本教學課程

下列快速入門或教學課程說明如何使用ARM範本建立主題和建立主題的訂用帳戶。

標題	描述
Resource Manager 範本：自訂主題和 WebHook 端點	建立自訂主題和該自訂主題訂用帳戶的 Resource Manager 範本。 它會將事件傳送到 WebHook。
Resource Manager 範本：自訂主題和事件中樞端點	建立自訂主題訂用帳戶的 Resource Manager 範本。 它會將事件傳送到 Azure 事件中樞。

注意

Azure Digital Twins 可以將事件通知路由傳送至您使用事件方格建立的自訂主題。 如需更多資訊，請參閱 Azure Digital Twins 文件的端點和事件路由。

相關內容

請參閱以下文章：

• 系統主題
• 領域