取得事件中樞連接字串
若要與命名空間中的事件中樞通訊,您需要命名空間或事件中樞的連接字串。 如果您從應用程式中使用您命名空間的連接字串,該應用程式將會有提供給命名空間中所有事件中樞的存取權 (管理、讀取或寫入)。 如果您使用事件中樞 連接字串,您將擁有該特定事件中樞的提供存取權。
命名空間的連接字串會內嵌下列元件:
- 所建立事件中樞命名空間的完整網域名稱 (包含後面接著
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
以下是用來在命名空間中取得特定事件中樞連接字串的範例命令:
az eventhubs eventhub authorization-rule keys list --resource-group MyResourceGroupName --namespace-name MyNamespaceName --eventhub-name MyEventHubName --name MyAuthRuleName
以下是用來在異地災害復原叢集 (其具有別名) 中取得事件中樞連接字串的範例命令。
az eventhubs georecovery-alias authorization-rule keys list --resource-group MyResourceGroupName --namespace-name MyNamespaceName --eventhub-name MyEventHubName --alias-name MyAliasName --name MyAuthRuleName
如需事件中樞的 Azure CLI 命令的相關資訊,請參閱適用於事件中樞的 Azure CLI。
相關內容
您可以造訪下列連結以深入了解事件中樞︰