取得事件中樞連接字串

發行項
07/28/2023

若要與命名空間中的事件中樞通訊，您需要命名空間或事件中樞的連接字串。如果您從應用程式中使用您命名空間的連接字串，該應用程式將會有提供給命名空間中所有事件中樞的存取權 (管理、讀取或寫入)。如果您使用事件中樞的連接字串，您將會有提供給該特定事件中樞的存取權。

命名空間的連接字串會內嵌下列元件：

所建立事件中樞命名空間的完整網域名稱 (包含後面接著 servicebus.windows.net 的事件中樞命名空間名稱)
共用存取金鑰的名稱
共用存取金鑰的名稱

命名空間的連接字串看起來像這樣：

Endpoint=sb://<NamespaceName>.servicebus.windows.net/;SharedAccessKeyName=<KeyName>;SharedAccessKey=<KeyValue>

事件中樞的連接字串中會有額外的元件。也就是 EntityPath=<EventHubName>。

Endpoint=sb://<NamespaceName>.servicebus.windows.net/;SharedAccessKeyName=<KeyName>;SharedAccessKey=<KeyValue>;EntityPath=<EventHubName>

本文說明如何使用 Azure 入口網站、PowerShell 或 CLI，來取得命名空間或特定事件中樞的連接字串。

Azure 入口網站

命名空間的連接字串

登入 Azure 入口網站。
選取左側導覽功能表上的 [所有服務]。
在 Analytics 區段中選取 [事件中樞]。
在事件中樞清單中，選取您的事件中樞。
在 [事件中樞命名空間] 頁面中，選取左側功能表上的 [共用存取原則]。
在原則清單中選取共用存取原則。預設的共用存取原則名稱為：RootManageSharedAccessPolicy。您可以新增具有適當權限 (傳送、接聽) 的原則，並使用該原則。
選取 [連接字串 - 主要金鑰] 欄位旁的 [複製] 按鈕。

命名空間中特定事件中樞的連接字串

本節會提供可在命名空間中取得特定事件中樞連接字串的步驟。

在 [事件中樞命名空間] 頁面上，選取下方窗格中的事件中樞。
在 [事件中樞執行個體] 頁面中，選取左側功能表上的 [共用存取原則]。
事件中樞不會建立預設原則。建立具有管理、傳送或接聽存取權的原則。
從清單中選取該原則。
選取 [連接字串 - 主要金鑰] 欄位旁的 [複製] 按鈕。

Azure PowerShell

您可以使用 Get-AzEventHubKey 來取得特定原則/規則的連接字串。

以下是用來取得命名空間連接字串的範例命令。 MyAuthRuleName 是共用存取原則的名稱。若為命名空間，其有預設的共用存取原則：RootManageSharedAccessKey。

Get-AzEventHubKey -ResourceGroupName MyResourceGroupName -NamespaceName MyNamespaceName -AuthorizationRuleName MyAuthRuleName

以下是用來在命名空間中取得特定事件中樞連接字串的範例命令：

Get-AzEventHubKey -ResourceGroupName MyResourceGroupName -NamespaceName MyNamespaceName -EventHubName MyEventHubName -AuthorizationRuleName MyAuthRuleName

以下是用來在異地災害復原叢集 (其具有別名) 中取得事件中樞連接字串的範例命令。

Get-AzEventHubKey -ResourceGroupName MyResourceGroupName -NamespaceName MyNamespaceName -EventHubName MyEventHubName -AliasName MyAliasName -Name MyAuthRuleName

Azure CLI

以下是用來取得命名空間連接字串的範例命令。 MyAuthRuleName 是共用存取原則的名稱。若為命名空間，其有預設的共用存取原則：RootManageSharedAccessKey

az eventhubs namespace authorization-rule keys list --resource-group MyResourceGroupName --namespace-name MyNamespaceName --name RootManageSharedAccessKey