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
Usare l'ambiente Bash in Azure Cloud Shell. Per ulteriori informazioni, vedere Avvio rapido per Bash in Azure Cloud Shell.
Se si preferisce eseguire i comandi di riferimento dell'interfaccia della riga di comando in locale, installare l'interfaccia della riga di comando di Azure. Per l'esecuzione in Windows o macOS, è consigliabile eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker. Per ulteriori informazioni, vedere Come eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker.
Se si usa un'installazione locale, accedere all'interfaccia della riga di comando di Azure con il comando az login. Per completare il processo di autenticazione, seguire la procedura visualizzata nel terminale. Per altre opzioni di accesso, vedere Accedere tramite l'interfaccia della riga di comando di Azure.
Quando richiesto, installare l'estensione dell'interfaccia della riga di comando di Azure al primo utilizzo. Per altre informazioni sulle estensioni, vedere Usare le estensioni con l'interfaccia della riga di comando di Azure.
Eseguire az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, eseguire az upgrade.
- 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: