Partage via


Démarrage rapide : créer un Event Hub à l’aide d’Azure CLI

Dans ce démarrage rapide, vous créez un Event Hub à l’aide d’Azure CLI.

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit Azure avant de commencer.

Prérequis

  • Cet article nécessite la version 2.0.4 ou ultérieure de l’interface Azure CLI. Si vous utilisez Azure Cloud Shell, la version la plus récente est déjà installée.

Créer un groupe de ressources

Exécutez la commande suivante pour créer un groupe de ressources. Un groupe de ressources est une collection logique de ressources Azure. Toutes les ressources sont déployées et gérées dans un groupe de ressources.

Sélectionnez Copier pour copier la commande, collez-la dans la fenêtre Cloud Shell ou CLI, puis exécutez-la. Mettez à jour le nom du groupe de ressources et la région si vous le souhaitez.

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

Vous voyez une sortie similaire à la suivante. Vous voyez le nom du groupe de ressources dans le champ name avec un nombre aléatoire remplaçant $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"
}

Créer un espace de noms Event Hubs

Exécutez la commande suivante pour créer un espace de noms Event Hub. Un espace de noms Event Hubs fournit un conteneur d’étendue unique, référencé par son nom de domaine complet, dans lequel vous créez un ou plusieurs hubs d’événements. Mettez à jour le nom de l’espace de noms si vous le souhaitez.

# 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

Vous voyez une sortie similaire à la suivante. Le nom de l’espace de noms s’affiche dans le champ 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
}

Créer un hub d’événements

Exécutez la commande suivante pour créer un Event Hub. Mettez à jour le nom du hub d’événements si vous le souhaitez.

# 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

Vous voyez une sortie similaire à la suivante. Le nom du hub d’événements apparaît dans le champ 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"
}

Félicitations ! Vous avez utilisé Azure CLI pour créer un espace de noms Event Hubs, ainsi qu’un Event Hub dans cet espace de noms.

Nettoyer les ressources

Si vous souhaitez conserver ce hub d’événements afin de pouvoir tester l’envoi et la réception d’événements, ignorez cette section. Sinon, exécutez la commande suivante pour supprimer le groupe de ressources. Cette commande supprime toutes les ressources de ce groupe de ressources et le groupe de ressources lui-même.

az group delete --name $rgName

Étapes suivantes

Dans cet article, vous avez créé un groupe de ressources, un espace de noms Event Hubs et un Event Hub. Pour obtenir des instructions pas à pas sur l’envoi d’événements à un hub d’événements ou leur réception à partir d’un hub d’événements, consultez les tutoriels Envoyer et recevoir des événements :