快速入門:使用 Azure CLI 建立事件中樞
在此快速入門中,您將使用 Azure CLI 建立事件中樞。
如果您沒有 Azure 訂閱,請在開始之前,先建立 Azure 免費帳戶。
必要條件
在 Azure Cloud Shell 中使用 Bash 環境。 如需詳細資訊,請參閱 Azure Cloud Shell 中的 Bash 快速入門。
若要在本地執行 CLI 參考命令,請安裝 Azure CLI。 若您在 Windows 或 macOS 上執行,請考慮在 Docker 容器中執行 Azure CLI。 如需詳細資訊,請參閱〈如何在 Docker 容器中執行 Azure CLI〉。
如果您使用的是本機安裝,請使用 az login 命令,透過 Azure CLI 來登入。 請遵循您終端機上顯示的步驟,完成驗證程序。 如需其他登入選項,請參閱使用 Azure CLI 登入。
出現提示時,請在第一次使用時安裝 Azure CLI 延伸模組。 如需擴充功能詳細資訊,請參閱使用 Azure CLI 擴充功能。
執行 az version 以尋找已安裝的版本和相依程式庫。 若要升級至最新版本,請執行 az upgrade。
- 本文需要 2.0.4 版或更新版本的 Azure CLI。 如果您是使用 Azure Cloud Shell,就已安裝最新版本。
建立資源群組
執行下列 命令以建立資源群組。 資源群組是 Azure 資源的邏輯集合。 所有資源都會在資源群組中部署與管理。
選取 [複製] 以複製命令,並將其貼到 Cloud Shell 或 CLI 視窗中,然後加以執行。 視需要更新資源組名和區域。
rgName="contosorg$RANDOM"
region="eastus"
az group create --name $rgName --location $region
您會看到類似以下的輸出。 您會在 name
欄位中看到資源群組名稱並以隨機數字取代 $RANDOM
。
{
"id": "/subscriptions/0000000000-0000-0000-0000-000000000000000/resourceGroups/contosorg32744",
"location": "eastus",
"managedBy": null,
"name": "contosorg32744",
"properties": {
"provisioningState": "Succeeded"
},
"tags": null,
"type": "Microsoft.Resources/resourceGroups"
}
建立事件中樞命名空間
執行下列命令以建立事件中樞命名空間。 事件中樞命名空間提供唯一的範圍容器 (依其完整網域名稱來參考),您可以在其中建立一或多個事件中樞。 視需要更新命名空間的名稱。
# Create an Event Hubs namespace. Specify a name for the Event Hubs namespace.
namespaceName="contosoehubns$RANDOM"
az eventhubs namespace create --name $namespaceName --resource-group $rgName -l $region
您會看到類似以下的輸出。 您會在 name
欄位中看到命名空間的名稱。
{
"createdAt": "2023-03-13T20:28:53.037Z",
"disableLocalAuth": false,
"id": "/subscriptions/0000000000-0000-0000-0000-0000000000000000/resourceGroups/contosorg32744/providers/Microsoft.EventHub/namespaces/contosoehubns17861",
"isAutoInflateEnabled": false,
"kafkaEnabled": true,
"location": "East US",
"maximumThroughputUnits": 0,
"metricId": "0000000000-0000-0000-0000-0000000000000000:contosoehubns17861",
"minimumTlsVersion": "1.2",
"name": "contosoehubns17861",
"provisioningState": "Succeeded",
"publicNetworkAccess": "Enabled",
"resourceGroup": "contosorg32744",
"serviceBusEndpoint": "https://contosoehubns17861.servicebus.windows.net:443/",
"sku": {
"capacity": 1,
"name": "Standard",
"tier": "Standard"
},
"status": "Active",
"tags": {},
"type": "Microsoft.EventHub/Namespaces",
"updatedAt": "2023-03-13T20:29:45.637Z",
"zoneRedundant": false
}
建立事件中樞
執行以下命令來建立事件中樞。 視需要更新事件中樞的名稱。
# Create an event hub. Specify a name for the event hub.
eventhubName="contosoehub$RANDOM"
az eventhubs eventhub create --name $eventhubName --resource-group $rgName --namespace-name $namespaceName
您會看到類似以下的輸出。 您會在 name
欄位中看到事件中樞的名稱。
{
"captureDescription": null,
"createdAt": "2023-03-13T20:32:04.457000+00:00",
"id": "/subscriptions/000000000-0000-0000-0000-00000000000000/resourceGroups/contosorg32744/providers/Microsoft.EventHub/namespaces/contosoehubns17861/eventhubs/contosoehub23255",
"location": "eastus",
"messageRetentionInDays": 7,
"name": "contosoehub23255",
"partitionCount": 4,
"partitionIds": [
"0",
"1",
"2",
"3"
],
"resourceGroup": "contosorg32744",
"status": "Active",
"systemData": null,
"type": "Microsoft.EventHub/namespaces/eventhubs",
"updatedAt": "2023-03-13T20:32:04.727000+00:00"
}
恭喜! 您已使用 Azure CLI 建立事件中樞命名空間和該命名空間內的事件中樞。
清除資源
如果您想保留此事件中樞,以便測試傳送和接收事件,請忽略本節。 否則,請執行下列命令來刪除資源群組。 此命令會刪除資源群組中的所有資源和資源群組本身。
az group delete --name $rgName
下一步
在本文中,您已建立資源群組、事件中樞命名空間和事件中樞。 如需將事件傳送至事件中樞或從事件中樞接收事件的逐步指示,請參閱傳送及接收事件教學課程: