Partager via


Démarrage rapide : Créer et modifier un circuit ExpressRoute à l’aide d’Azure CLI

Cet démarrage rapide décrit comment créer un circuit Azure ExpressRoute à l’aide de l’interface de ligne de commande (CLI). Cet article vous montre également comment vérifier l'état, mettre à jour ou supprimer et déprovisionner un circuit.

Diagramme de l’environnement de déploiement de circuit ExpressRoute avec Azure CLI.

Prérequis

Azure Cloud Shell

Azure héberge Azure Cloud Shell, un environnement d’interpréteur de commandes interactif que vous pouvez utiliser dans votre navigateur. Vous pouvez utiliser Bash ou PowerShell avec Cloud Shell pour utiliser les services Azure. Vous pouvez utiliser les commandes préinstallées Cloud Shell pour exécuter le code de cet article sans avoir à installer quoi que ce soit dans votre environnement local.

Pour démarrer Azure Cloud Shell :

Option Exemple/Lien
Sélectionnez Essayer dans le coin supérieur droite d’un bloc de codes ou de commandes. La sélection de Essayer ne copie pas automatiquement le code ni la commande dans Cloud Shell. Capture d’écran présentant un exemple d’essai pour Azure Cloud Shell.
Accédez à https://shell.azure.com ou sélectionnez le bouton Lancer Cloud Shell pour ouvrir Cloud Shell dans votre navigateur. Bouton permettant de lancer Azure Cloud Shell.
Sélectionnez le bouton Cloud Shell dans la barre de menus en haut à droite du portail Azure. Capture d’écran présentant le bouton Cloud Shell dans le portail Azure.

Pour utiliser Azure Cloud Shell :

  1. Démarrez Cloud Shell.

  2. Sélectionnez le bouton Copier sur un bloc de codes (ou un bloc de commandes) pour copier le code ou la commande.

  3. Collez le code ou la commande dans la session Cloud Shell en sélectionnant Ctrl+Maj+V sur Windows et Linux ou en sélectionnant Cmd+Maj+V sur macOS.

  4. Sélectionnez Entrée pour exécuter le code ou la commande.

Création et approvisionnement d’un circuit ExpressRoute

Vous connecter à votre compte Azure et sélectionner votre abonnement

Pour commencer votre configuration, connectez-vous à votre compte Azure. Si vous utilisez l’option « Essayer » de Cloud Shell, vous êtes connecté automatiquement. Utilisez les exemples suivants pour faciliter votre connexion :

az login

Vérifiez les abonnements associés au compte.

az account list

Sélectionnez l’abonnement pour lequel vous souhaitez créer un circuit ExpressRoute.

az account set --subscription "<subscription ID>"

Récupérer la liste des fournisseurs, des emplacements et des bandes passantes pris en charge

Avant de créer un circuit ExpressRoute, vous avez besoin d’une liste des fournisseurs de services, des emplacements et des options de bande passante pris en charge. La commande d’interface CLI az network express-route list-service-providers retourne ces informations que vous utilisez dans les étapes ultérieures :

az network express-route list-service-providers

La réponse ressemble à ce qui suit :

[
  {
    "bandwidthsOffered": [
      {
        "offerName": "50Mbps",
        "valueInMbps": 50
      },
      {
        "offerName": "100Mbps",
        "valueInMbps": 100
      },
      {
        "offerName": "200Mbps",
        "valueInMbps": 200
      },
      {
        "offerName": "500Mbps",
        "valueInMbps": 500
      },
      {
        "offerName": "1Gbps",
        "valueInMbps": 1000
      },
      {
        "offerName": "2Gbps",
        "valueInMbps": 2000
      },
      {
        "offerName": "5Gbps",
        "valueInMbps": 5000
      },
      {
        "offerName": "10Gbps",
        "valueInMbps": 10000
      }
    ],
    "id": "/subscriptions//resourceGroups//providers/Microsoft.Network/expressRouteServiceProviders/",
    "location": null,
    "name": "AARNet",
    "peeringLocations": [
      "Melbourne",
      "Sydney"
    ],
    "provisioningState": "Succeeded",
    "resourceGroup": "",
    "tags": null,
    "type": "Microsoft.Network/expressRouteServiceProviders"
  },

Vérifiez la réponse pour voir si votre fournisseur de connectivité est référencé. Prenez note des éléments suivants, car vous en aurez besoin lors de la création d’un circuit :

  • Nom
  • PeeringLocations
  • BandwidthsOffered

Vous êtes maintenant prêt à créer un circuit ExpressRoute.

Création d’un circuit ExpressRoute

Important

Votre circuit ExpressRoute est facturé à partir de l’émission d'une clé de service. Effectuez cette opération quand le fournisseur de connectivité est prêt à approvisionner le circuit.

Si vous n’avez pas déjà un groupe de ressources, vous devez en créer un avant de créer votre circuit ExpressRoute. Vous pouvez créer un groupe de ressources à l’aide de la commande suivante :

az group create -n ExpressRouteResourceGroup -l "West US"

L’exemple suivant montre comment créer un circuit ExpressRoute de 200 Mb/s par le biais d’Equinix dans la Silicon Valley. Si vous utilisez un autre fournisseur et des paramètres différents, remplacez ces informations quand vous créez votre requête.

Assurez-vous que vous spécifiez le niveau de référence (SKU) et la famille de références corrects :

  • Le niveau de référence (SKU) détermine si un circuit ExpressRoute est Local, Standard ou Premium. Vous pouvez spécifier Local, *Standard ou Premium.
  • La famille de références détermine le type de facturation. Vous pouvez spécifier Metereddata pour un forfait de données limité, et Unlimiteddata pour un forfait de données illimitées. Vous pouvez modifier le type de facturation Metereddata en Unlimiteddata, mais que vous ne pouvez pas le modifier de Unlimiteddata en Metereddata. Un circuit Local est uniquement Unlimiteddata.

Votre circuit ExpressRoute est facturé à partir de l’émission d'une clé de service. Voici un exemple de demande pour une nouvelle clé de service :

az network express-route create --bandwidth 200 -n MyCircuit --peering-location "Silicon Valley" -g ExpressRouteResourceGroup --provider "Equinix" -l "West US" --sku-family MeteredData --sku-tier Standard

La réponse contient la clé de service.

Répertorier tous les circuits ExpressRoute

Pour obtenir la liste de tous les circuits ExpressRoute que vous avez créés, exécutez la commande az network express-route list. Vous pouvez récupérer ces informations à tout moment à l’aide de cette commande. Pour répertorier tous les circuits, effectuez l’appel sans paramètres.

az network express-route list

Votre clé de service apparaît dans le champ ServiceKey de la réponse.

"allowClassicOperations": false,
"authorizations": [],
"circuitProvisioningState": "Enabled",
"etag": "W/\"1262c492-ffef-4a63-95a8-a6002736b8c4\"",
"gatewayManagerEtag": null,
"id": "/subscriptions/81ab786c-56eb-4a4d-bb5f-f60329772466/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/MyCircuit",
"location": "westus",
"name": "MyCircuit",
"peerings": [],
"provisioningState": "Succeeded",
"resourceGroup": "ExpressRouteResourceGroup",
"serviceKey": "1d05cf70-1db5-419f-ad86-1ca62c3c125b",
"serviceProviderNotes": null,
"serviceProviderProperties": {
  "bandwidthInMbps": 200,
  "peeringLocation": "Silicon Valley",
  "serviceProviderName": "Equinix"
},
"serviceProviderProvisioningState": "NotProvisioned",
"sku": {
  "family": "UnlimitedData",
  "name": "Standard_MeteredData",
  "tier": "Standard"
},
"tags": null,
"type": "Microsoft.Network/expressRouteCircuits]

Vous pouvez obtenir une description détaillée de tous les paramètres en exécutant la commande avec le paramètre « -h ».

az network express-route list -h

Envoyer la clé de service à votre fournisseur de connectivité pour l’approvisionnement

« ServiceProviderProvisioningState » fournit des informations sur l’état actuel de l’approvisionnement du côté du fournisseur de service. Le statut indique l’état du côté Microsoft. Pour plus d’informations, consultez l’article sur les workflows.

Quand vous créez un circuit ExpressRoute, ce circuit affiche l’état suivant :

"serviceProviderProvisioningState": "NotProvisioned"
"circuitProvisioningState": "Enabled"

Le circuit passe à l’état suivant quand le fournisseur de connectivité l’active pour vous :

"serviceProviderProvisioningState": "Provisioning"
"circuitProvisioningState": "Enabled"

Pour être utilisé, le circuit ExpressRoute doit être dans l’état suivant :

"serviceProviderProvisioningState": "Provisioned"
"circuitProvisioningState": "Enabled

Vérifier régulièrement le statut et l’état de la clé du circuit

La vérification du statut et de l’état de la clé du service vous permet de savoir quand votre fournisseur a approvisionné votre circuit. Une fois le circuit configuré, ServiceProviderProvisioningState a la valeur Approvisionné, comme le montre l’exemple suivant :

az network express-route show --resource-group ExpressRouteResourceGroup --name MyCircuit

La réponse ressemble à ce qui suit :

"allowClassicOperations": false,
"authorizations": [],
"circuitProvisioningState": "Enabled",
"etag": "W/\"1262c492-ffef-4a63-95a8-a6002736b8c4\"",
"gatewayManagerEtag": null,
"id": "/subscriptions/81ab786c-56eb-4a4d-bb5f-f60329772466/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/MyCircuit",
"location": "westus",
"name": "MyCircuit",
"peerings": [],
"provisioningState": "Succeeded",
"resourceGroup": "ExpressRouteResourceGroup",
"serviceKey": "1d05cf70-1db5-419f-ad86-1ca62c3c125b",
"serviceProviderNotes": null,
"serviceProviderProperties": {
  "bandwidthInMbps": 200,
  "peeringLocation": "Silicon Valley",
  "serviceProviderName": "Equinix"
},
"serviceProviderProvisioningState": "NotProvisioned",
"sku": {
  "family": "UnlimitedData",
  "name": "Standard_MeteredData",
  "tier": "Standard"
},
"tags": null,
"type": "Microsoft.Network/expressRouteCircuits]

Créer votre configuration de routage

Pour obtenir des instructions pas à pas, consultez l’article Configuration du routage des circuits ExpressRoute pour créer et modifier des peerings de circuit.

Important

Ces instructions s’appliquent seulement aux circuits créés avec des fournisseurs de services proposant des services de connectivité de couche 2. Si vous utilisez un fournisseur de services proposant des services gérés de couche 3 (généralement un VPN IP, comme MPLS), votre fournisseur de connectivité configure et gère le routage pour vous.

Maintenant, vous devez lier un réseau virtuel à votre circuit ExpressRoute. Utilisez l’article sur la liaison de réseaux virtuels à des circuits ExpressRoute.

Modification d’un circuit ExpressRoute

Vous pouvez modifier certaines propriétés d'un circuit ExpressRoute sans affecter la connectivité. Vous pouvez apporter les modifications suivantes sans temps d'arrêt :

  • Vous pouvez activer ou désactiver le module complémentaire ExpressRoute Premium pour votre circuit ExpressRoute.
  • Vous pouvez augmenter la bande passante de votre circuit ExpressRoute à condition que la capacité disponible sur le port le permette. Cependant, la rétrogradation de la bande passante d’un circuit n’est pas prise en charge.
  • Vous pouvez remplacer le plan de mesure Données limitées par Données illimitées. Cependant, la modification du plan de limitation Données illimitées en Données limitées n’est pas pris en charge.
  • Vous pouvez activer et désactiver Autoriser les opérations classiques.

Pour plus d’informations sur les limites et les limitations, reportez-vous au FAQ ExpressRoute.

Pour activer le module complémentaire ExpressRoute Premium

Vous pouvez activer le module complémentaire ExpressRoute Premium pour votre circuit existant à l’aide de la commande suivante :

az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --sku-tier Premium

Les fonctionnalités du module complémentaire ExpressRoute Premium sont ainsi activées pour votre circuit. Nous commençons à vous facturer la fonctionnalité du module complémentaire Premium dès que la commande a été exécutée avec succès.

Pour désactiver le module complémentaire ExpressRoute Premium

Important

Cette opération peut échouer si vous utilisez des ressources supérieures à ce qui est autorisé pour le circuit standard.

Avant de désactiver le module complémentaire ExpressRoute Premium, comprenez les critères suivants :

  • Avant de passer du niveau Premium au niveau Standard, vous devez vérifier que le nombre de réseaux virtuels liés au circuit est inférieur à 10. Si vous ne le faites pas, votre demande de mise à jour échoue et nous appliquons les tarifs Premium.
  • Tous les réseaux virtuels dans d’autres régions géopolitiques doivent préalablement être dissociés. Si vous ne supprimez pas le lien, votre demande de mise à jour échoue et nous continuons de vous facturer aux tarifs Premium.
  • Pour le peering privé, votre table de routage doit comporter moins de 4 000 routages. Si elle contient plus de 4 000 routages, la session BGP est supprimée. Cette session n’est réactivée qu’une fois le nombre de préfixes publiés repassé sous la barre des 4 000.

Vous pouvez désactiver le module complémentaire ExpressRoute Premium dans votre circuit existant à l’aide de l’exemple suivant :

az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --sku-tier Standard

Pour mettre à jour la bande passante d’un circuit ExpressRoute

Pour connaître les options de bande passante prises en charge par votre fournisseur, consultez le FAQ ExpressRoute. Vous pouvez choisir n'importe quelle taille supérieure à la taille de votre circuit existant.

Important

Vous devrez peut-être recréer le circuit ExpressRoute si la capacité sur le port existant est inappropriée. Vous ne pouvez pas mettre le circuit à niveau si aucune capacité supplémentaire n’est disponible à cet emplacement.

Vous ne pouvez pas réduire la bande passante d’un circuit ExpressRoute sans interrompre le service. Le fait de passer à un niveau inférieur de bande passante vous oblige à déprovisionner le circuit ExpressRoute, puis à réapprovisionner un nouveau circuit ExpressRoute.

Une fois que vous avez décidé de la taille dont vous avez besoin, utilisez la commande suivante pour redimensionner votre circuit :

az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --bandwidth 1000

Votre circuit est mis à niveau côté Microsoft. Vous devrez ensuite contacter votre fournisseur de connectivité pour qu’il mette à jour les configurations de son côté afin de refléter cette modification. Une fois cette modification apportée, nous commençons à vous facturer pour l’option de bande passante mise à jour.

Pour modifier la référence de limité à illimité

Vous pouvez modifier la référence SKU d'un circuit ExpressRoute à l'aide de l'exemple suivant :

az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --sku-family UnlimitedData

Pour contrôler l'accès aux environnements classique et Resource Manager

Consultez les instructions dans Transférer des circuits ExpressRoute du modèle de déploiement classique vers le modèle de déploiement Resource Manager.

Déprovisionnement d’un circuit ExpressRoute

Pour déprovisionner et supprimer un circuit ExpressRoute, veillez à bien comprendre les critères suivants :

  • Vous devez dissocier tous les réseaux virtuels du circuit ExpressRoute. Si cette opération échoue, vérifiez si certains de vos réseaux virtuels sont liés au circuit.
  • Si l’état d’approvisionnement du fournisseur de services du circuit ExpressRoute est En cours d’approvisionnement ou Approvisionné, vous devez vous mettre en relation avec votre fournisseur de services pour annuler l’approvisionnement du circuit de son côté. Nous continuons à réserver des ressources et à vous facturer jusqu’à ce que le fournisseur de services termine le désapprovisionnement du circuit et nous en avertisse.
  • Si le fournisseur de services a déprovisionné le circuit, ce qui signifie que l’état d’approvisionnement du fournisseur de services est défini sur Non approvisionné, vous pouvez supprimer le circuit. Cette opération arrête la facturation du circuit.

Nettoyer les ressources

Vous pouvez supprimer votre circuit ExpressRoute en exécutant la commande suivante :

az network express-route delete  -n MyCircuit -g ExpressRouteResourceGroup

Étapes suivantes

Une fois que vous avez créé votre circuit et l’avez approvisionné avec votre fournisseur, passez à l’étape suivante pour configurer l’homologation :