Inicio rápido: Creación de un centro de eventos con una plantilla de Azure Resource ManagerQuickstart: Create an event hub by using an Azure Resource Manager template

Azure Event Hubs es una plataforma de streaming de macrodatos y servicio de ingesta de eventos de gran escalabilidad capaz de recibir y procesar millones de eventos por segundo.Azure Event Hubs is a Big Data streaming platform and event ingestion service, capable of receiving and processing millions of events per second. Event Hubs puede procesar y almacenar eventos, datos o telemetría generados por dispositivos y software distribuido.Event Hubs can process and store events, data, or telemetry produced by distributed software and devices. Los datos enviados a un centro de eventos se pueden transformar y almacenar con cualquier proveedor de análisis en tiempo real o adaptadores de procesamiento por lotes y almacenamiento.Data sent to an event hub can be transformed and stored using any real-time analytics provider or batching/storage adapters. Para más información sobre Event Hubs, consulte Introducción a Event Hubs y Características de Event Hubs.For detailed overview of Event Hubs, see Event Hubs overview and Event Hubs features.

En esta guía de inicio rápido, creará un centro de eventos mediante una plantilla de Azure Resource Manager.In this quickstart, you create an event hub by using an Azure Resource Manager template. Puede implementar una plantilla de Azure Resource Manager para crear un espacio de nombres de tipo Event Hubs, con un centro de eventos.You deploy an Azure Resource Manager template to create a namespace of type Event Hubs, with one event hub. El artículo muestra cómo definir los recursos que se implementan y los parámetros que se especifican cuando se ejecuta la implementación.The article shows how to define which resources are deployed and how to define parameters that are specified when the deployment is executed. Puede usar esta plantilla para sus propias implementaciones o personalizarla para satisfacer sus necesidades.You can use this template for your own deployments, or customize it to meet your requirements. Para información sobre la creación de plantillas, consulte Creación de plantillas de Azure Resource Manager.For information about creating templates, see Authoring Azure Resource Manager templates. Para la sintaxis y las propiedades de JSON que se usan en una plantilla, consulte Tipos de recursos de Microsoft.EventHub.For the JSON syntax and properties to use in a template, see Microsoft.EventHub resource types.

Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.If you don't have an Azure subscription, create a free account before you begin.

Creación de un centro de eventosCreate an event hub

En este inicio rápido se usa una plantilla de inicio rápido existente:In this quickstart, you use an existing quickstart template:

{
  "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "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",
      "allowedValues": [ "Basic", "Standard" ],
      "defaultValue": "Standard",
      "metadata": {
        "description": "Specifies the messaging tier for service Bus namespace."
      }
    }
  },
  "variables": {
    "eventHubNamespaceName": "[concat(parameters('projectName'), 'ns')]",
    "eventHubName": "[parameters('projectName')]"
  },
  "resources": [
    {
      "apiVersion": "2017-04-01",
      "type": "Microsoft.EventHub/namespaces",
      "name": "[variables('eventHubNamespaceName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('eventHubSku')]",
        "tier": "[parameters('eventHubSku')]",
        "capacity": 1
      },
      "properties": {
        "isAutoInflateEnabled": false,
        "maximumThroughputUnits": 0
      }
    },
    {
      "apiVersion": "2017-04-01",
      "type": "Microsoft.EventHub/namespaces/eventhubs",
      "name": "[concat(variables('eventHubNamespaceName'), '/', variables('eventHubName'))]",
      "location": "[parameters('location')]",
      "dependsOn": [
        "[resourceId('Microsoft.EventHub/namespaces', variables('eventHubNamespaceName'))]"
      ],
      "properties": {
        "messageRetentionInDays": 7,
        "partitionCount": 1
      }
    }
  ]
}

Para buscar más ejemplos de plantillas, consulte Plantillas de inicio rápido de Azure.To find more template samples, see Azure Quickstart Templates.

Para implementar la plantilla:To deploy the template:

  1. Seleccione Probar en el bloque de código siguiente y luego siga las instrucciones para iniciar sesión en Azure Cloud Shell.Select Try it from the following code block, and then follow the instructions to sign in to the 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/101-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 ..."
    

    Lleva algunos minutos crear un centro de eventos.It takes a few moments to create an event hub.

  2. Seleccione Copiar para copiar el script de PowerShell.Select Copy to copy the PowerShell script.

  3. Haga clic con el botón derecho en la consola del shell y seleccione Pegar.Right-click the shell console, and then select Paste.

Comprobar la implementaciónVerify the deployment

Para comprobar la implementación, puede abrir el grupo de recursos desde Azure Portal o usar el script de Azure PowerShell siguiente.To verify the deployment, you can either open the resource group from the Azure portal, or use the following Azure PowerShell script. Si Cloud Shell sigue abierto, no es necesario copiar ni ejecutar la primera línea (Read-Host).If the Cloud shell is still open, you don't need to copy/run the first line (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 ..."

Limpieza de recursosClean up resources

Cuando los recursos de Azure ya no sean necesarios, limpie los recursos que implementó eliminando el grupo de recursos.When the Azure resources are no longer needed, clean up the resources you deployed by deleting the resource group. Si Cloud Shell sigue abierto, no es necesario copiar ni ejecutar la primera línea (Read-Host).If the Cloud shell is still open, you don't need to copy/run the first line (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 ..."

Pasos siguientesNext steps

En este artículo, creo un espacio de nombres de Event Hubs y un centro de eventos en el espacio de nombres.In this article, you created an Event Hubs namespace, and an event hub in the namespace. Para encontrar instrucciones paso a paso sobre cómo enviar eventos a un centro de eventos o recibirlos de este, consulte los tutoriales sobre envío y recepción de eventos:For step-by-step instructions to send events to (or) receive events from an event hub, see the Send and receive events tutorials: