快速入門：使用ARM範本建立事件中樞

發行項
03/08/2024

在本快速入門中，您會使用 Azure Resource Manager 範本（ARM 範本）建立事件中樞。您可以部署 ARM 範本，以建立事件中樞類型的命名空間，以及一個事件中樞。

必要條件

如果您沒有 Azure 訂用帳戶，請在開始前建立免費帳戶。
如果您不熟悉 Azure 事件中樞，請參閱事件中樞概觀和事件中樞功能。

檢閱範本

本快速入門中使用的範本是來自 Azure 快速入門範本。

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.5.6.12127",
      "templateHash": "16940368634879422816"
    }
  },
  "parameters": {
    "projectName": {
      "type": "string",
      "metadata": {
        "description": "Specifies a project name that is used to generate the Event Hub name and the Namespace name."
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Specifies the Azure location for all resources."
      }
    },
    "eventHubSku": {
      "type": "string",
      "defaultValue": "Standard",
      "allowedValues": [
        "Basic",
        "Standard"
      ],
      "metadata": {
        "description": "Specifies the messaging tier for Event Hub Namespace."
      }
    }
  },
  "variables": {
    "eventHubNamespaceName": "[format('{0}ns', parameters('projectName'))]",
    "eventHubName": "[parameters('projectName')]"
  },
  "resources": [
    {
      "type": "Microsoft.EventHub/namespaces",
      "apiVersion": "2021-11-01",
      "name": "[variables('eventHubNamespaceName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('eventHubSku')]",
        "tier": "[parameters('eventHubSku')]",
        "capacity": 1
      },
      "properties": {
        "isAutoInflateEnabled": false,
        "maximumThroughputUnits": 0
      }
    },
    {
      "type": "Microsoft.EventHub/namespaces/eventhubs",
      "apiVersion": "2021-11-01",
      "name": "[format('{0}/{1}', variables('eventHubNamespaceName'), variables('eventHubName'))]",
      "properties": {
        "messageRetentionInDays": 7,
        "partitionCount": 1
      },
      "dependsOn": [
        "[resourceId('Microsoft.EventHub/namespaces', variables('eventHubNamespaceName'))]"
      ]
    }
  ]
}

樣本中定義的資源包括：

若要尋找更多範本範例，請參閱 Azure 快速入門範本。

部署範本

使用 Azure 入口網站用戶介面

如果您的環境符合必要條件，而且您很熟悉 ARM 範本，請選取 [部署至 Azure] 按鈕。範本會在 Azure 入口網站中開啟。
選取現有的 資源群組或建立資源群組 ，然後加以選取。
選取區域。
輸入專案的唯一名稱。 此名稱可用來產生命名空間中事件中樞命名空間和事件中樞的名稱。
選取 [檢閱 + 建立]。
在 [檢閱 + 建立] 頁面上，選取 [建立]。

使用 Azure Cloud Shell

若要使用 Azure Cloud Shell 部署範本：

從下列程式代碼區塊選取 [ 開啟 Cloud Shell ]，然後依照指示登入 Azure Cloud Shell。

$projectName = Read-Host -Prompt "Enter a project name that is used for generating resource names"
$location = Read-Host -Prompt "Enter the location (i.e. centralus)"
$resourceGroupName = "${projectName}rg"
$templateUri = "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.eventhub/eventhubs-create-namespace-and-eventhub/azuredeploy.json"

New-AzResourceGroup -Name $resourceGroupName -Location $location
New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -TemplateUri $templateUri -projectName $projectName

Write-Host "Press [ENTER] to continue ..."

建立事件中樞需要幾分鐘的時間。

選取 [複製] 來複製 PowerShell 指令碼。
以滑鼠右鍵按一下殼層主控台，然後選取 [貼上]。
按 ENTER 鍵以執行命令。

驗證部署

若要確認部署，您可以從 Azure 入口網站開啟資源群組，或使用下列 Azure PowerShell 腳本。如果 Cloud Shell 仍然開啟，您就不需要複製/執行第一行（讀取主機）。

$projectName = Read-Host -Prompt "Enter the same project name that you used in the last procedure"
$resourceGroupName = "${projectName}rg"
$namespaceName = "${projectName}ns"

Get-AzEventHub -ResourceGroupName $resourceGroupName -Namespace $namespaceName

Write-Host "Press [ENTER] to continue ..."

清除資源

不再需要 Azure 資源時，可藉由刪除資源群組來清除您所部署的資源。如果 Cloud Shell 仍然開啟，您就不需要複製/執行第一行（讀取主機）。

$projectName = Read-Host -Prompt "Enter the same project name that you used in the last procedure"
$resourceGroupName = "${projectName}rg"

Remove-AzResourceGroup -ResourceGroupName $resourceGroupName

Write-Host "Press [ENTER] to continue ..."

下一步

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