快速入門：使用 Azure CLI 建立事件中樞

發行項
03/04/2024

在此快速入門中，您將使用 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

下一步

在本文中，您已建立資源群組、事件中樞命名空間和事件中樞。如需將事件傳送至事件中樞或從事件中樞接收事件的逐步指示，請參閱傳送及接收事件教學課程：

共用方式為