Freigeben über

Schnellstart: Erstellen eines Event Hubs mithilfe der Azure CLI

In diesem Schnellstart erstellen Sie einen Event Hub mit der Azure CLI.

Wenn Sie nicht über ein Azure-Konto verfügen, erstellen Sie ein kostenloses Konto , bevor Sie beginnen.

Voraussetzungen

  • Für diesen Artikel ist mindestens Version 2.0.4 der Azure CLI erforderlich. Bei Verwendung von Azure Cloud Shell ist die aktuelle Version bereits installiert.

Erstellen einer Ressourcengruppe

Führen Sie den folgenden Befehl aus, um eine Ressourcengruppe zu erstellen. Eine Ressourcengruppe ist eine logische Sammlung mit Azure-Ressourcen. Alle Ressourcen werden in einer Ressourcengruppe bereitgestellt und verwaltet.

Wählen Sie Kopieren aus, um den Befehl zu kopieren, fügen Sie ihn in das Cloud Shell- oder CLI-Fenster ein, und führen Sie ihn aus. Aktualisieren Sie den Namen der Ressourcengruppe und die Region, wenn Sie möchten.

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

Daraufhin wird die Ausgabe angezeigt, die in etwa wie folgt aussieht. Der Ressourcengruppenname wird im Feld name angezeigt, wobei $RANDOM durch eine zufällige Zahl ersetzt wird.

{
  "id": "/subscriptions/0000000000-0000-0000-0000-000000000000000/resourceGroups/contosorg32744",
  "location": "eastus",
  "managedBy": null,
  "name": "contosorg32744",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null,
  "type": "Microsoft.Resources/resourceGroups"
}

Erstellen eines Event Hubs-Namespace

Führen Sie den folgenden Befehl aus, um einen Event Hubs-Namespace zu erstellen. Ein Event Hubs-Namespace stellt einen eindeutigen Bereichscontainer bereit, auf den über den vollqualifizierten Domänennamen verwiesen wird und in dem Sie mindestens einen Event Hub erstellen. Aktualisieren Sie den Namen des Namespace, wenn Sie möchten.

# 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

Daraufhin wird die Ausgabe angezeigt, die in etwa wie folgt aussieht. Der Name des Namespace wird im Feld name angezeigt.

{
  "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
}

Erstellen eines Ereignis-Hubs

Führen Sie den folgenden Befehl aus, um einen Event Hub zu erstellen. Aktualisieren Sie den Namen des Event Hubs, wenn Sie möchten.

# 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

Daraufhin wird die Ausgabe angezeigt, die in etwa wie folgt aussieht. Der Name des Event Hubs wird im Feld name angezeigt.

{
  "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"
}

Herzlichen Glückwunsch! Sie haben die Azure CLI verwendet, um einen Event Hubs-Namespace und einen darin enthaltenen Event Hub zu erstellen.

Bereinigen von Ressourcen

Wenn Sie diesen Event Hub beibehalten möchten, damit Sie das Senden und Empfangen von Ereignissen testen können, ignorieren Sie diesen Abschnitt. Führen Sie andernfalls den folgenden Befehl aus, um die Ressourcengruppe zu löschen. Dieser Befehl löscht alle Ressourcen in der Ressourcengruppe und die Ressourcengruppe selbst.

az group delete --name $rgName

Nächste Schritte

In diesem Artikel haben Sie eine Ressourcengruppe, einen Event Hubs-Namespace und einen Event Hub erstellt. Schritt-für-Schritt-Anleitungen zum Senden von Ereignissen an einen Event Hub oder Empfangen von Ereignissen von einem Event Hub finden Sie in den Tutorials zum Senden und Empfangen von Ereignissen:

  • Last updated on