Guida introduttiva: Creare un hub eventi usando l'interfaccia della riga di comando di Azure

In questo avvio rapido viene creato un hub eventi usando l'interfaccia della riga di comando di Azure.

Se non si ha una sottoscrizione di Azure, creare un account Azure gratuito prima di iniziare.

Prerequisiti

  • Questo articolo richiede l'interfaccia della riga di comando di Azure versione 2.0.4 o successiva. Se si usa Azure Cloud Shell, la versione più recente è già installata.

Creare un gruppo di risorse

Eseguire il comando seguente per creare un gruppo di risorse. Un gruppo di risorse è una raccolta logica di risorse di Azure. Tutte le risorse vengono distribuite e gestite in un gruppo di risorse.

Selezionare Copia per copiare il comando e incollarlo nella finestra di Cloud Shell o dell'interfaccia della riga di comando ed eseguirlo. Aggiornare il nome del gruppo di risorse e l'area, se si desidera.

rgName="contosorg$RANDOM"
region="eastus"
az group create --name $rgName --location $region

Viene visualizzato l’output simile al seguente. Il nome del gruppo di risorse viene visualizzato nel campo name con un numero casuale che sostituisce $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"
}

Creare uno spazio dei nomi di Hub eventi

Eseguire il comando seguente per creare uno spazio dei nomi di Hub eventi. Uno spazio dei nomi di Hub eventi specifica un contenitore di ambito univoco, a cui fa riferimento il nome di dominio completo, in cui si crea uno o più hub eventi. Aggiornare il nome dello spazio dei nomi, se si desidera.

# 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

Viene visualizzato l’output simile al seguente. Il nome dello spazio dei nomi viene visualizzato nel campo 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
}

Creare un hub eventi

Eseguire il comando seguente per creare un hub eventi. Aggiornare il nome dell’hub eventi, se si desidera.

# 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

Viene visualizzato l’output simile al seguente. Il nome dell'hub eventi viene visualizzato nel campo 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"
}

Complimenti. È stata usata l'interfaccia della riga di comando di Azure per creare uno spazio dei nomi di Hub eventi e un hub eventi nello spazio dei nomi.

Pulire le risorse

Se si vuole mantenere questo hub eventi in modo che sia possibile testare l'invio e la ricezione di eventi, ignorare questa sezione. Diversamente, eseguire il comando seguente per eliminare il gruppo di risorse. Questo comando elimina tutte le risorse nel gruppo di risorse e il gruppo di risorse stesso.

az group delete --name $rgName

Passaggi successivi

In questo articolo è stato creato un gruppo di risorse, uno spazio dei nomi Hub eventi e un hub eventi. 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: