共用方式為


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 CLI 教學課程

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

Azure PowerShell 教學課程

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

ARM 範本教學課程

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

注意

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

下一步

請參閱以下文章: