Snelstart: Een event hub maken met behulp van de Azure CLI
In deze quickstart maakt u een Event Hub met behulp van Azure CLI.
Als u geen Azure-abonnement hebt, kunt u een gratis Azure-account maken voordat u begint.
Vereisten
Gebruik de Bash-omgeving in Azure Cloud Shell. Zie quickstart voor Bash in Azure Cloud Shell voor meer informatie.
Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren. Als u in Windows of macOS werkt, kunt u Azure CLI uitvoeren in een Docker-container. Zie De Azure CLI uitvoeren in een Docker-container voor meer informatie.
Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met behulp van de opdracht az login. Volg de stappen die worden weergegeven in de terminal, om het verificatieproces te voltooien. Raadpleeg Aanmelden bij Azure CLI voor aanvullende aanmeldingsopties.
Installeer de Azure CLI-extensie bij het eerste gebruik, wanneer u hierom wordt gevraagd. Raadpleeg Extensies gebruiken met Azure CLI voor meer informatie over extensies.
Voer az version uit om de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Voer az upgrade uit om te upgraden naar de nieuwste versie.
- Voor dit artikel is versie 2.0.4 of hoger van Azure CLI vereist. Als u Azure Cloud Shell gebruikt, is de nieuwste versie al geïnstalleerd.
Een brongroep maken
Voer de volgende opdracht uit om een resourcegroep te maken. Een resourcegroep is een logische verzameling Azure-resources. Alle resources worden geïmplementeerd en beheerd in een resourcegroep.
Selecteer Kopiëren om de opdracht te kopiëren en in het Cloud Shell- of CLI-venster te plakken en uit te voeren. Werk desgewenst de naam van de resourcegroep en de regio bij.
rgName="contosorg$RANDOM"
region="eastus"
az group create --name $rgName --location $region
U ziet de uitvoer die vergelijkbaar is met de volgende uitvoer. U ziet de naam van de resourcegroep in het name veld door een willekeurig getal te $RANDOMvervangen.
{
"id": "/subscriptions/0000000000-0000-0000-0000-000000000000000/resourceGroups/contosorg32744",
"location": "eastus",
"managedBy": null,
"name": "contosorg32744",
"properties": {
"provisioningState": "Succeeded"
},
"tags": null,
"type": "Microsoft.Resources/resourceGroups"
}
Een Event Hubs-naamruimte maken
Voer de volgende opdracht uit om een Event Hubs-naamruimte te maken. Een Event Hubs-naamruimte biedt een unieke scopingcontainer, waarnaar wordt verwezen met de volledig gekwalificeerde domeinnaam (FQDN), waarin u een of meer Event Hubs maakt. Werk desgewenst de naam van de naamruimte bij.
# 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
U ziet de uitvoer die vergelijkbaar is met de volgende uitvoer. U ziet de naam van de naamruimte in het name veld.
{
"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
}
Een Event Hub maken
Voer de volgende opdracht uit om een Event Hub te maken. Werk desgewenst de naam van de Event Hub bij.
# 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
U ziet de uitvoer die vergelijkbaar is met de volgende uitvoer. U ziet de naam van de Event Hub in het name veld.
{
"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"
}
Gefeliciteerd! U hebt Azure CLI gebruikt om een Event Hubs-naamruimte te maken en om binnen deze naamruimte een Event Hub te maken.
Resources opschonen
Als u deze Event Hub wilt behouden zodat u het verzenden en ontvangen van gebeurtenissen kunt testen, negeert u deze sectie. Voer anders de volgende opdracht uit om de resourcegroep te verwijderen. Met deze opdracht worden alle resources in de resourcegroep en de resourcegroep zelf verwijderd.
az group delete --name $rgName
Volgende stappen
In dit artikel hebt u een resourcegroep, een Event Hubs-naamruimte en een Event Hub gemaakt. Zie de zelfstudies Gebeurtenissen verzenden en ontvangen voor stapsgewijze instructies voor het verzenden van gebeurtenissen naar of ontvangen van gebeurtenissen vanuit een Event Hub: