Présentation

Pour utiliser le service de métadonnées sous Windows, vous devez configurer une route par défaut vers une adresse locale pour les métadonnées. Pour ce faire, vous devez localiser l'adresse IP de la passerelle par défaut, puis ajouter une route vers l'adresse locale du lien. Après cette configuration initiale, vous pouvez effectuer des demandes d'API pour accéder aux métadonnées.

Les informations contenues dans cette rubrique sont présentées sous forme d'étapes distinctes. Vous pouvez configurer un processus d'automatisation cloudbaseinit qui effectue toutes les étapes en un seul processus. Les exemples présentés servent à illustrer ce dont vous avez besoin, mais vous pouvez utiliser d'autres méthodes pour obtenir la passerelle par défaut et ajouter la route.

Etape 1 - Localiser l'adresse IP de la passerelle par défaut

En tant qu'administrateur, localisez l'adresse IP de la passerelle par défaut. Un moyen pratique consiste à utiliser la commande Powershell Get-NetRoute.

Localisez l'IP de la passerelle par défaut à l'aide de la cmdlet PowerShell Get-NetRoute. Cette commande permet d'obtenir le saut suivant pour la route par défaut, également connu sous le nom de passerelle par défaut. Pour plus d'informations, voir la documentation Windows Powershell pour Get-NetRoute.

À partir du terminal Windows, l'exemple suivant invoque la commande Powershell Get-NetRoute pour obtenir les itinéraires IP par défaut et transmettre les itinéraires à la cmdlet SelectObject, qui affiche ensuite la propriété NextHop pour chaque itinéraire par défaut.

C:\> powershell "Get-NetRoute -DestinationPrefix "0.0.0.0/0" | Select-Object -ExpandProperty "NextHop""

La première adresse IP récupérée est la route par défaut. Placez la sortie dans une variable.

Etape 2 - Ajouter une route vers la passerelle par défaut

Le service de métadonnées utilise une adresse locale de liaison ( 169.254.169.254 ) pour établir l'accès au service et récupérer les métadonnées de l'instance.

Configurez la route par défaut afin que l'adresse locale puisse atteindre la passerelle par défaut. Depuis le terminal Windows ou Powershell, vous devez spécifier :

C:> route -p add 169.254.169.254 MASK 255.255.255.255 $DEFAULT_GATEWAY

L'exemple de code suivant provient d'un script d'automatisation Python:

command = 'route -p add 169.254.169.254 MASK 255.255.255.255 ()'.format(default_gateway)

Ces exemples utilisent la commande route, mais vous pouvez également utiliser la commande Powershell New-NetRoute et créer l'itinéraire en une seule commande. Pour combiner les étapes 1 et 2 en une seule commande, vous pouvez spécifier :

C:\> powershell "Get-NetRoute -DestinationPrefix "0.0.0.0/0" | Select-Object -ExpandProperty "NextHop" | New-NetRoute"

Pour ajouter des routes, vous devez vous connecter en tant qu'administrateur sur le serveur Windows.

Étape 3 : Récupération programmée des métadonnées

Après avoir ajouté une route à la passerelle par défaut, vous pouvez accéder aux métadonnées en utilisant l'adresse locale du lien. Construisez votre script d'automatisation en utilisant l'outil de votre choix pour transférer des données sur le réseau, tel que curl.

Pour consulter les commandes curl permettant d'invoquer l'API du service de métadonnées et de récupérer des données, voir Récupération de métadonnées à partir d'une instance.