Condividi tramite

Guida introduttiva: Creare un hub eventi usando un modello ARM

In questa guida rapida, si crea un hub eventi usando un modello Azure Resource Manager (modello ARM). Il modello di Resource Manager viene distribuito per creare uno spazio dei nomi di tipo Hub eventi con un hub eventi.

Prerequisiti

Rivedere il modello

Il modello usato in questo avvio rapido proviene dai modelli di avvio rapido di 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'))]"
      ]
    }
  ]
}

Le risorse definite nel modello includono:

Per altri esempi di modelli, vedere Modelli di avvio rapido di Azure.

Implementare il modello

Uso dell'interfaccia utente del portale di Azure

  1. Se l'ambiente soddisfa i prerequisiti e si ha familiarità con l'uso dei modelli di Resource Manager, selezionare il pulsante Distribuisci in Azure. Il modello viene visualizzato nel portale di Azure.

    Pulsante per distribuire il modello di Resource Manager in Azure.

  2. Selezionare un gruppo di risorse esistente o crearne uno e selezionarlo.

  3. Selezionare l'area.

  4. Immettere un nome univoco per il progetto. Questo nome viene utilizzato per generare nomi per uno spazio dei nomi di Hub eventi e un hub eventi all'interno dello spazio dei nomi.

  5. Selezionare Rivedi e crea.

  6. Nella pagina Rivedi e crea selezionare Crea.

Utilizzo di Azure Cloud Shell

Per distribuire il modello usando Azure Cloud Shell:

  1. Selezionare Open Cloud Shell (Apri Cloud Shell ) dal blocco di codice seguente e quindi seguire le istruzioni per accedere ad 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 ..."

    La creazione di un hub eventi richiede alcuni istanti.

  2. Selezionare Copia per copiare lo script di PowerShell.

  3. Fare clic con il pulsante destro del mouse sulla console della shell e quindi scegliere Incolla.

  4. Premere INVIO per eseguire i comandi.

Convalidare la distribuzione

Per verificare la distribuzione, è possibile aprire il gruppo di risorse dal portale di Azure oppure usare lo script di Azure PowerShell seguente. Se Cloud Shell è ancora aperto, non è necessario copiare/eseguire la prima riga (Read-Host).

$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 ..."

Pulire le risorse

Quando le risorse di Azure non sono più necessarie, pulire le risorse distribuite eliminando il gruppo di risorse. Se Cloud Shell è ancora aperto, non è necessario copiare/eseguire la prima riga (Read-Host).

$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 ..."

Passaggi successivi

In questo articolo è stato creato uno spazio dei nomi Hub eventi e un hub eventi nello spazio dei nomi. Per istruzioni dettagliate relative all'invio o alla ricezione di eventi da un hub eventi, vedere le esercitazioni per l'invio e la ricezione di eventi:

  • Last updated on