Creare uno spazio dei nomi Hub eventi con hub eventi e gruppo di consumer usando il modello di Azure Resource ManagerCreate an Event Hubs namespace with event hub and consumer group using an Azure Resource Manager template

Questo articolo illustra come usare un modello di Azure Resource Manager per creare uno spazio dei nomi di tipo Hub eventi con un hub eventi e un gruppo di consumer.This article shows how to use an Azure Resource Manager template to create a namespace of type Event Hubs, with one event hub and one consumer group. L'articolo descrive come definire le risorse da distribuire e i parametri specificati quando viene eseguita la distribuzione.The article shows how to define which resources are deployed and how to define parameters that are specified when the deployment is executed. È possibile usare questo modello per le proprie distribuzioni o personalizzarlo in base alle esigenze.You can use this template for your own deployments, or customize it to meet your requirements.

Per informazioni sulla creazione dei modelli, vedere Creazione di modelli di Azure Resource Manager.For information about creating templates, see Authoring Azure Resource Manager templates.

Per il modello completo, vedere il modello di Hub eventi e gruppo di consumer in GitHub.For the complete template, see the Event hub and consumer group template on GitHub.

Nota

Per verificare gli ultimi modelli, vedere la raccolta Modelli di avvio rapido di Azure e cercare Hub eventi.To check for the latest templates, visit the Azure Quickstart Templates gallery and search for Event Hubs.

DistribuzioneWhat will you deploy?

Questo modello consente di distribuire uno spazio dei nomi di Hub eventi con un hub eventi e un gruppo di consumer.With this template, you deploy an Event Hubs namespace with an event hub and a consumer group.

Per eseguire automaticamente la distribuzione, fare clic sul pulsante seguente:To run the deployment automatically, click the following button:

Distribuzione in AzureDeploy to Azure

ParametriParameters

Gestione risorse di Azure permette di definire i parametri per i valori da specificare durante la distribuzione del modello.With Azure Resource Manager, you define parameters for values you want to specify when the template is deployed. Il modello include una sezione denominata Parameters che contiene tutti i valori dei parametri.The template includes a section called Parameters that contains all the parameter values. È opportuno definire un parametro per i valori che varieranno, in base al progetto che si sta distribuendo o all'ambiente in cui si esegue la distribuzione.You should define a parameter for values that will vary, based on the project you are deploying or based on the environment to which you are deploying. Non definire i parametri per i valori che rimangono invariati.Do not define parameters for values that always stay the same. Ogni valore di parametro nel modello definisce le risorse distribuite.Each parameter value in the template defines the resources that are deployed.

Il modello definisce i parametri seguenti:The template defines the following parameters:

eventHubNamespaceNameeventHubNamespaceName

Nome dello spazio dei nomi dell'hub eventi da creare.The name of the Event Hubs namespace to create.

"eventHubNamespaceName": {
"type": "string"
}

eventHubNameeventHubName

Nome dell'hub eventi creato nello spazio dei nomi di Hub eventi.The name of the event hub created in the Event Hubs namespace.

"eventHubName": {
"type": "string"
}

eventHubConsumerGroupNameeventHubConsumerGroupName

Nome del gruppo di consumer creato per l'hub eventi.The name of the consumer group created for the event hub.

"eventHubConsumerGroupName": {
"type": "string"
}

apiVersionapiVersion

Versione API del modello.The API version of the template.

"apiVersion": {
"type": "string"
}

Risorse da distribuireResources to deploy

Crea uno spazio dei nomi di tipo EventHubscon un hub eventi e un gruppo di consumer:Creates a namespace of type EventHubs, with an event hub and a consumer group:

"resources":[  
      {  
         "apiVersion":"[variables('ehVersion')]",
         "name":"[parameters('namespaceName')]",
         "type":"Microsoft.EventHub/namespaces",
         "location":"[variables('location')]",
         "sku":{  
            "name":"Standard",
            "tier":"Standard"
         },
         "resources":[  
            {  
               "apiVersion":"[variables('ehVersion')]",
               "name":"[parameters('eventHubName')]",
               "type":"EventHubs",
               "dependsOn":[  
                  "[concat('Microsoft.EventHub/namespaces/', parameters('namespaceName'))]"
               ],
               "properties":{  
                  "path":"[parameters('eventHubName')]"
               },
               "resources":[  
                  {  
                     "apiVersion":"[variables('ehVersion')]",
                     "name":"[parameters('consumerGroupName')]",
                     "type":"ConsumerGroups",
                     "dependsOn":[  
                        "[parameters('eventHubName')]"
                     ],
                     "properties":{  

                     }
                  }
               ]
            }
         ]
      }
   ],

Comandi per eseguire la distribuzioneCommands to run deployment

Per distribuire le risorse in Azure, è necessario aver eseguito l'accesso all'account Azure e usare il modulo Azure Resource Manager.To deploy the resources to Azure, you must be signed in to your Azure account and you must use the Azure Resource Manager module. Per altre informazioni su come usare Gestione risorse di Azure con Azure PowerShell o l'interfaccia della riga di comando di Azure, vedere:To learn about using Azure Resource Manager with either Azure PowerShell or Azure CLI, see:

Gli esempi seguenti presuppongono che nell'account sia già stato creato un gruppo di risorse con il nome specificato.The following examples assume you already have a resource group in your account with the specified name.

PowerShellPowerShell

New-AzureRmResourceGroupDeployment -ResourceGroupName \<resource-group-name\> -TemplateFile https://raw.githubusercontent.com/azure/azure-quickstart-templates/master/201-event-hubs-create-event-hub-and-consumer-group/azuredeploy.json

Interfaccia della riga di comando di AzureAzure CLI

azure config mode arm

azure group deployment create \<my-resource-group\> \<my-deployment-name\> --template-uri [https://raw.githubusercontent.com/azure/azure-quickstart-templates/master/201-event-hubs-create-event-hub-and-consumer-group/azuredeploy.json][]

Passaggi successiviNext steps

Per ulteriori informazioni su Hub eventi visitare i collegamenti seguenti:You can learn more about Event Hubs by visiting the following links: