合作夥伴的活動概觀 - Azure 事件方格

發行項
02/12/2024

事件方格的 合作夥伴事件 可讓客戶 訂閱源自已註冊系統的事件 ，其機制與 Azure 上任何其他事件來源所使用的機制相同，例如 Azure 服務。這些已註冊的系統會與事件方格整合，稱為「合作夥伴」。這項功能也可讓客戶 將事件 傳送至合作夥伴系統，這些系統支援將事件接收和路由傳送至其平臺中的客戶解決方案/端點。一般而言，合作夥伴是軟體即服務（SaaS）或 ERP 提供者，但它們可能是公司平臺，希望將其活動提供給內部小組使用。他們的目的是要與事件方格整合，以實現端對端客戶使用案例，該案例端位於 Azure 上（客戶訂閱合作夥伴所傳送的事件），或結束於合作夥伴系統（客戶訂閱由 Azure 事件方格傳送的 Microsoft 事件）。客戶會 Azure 事件方格銀行，將合作夥伴發佈的事件傳送至支援的目的地，例如 Webhook、Azure Functions、Azure 事件中樞或 Azure 服務匯流排等等。客戶也依賴 Azure 事件方格來路由來自 Microsoft 服務的事件，例如 Outlook、Teams 或 Microsoft Entra ID，以便客戶的解決方案可以回應事件。透過合作夥伴事件，客戶可以跨平臺和網路界限建置事件驅動解決方案，以可靠地、安全且大規模地接收或傳送事件。

注意

這是一篇概念性文章，在您決定要以合作夥伴身分上線之前先閱讀 Azure 事件方格。如需如何使用 Azure 入口網站以事件方格合作夥伴身分上線的逐步指示，請參閱如何以事件方格合作夥伴的身分上線（Azure 入口網站）。

合作夥伴事件：運作方式

身為合作夥伴，您可以建立事件方格資源，讓您將事件發佈至 Azure 事件方格，讓 Azure 上的客戶可以訂閱事件。對於大多數合作夥伴，例如 SaaS 提供者，這是他們將使用的唯一整合功能。

您也可以建立事件方格資源，以接收來自 Azure 事件方格的事件。此使用案例適用於擁有或管理平台的組織，讓其客戶能夠藉由公開端點來接收事件。其中一些組織是 ERP 系統，其平臺內也有事件路由功能，其會將傳入的 Azure 事件傳送至裝載在其平臺上的客戶應用程式。

針對發佈事件或接收事件，您可以遵循這些一般步驟來建立相同類型的事件方格資源。

請連絡事件方格小組，以 askgrid@microsoft.com 傳達您成為合作夥伴的興趣。當您與我們連絡之後，我們會引導您完成上線程式，並協助服務在我們的 Azure 事件方格資源庫上取得進入卡，以便您可以在 Azure 入口網站找到您的服務。
建立合作夥伴註冊。這是全域資源，您通常需要建立一次。
建立夥伴命名空間。此資源會公開您可以將事件發佈至 Azure 的端點。建立夥伴命名空間時，請提供您建立的合作夥伴註冊。
客戶授權您在客戶的 Azure 訂用帳戶中建立合作夥伴主題。
客戶會存取您的網頁或執行命令，您可以定義用戶體驗，以要求事件流向 Azure 或將 Microsoft 事件接收至系統的能力。為了響應該要求，您已設定系統以使用客戶的輸入來執行此動作。例如，客戶可以選擇從系統選取應該轉送至 Azure 的特定事件。
使用通道在客戶的 Azure 訂用帳戶和資源群組中建立合作夥伴主題。通道是合作夥伴命名空間所包含的資源。
客戶會啟動您在其 Azure 訂用帳戶和資源群組中建立的合作夥伴主題。
開始將事件發佈至您的合作夥伴命名空間。

注意

您必須將 Azure 事件方格資源提供者註冊到您想要在其中建立事件方格資源的每個 Azure 訂用帳戶。否則，建立資源的作業將會失敗。

為何應該使用合作夥伴事件？

如果您有一或多個下列需求，您可能想要使用合作夥伴事件功能。

作為事件發行者的合作夥伴

您想要一個機制，讓您的事件可供 Azure 上的客戶使用。您的使用者可以使用他們擁有和管理的合作夥伴主題和事件訂用帳戶來篩選和路由這些事件。您可以使用其他整合方法，例如主題和網域。不過，這些方法不會允許您和客戶之間清楚區分資源擁有權、管理和計費。合作夥伴事件功能也提供更直覺的用戶體驗，可讓您輕鬆探索您的服務。
您需要簡單的多租使用者模型，將事件發佈至單一區域端點，命名空間的端點，以將事件路由傳送至不同的客戶。
您想要瞭解與已發佈事件相關的計量。
您要針對事件使用雲端事件 1.0 架構。

作為訂閱者的合作夥伴

您希望您的服務回應源自 Microsoft Azure 的客戶事件。
您希望您的客戶使用平臺所裝載的應用程式來回應 Microsoft Azure 服務事件。您可以使用平臺的事件路由功能，將事件傳遞至正確的客戶解決方案。
您想要簡單的模型，讓客戶只需選取您的服務名稱作為目的地，而不需要他們知道平臺端點等技術詳細數據。
您的系統/平台支援雲端事件 1.0 架構。

由合作夥伴管理的資源

身為合作夥伴，您可以管理下列類型的資源。

合作夥伴註冊

註冊會保存與合作夥伴相關的一般資訊。建立夥伴命名空間時需要註冊。也就是說，您必須擁有合作夥伴註冊，才能建立必要的 Azure 資源來與 Azure 事件方格整合。

註冊是全域的。也就是說，它們不會與特定 Azure 區域相關聯。您可以建立單一合作夥伴註冊，並在建立合作夥伴命名空間時使用該註冊。

管道

通道是合作夥伴命名空間的巢狀資源。通道有兩個主要用途：

這是可讓您在客戶的 Azure 訂用帳戶上建立合作夥伴資源的資源類型。當您建立類型的 partner topic通道時，會在客戶的 Azure 訂用帳戶上建立合作夥伴主題。合作夥伴主題是客戶的資源，當合作夥伴系統發佈事件時，事件會路由傳送至該資源。

通道的生命週期與其相關聯的客戶合作夥伴主題或目的地相同。刪除類型的 partner topic 通道時，例如，已刪除相關聯的客戶合作夥伴主題。同樣地，如果客戶刪除合作夥伴主題，則會刪除 Azure 訂用帳戶上的相關聯通道。
它是用來路由事件的資源。類型的 partner topic 通道可用來將事件路由傳送至客戶的合作夥伴主題。它支援兩種類型的路由模式。
- 通道名稱路由。透過這類路由，您會使用名為 aeg-channel-name 的 HTTP 標頭來發佈事件，其中提供應路由傳送事件的通道名稱。因為頻道是合作夥伴主題的合作夥伴代表專案，因此事件會路由傳送至客戶元件主題上的頻道顯示。這種路由是中不存在 event channels的新功能，僅支援以來源為基礎的路由。通道名稱路由可啟用比來源型路由更多的使用案例，而且建議選擇路由模式。例如，透過通道名稱路由，客戶可以要求源自不同事件來源的事件，以登陸單一合作夥伴主題。
- 來源型路由。此路由方法是以事件中內容屬性的值 source 為基礎。來源會對應至通道，而且當事件隨附來源時，例如，事件的值 “A” 會路由傳送至與來源屬性中包含 “A” 之通道相關聯的夥伴主題。
您可能想要宣告路由至通道和其相關聯夥伴主題的事件類型。在合作夥伴主題上建立事件訂閱時，事件類型會向客戶顯示，並用來選取要傳送至事件處理程式目的地的特定事件類型。深入了解。

重要

事件類型可以在通道上管理，一旦更新值，變更就會立即反映在相關聯的夥伴主題上。

合作夥伴命名空間

合作夥伴命名空間是區域資源，具有將事件發佈至 Azure 事件方格的端點。合作夥伴命名空間包含通道或事件通道（舊版資源）。您必須在客戶要求合作夥伴主題或目的地的區域建立合作夥伴命名空間，因為通道及其對應的合作夥伴資源必須位於相同的區域中。例如，您無法在具有其相關合作夥伴主題的指定區域中有通道，例如位於不同區域。

合作夥伴命名空間包含通道或事件通道。它是由命名空間中的屬性 夥伴主題路由模式 所決定。如果通道名稱標頭設定為通道名稱，則通道是唯一可在命名空間下建立的資源類型。如果夥伴主題路由模式設定為事件中的Source屬性，則命名空間只能包含事件通道。請注意，設定許可權 partner topic routing mode 的決定不是選擇通道名稱或來源型路由之間的決策。通道同時支援兩者。與其說是使用新類型的路由資源、通道，還是使用舊版資源、事件通道之間的決策。

事件通道

事件通道是第一次與合作夥伴事件一起發行的資源，以將傳入事件路由傳送至合作夥伴主題。事件通道僅支援以來源為基礎的路由，且一律代表客戶合作夥伴主題。

重要

事件通道即將淘汰。因此，建議您使用通道。

已驗證的合作夥伴

已驗證的合作夥伴是 Microsoft 已驗證身分識別的合作夥伴組織。強烈建議貴組織獲得驗證。客戶尋求與已驗證為這類驗證的合作夥伴互動，可提供他們與合法組織打交道的更大保證。經過驗證之後，您可以受益於在事件方格資源庫上存在，讓客戶可以輕鬆地探索您的服務，並在訂閱事件時擁有第一方體驗。例如。

客戶建立合作夥伴主題的授權

客戶授權您在其 Azure 訂用帳戶中建立合作夥伴主題。授權會授與客戶 Azure 訂用帳戶中指定資源群組的授權，而且該授權是有時間限制的。您必須在客戶設定到期日之前建立通道。您應該有文件建議客戶有足夠的時間範圍，以設定系統來傳送或接收事件，並在授權到期之前建立通道。如果您嘗試在沒有授權的情況下建立通道，或在通道建立過期之後，通道建立將會失敗，且不會在客戶的 Azure 訂用帳戶上建立任何資源。

注意

事件方格開始 強制執行授權檢查，以在 2022 年 6 月 30 日左右建立合作夥伴主題 。您的文件應該要求您的客戶在建立通道之前，將授權授與您作為必要條件。

重要

已驗證的合作夥伴不是授權的合作夥伴。即使合作夥伴已經過 Microsoft 審查，您仍然需要獲得授權，才能在客戶的 Azure 訂用帳戶中建立合作夥伴主題。

合作夥伴主題啟用

客戶會啟用您已為其建立的合作夥伴主題或目的地。此時，通道的啟用狀態會變更為 Activated。啟用通道之後，您就可以開始將事件發佈至包含通道的合作夥伴命名空間端點。

如何自動化程式，以瞭解何時可以開始發佈指定合作夥伴主題的事件？

您有兩個選擇：

定期讀取（poll）通道狀態，以檢查啟用狀態是否已從 NeverActivated轉換為 Activated。這項作業可能需要大量運算。
為包含您要監視之通道的 Azure 訂用帳戶或資源群組建立事件訂用帳戶。每當通道更新時，您就會收到 Microsoft.Resources.ResourceWriteSuccess 事件。接著，您必須使用事件中提供的 Azure Resource Manager 標識符來讀取通道的狀態，以確定更新與啟用狀態變更有關。