Suivez les instructions de cette page pour afficher les interfaces réseau, les réseaux, les sous-réseaux et les adresses IP d'une instance de calcul.
Avant de commencer
-
Si ce n'est pas déjà fait, configurez l'authentification.
L'authentification est le processus permettant de valider votre identité pour accéder aux services et aux API Trusted Cloud by S3NS .
Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine en sélectionnant l'une des options suivantes :
Select the tab for how you plan to use the samples on this page:
Console
When you use the Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.
gcloud
-
Installez la Google Cloud CLI, puis connectez-vous à la gcloud CLI avec votre identité fédérée. Après vous être connecté, initialisez Google Cloud CLI en exécutant la commande suivante :
gcloud init
- Set a default region and zone.
REST
Pour utiliser les exemples d'API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à gcloud CLI.
Installez la Google Cloud CLI, puis connectez-vous à la gcloud CLI avec votre identité fédérée. Après vous être connecté, initialisez Google Cloud CLI en exécutant la commande suivante :
gcloud init
Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Trusted Cloud .
Rôles requis
Pour obtenir les autorisations nécessaires pour afficher la configuration réseau d'une instance, demandez à votre administrateur de vous accorder le rôle IAM Administrateur d'instances Compute (v1) (
roles/compute.instanceAdmin.v1
) ou Administrateur de réseau Compute (roles/compute.networkAdmin
) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.Ce rôle prédéfini contient les autorisations requises pour afficher la configuration réseau d'une instance. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :
Autorisations requises
Les autorisations suivantes sont requises pour afficher la configuration réseau d'une instance :
-
Affichez la configuration réseau d'une instance :
compute.instances.get
sur l'instance -
Affichez les adresses IP d'une instance :
compute.instances.list
sur le projet
Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.
Afficher les adresses IP
Vous pouvez afficher les adresses IP interne et externe de votre instance. Les adresses IP peuvent être des adresses IPv4 ou IPv6.
Console
Dans la console Trusted Cloud , accédez à la page Instances de VM.
Facultatif : Utilisez la zone
Filtrer pour limiter le nombre d'instances affichées.Si l'instance possède une adresse IP externe, celle-ci apparaît dans la colonne Adresse IP externe.
Si la colonne Adresse IP externe est vide, cela signifie que l'instance ne possède pas d'adresse IP externe. Si l'instance ne possède pas d'adresse IP externe, vous pouvez lui en attribuer une.
En fonction des options d'affichage des colonnes, vous pouvez voir plus ou moins de colonnes que dans l'image précédente.
gcloud
Vous pouvez utiliser deux commandes pour afficher les adresses IP d'une instance :
gcloud compute instances list
affiche toutes les adresses IP utilisées par une instance de calcul, qu'elles soient statiques ou éphémères.gcloud compute addresses list
affiche toutes les adresses IP réservées qui sont attribuées à une instance de calcul.
Cette tâche explique comment afficher les adresses IP à l'aide des commandes
gcloud compute instances
.Pour afficher les adresses IP interne et externe de vos instances, utilisez la commande
gcloud compute instances list
.gcloud compute instances list
Vous pouvez ajouter la clause
--filter
pour limiter le nombre d'instances renvoyées par la commande (par exemple,--filter='zone:us-central1-c'
).Le résultat ressemble à ce qui suit :
NAME ZONE MACHINE_TYPE PREEMPTIBLE INTERNAL_IP EXTERNAL_IP STATUS webapp1 us-central1-c c3-highmem-88 true 192.0.2.11 RUNNING my-instance us-central1-c n4-standard-2 192.0.2.126 203.0.113.6 RUNNING my-dual-stack us-central1-a e2-micro 192.0.2.54 203.0.113.7 RUNNING 2001:db8:2:2:2:2:2:2/96 new-ipv6-only us-central1-a n4-standard-2 2001:db8:1:1:1:1:1:1/96 RUNNING
Si le champ "Adresse IP externe" est vide, cela signifie qu'aucune adresse IP de ce type n'est définie pour l'instance. Vous pouvez en attribuer une.
Pour afficher l'adresse IP interne ou externe d'une instance spécifique, utilisez la commande
gcloud compute instances describe
avec l'option--format
pour filtrer le résultat.Adresses internes
Pour afficher l'adresse IP interne d'une instance spécifique, utilisez l'une des commandes suivantes :
Adresses IPv4 :
gcloud compute instances describe INSTANCE_NAME \ --zone=ZONE \ --format='get(networkInterfaces[0].networkIP)'
192.0.2.11
Adresses IPv6 :
gcloud compute instances describe INSTANCE_NAME \ --zone=ZONE \ --format='get(networkInterfaces[0].ipv6Address)'
2001:db8:2:2:2:2:2:2
Adresses externes
Pour afficher l'adresse IP externe d'une instance spécifique, utilisez l'une des commandes suivantes :
Adresses IPv4 :
gcloud compute instances describe INSTANCE_NAME \ --zone=ZONE \ --format='get(networkInterfaces[0].accessConfigs[0].natIP)'
203.0.113.6
Adresses IPv6 :
gcloud compute instances describe INSTANCE_NAME \ --zone=ZONE \ --format='get(networkInterfaces[0].ipv6AccessConfigs[0].externalIpv6)'
2001:db8:3:3:3:3:3:3
Remplacez les éléments suivants :
INSTANCE_NAME
: nom de l'instance dont vous souhaitez afficher l'adresse IP interne ou externeZONE
: nom de la zone dans laquelle se trouve l'instance
Si la commande ne renvoie pas d'adresse IP, cela signifie qu'aucune adresse IP externe n'est configurée pour l'instance.
REST
Envoyez une requête
GET
à la méthodeinstances.get
. En ajoutant un paramètre de requête$fields
à la requête, vous pouvez limiter la sortie aux seuls champs qui vous intéressent.GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/INSTANCE_NAME$fields=name,networkInterfaces.networkIP,networkInterfaces.accessConfigs.natIP,networkInterfaces.ipv6AccessConfigs.externalIpv6
Remplacez les éléments suivants :
PROJECT_NAME
: nom du projet contenant l'instanceZONE
: zone de l'instance sur laquelle vous souhaitez effectuer la requêteINSTANCE_NAME
: nom de la ressource d'instance à renvoyer
Si l'une des adresses IP n'est pas configurée, ce champ n'apparaît pas dans le résultat. Pour une instance de calcul qui utilise un réseau à double pile avec une adresse IPv6 externe, le corps de votre réponse ressemble à ce qui suit :
{ "name": "my-dual-stack-vm", "networkInterfaces": [ { "networkIP": "10.0.0.2", "accessConfigs": [ { "natIP": "104.155.21.204" } ], "ipv6AccessConfigs": [ { "externalIpv6": "2600:1900:4010:8b2:0:0:0:0" } ] } ] }
Les champs suivants contiennent les informations requises :
networkIP
: adresse IPv4 interne attribuéenatIP
: adresse IPv4 externe attribuéeexternalIpv6
: adresse IPv6 externe attribuée
Python
Java
Afficher les interfaces réseau d'une instance
Chaque instance de calcul possède au moins une interface réseau. Vous pouvez afficher les propriétés configurées des interfaces réseau d'une instance de plusieurs manières.
Console
Dans la console Trusted Cloud , accédez à la page Instances de VM.
Facultatif : Utilisez la zone
Filtrer pour limiter le nombre d'instances affichées.Cliquez sur le nom de l'instance que vous souhaitez inspecter.
Dans la section Réseau, sous Interfaces réseau, vous pouvez voir les cartes d'interface réseau (NIC) créées pour l'instance, le réseau et le sous-réseau associés à chaque NIC, ainsi que leurs adresses IP attribuées.
Vous pouvez cliquer sur le nom d'une carte d'interface réseau pour ouvrir la page Détails de l'interface réseau. Sur cette page, vous pouvez voir les pare-feu et les routes utilisés par la carte réseau, et effectuer un test de connectivité pour la carte réseau.
gcloud
Pour afficher les interfaces réseau (NIC) d'une instance de calcul, utilisez la commande
gcloud compute instances describe
. Vous pouvez ajouter une option--format
à la commande pour limiter les informations renvoyées à des champs spécifiques et modifier leur affichage. Par exemple :gcloud compute instances describe INSTANCE_NAME --zone=ZONE \ --format="flattened(name,networkInterfaces[].name, networkInterfaces[].network.basename(), networkInterfaces[].stackType, networkInterfaces[].nicType)"
Remplacez les éléments suivants :
INSTANCE_NAME
: nom de l'instance à afficherZONE
: zone de l'instance que vous souhaitez afficher
Le résultat ressemble à ce qui suit :
name: my-multinic-vm networkInterfaces[0].name: nic0 networkInterfaces[0].network: default networkInterfaces[0].nicType: GVNIC networkInterfaces[0].stackType: IPV4_ONLY networkInterfaces[1].name: nic1 networkInterfaces[1].network: appnet-vpc-0 networkInterfaces[1].nicType: GVNIC networkInterfaces[1].stackType: IPV4_IPV6
REST
Envoyez une requête
GET
à la méthodeinstances.get
. En ajoutant un paramètre de requête$fields
à la requête, vous pouvez limiter la sortie à la propriéténetworkInterfaces
.GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/INSTANCE_NAME?$fields=networkInterfaces
Remplacez les éléments suivants :
PROJECT_NAME
: nom du projet contenant l'instanceZONE
: zone de l'instance sur laquelle vous souhaitez effectuer la requêteINSTANCE_NAME
: nom de la ressource d'instance à renvoyer
Le résultat ressemble à ce qui suit :
{ "networkInterfaces": [ { "kind": "compute#networkInterface", "network": "https://www.s3nsapis.fr/compute/v1/projects/my-project/global/networks/network-name-1", "subnetwork": "https://www.s3nsapis.fr/compute/v1/projects/my-project/regions/us-central1/subnetworks/subnet-name-1", "networkIP": "10.128.0.15", "name": "nic0", "accessConfigs": [ { "kind": "compute#accessConfig", "type": "ONE_TO_ONE_NAT", "name": "External NAT", "networkTier": "PREMIUM" } ], "fingerprint": "mBy9xvkWA9M=", "stackType": "IPV4_ONLY", "nicType": "GVNIC" }, { "kind": "compute#networkInterface", "network": "https://www.s3nsapis.fr/compute/v1/projects/my-project/global/networks/network-name-2", "subnetwork": "https://www.s3nsapis.fr/compute/v1/projects/my-project/regions/us-central1/subnetworks/subnet-name-2", "networkIP": "10.0.20.2", "name": "nic1", "accessConfigs": [ { "kind": "compute#accessConfig", "type": "ONE_TO_ONE_NAT", "name": "External NAT", "networkTier": "PREMIUM" } ], "ipv6AccessConfigs": [ { "kind": "compute#accessConfig", "type": "DIRECT_IPV6", "name": "external-ipv6", "externalIpv6": "2600:1900:4000:8447:0:0:0:0", "externalIpv6PrefixLength": 96, "publicPtrDomainName": "", "networkTier": "PREMIUM" } ], "fingerprint": "rx6hfNA94f4=", "stackType": "IPV4_IPV6", "ipv6AccessType": "EXTERNAL", "nicType": "GVNIC" } ] }
Afficher la configuration de l'interface réseau dynamique pour une instance
Si vous avez configuré des cartes d'interface réseau dynamiques pour une instance, vous pouvez utiliser l'une des méthodes suivantes pour consulter les informations les concernant.gcloud
Pour afficher les interfaces réseau (NIC) d'une instance de calcul, utilisez la commande
gcloud beta compute instances describe
. Vous pouvez ajouter une option--format
à la commande pour limiter les informations renvoyées à des champs spécifiques et modifier leur affichage. Par exemple :gcloud compute instances describe INSTANCE_NAME --zone=ZONE \ --format="flattened(name,networkInterfaces[].name, networkInterfaces[].network.basename(), networkInterfaces[].stackType, networkInterfaces[].parentNicName)"
Le résultat ressemble à ce qui suit :
name: test-instance networkInterfaces[0].name: nic0 networkInterfaces[0].network: default networkInterfaces[0].nicType: GVNIC networkInterfaces[0].stackType: IPV4_ONLY networkInterfaces[1].name: nic1 networkInterfaces[1].network: prod-ipv6 networkInterfaces[1].nicType: GVNIC networkInterfaces[1].stackType: IPV4_IPV6 networkInterfaces[1].name: nic1.2 networkInterfaces[1].network: alt-ipv6-net networkInterfaces[1].nicType: GVNIC networkInterfaces[1].stackType: IPV4_IPV6 networkInterfaces[1].parentNicName: nic1
REST
Envoyez une requête
GET
à la méthodeinstances.get
. En ajoutant un paramètre de requête$fields
à la requête, vous pouvez limiter la sortie à la propriéténetworkInterfaces
.Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT_ID
: ID du projet contenant l'instanceZONE
: zone de l'instanceINSTANCE_NAME
: nom de l'instance
Méthode HTTP et URL :
GET https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_NAME/zones/ZONE/instances/INSTANCE_NAME?$fields=networkInterfaces
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
{ "networkInterfaces": [ { "kind": "compute#networkInterface", "network": "https://www.s3nsapis.fr/compute/beta/projects/my-project/global/networks/network-name-1", "subnetwork": "https://www.s3nsapis.fr/compute/beta/projects/my-project/regions/us-central1/subnetworks/subnet-name-1", "networkIP": "10.128.0.15", "name": "nic0", "accessConfigs": [ { "kind": "compute#accessConfig", "type": "ONE_TO_ONE_NAT", "name": "External NAT", "networkTier": "PREMIUM" } ], "fingerprint": "mBy9xvkWA9M=", "stackType": "IPV4_ONLY", "nicType": "GVNIC" }, { "kind": "compute#networkInterface", "network": "https://www.s3nsapis.fr/compute/beta/projects/my-project/global/networks/network-name-2", "subnetwork": "https://www.s3nsapis.fr/compute/beta/projects/my-project/regions/us-central1/subnetworks/subnet-name-2", "networkIP": "10.0.20.2", "name": "nic1", "accessConfigs": [ { "kind": "compute#accessConfig", "type": "ONE_TO_ONE_NAT", "name": "External NAT", "networkTier": "PREMIUM" } ], "ipv6AccessConfigs": [ { "kind": "compute#accessConfig", "type": "DIRECT_IPV6", "name": "external-ipv6", "externalIpv6": "2600:1900:4000:8447:0:0:0:0", "externalIpv6PrefixLength": 96, "publicPtrDomainName": "", "networkTier": "PREMIUM" } ], "fingerprint": "rx6hfNA94f4=", "stackType": "IPV4_IPV6", "ipv6AccessType": "EXTERNAL", "nicType": "GVNIC", "parentNicName": "nic1" }, { "kind": "compute#networkInterface", "network": "https://www.s3nsapis.fr/compute/beta/projects/my-project/global/networks/network-name-3", "subnetwork": "https://www.s3nsapis.fr/compute/beta/projects/my-project/regions/us-central1/subnetworks/subnet-name-3", "networkIP": "10.0.26.2", "name": "nic1.1", "accessConfigs": [ { "kind": "compute#accessConfig", "type": "ONE_TO_ONE_NAT", "name": "External NAT", "networkTier": "PREMIUM" } ], "ipv6AccessConfigs": [ { "kind": "compute#accessConfig", "type": "DIRECT_IPV6", "name": "external-ipv6", "externalIpv6": "2600:1900:4000:8450:0:0:0:0", "externalIpv6PrefixLength": 96, "publicPtrDomainName": "", "networkTier": "PREMIUM" } ], "fingerprint": "rx6hfNA94f4=", "stackType": "IPV4_IPV6", "ipv6AccessType": "EXTERNAL", "nicType": "GVNIC", "parentNicName": "nic1" } ] }
Afficher toutes les instances de calcul d'un réseau
Utilisez l'une des méthodes suivantes pour afficher toutes les instances de calcul d'un réseau donné.
Console
Dans la console Trusted Cloud , accédez à la page Réseaux VPC.
Facultatif : Utilisez la zone
Filtrer pour limiter le nombre de réseaux affichés.Cliquez sur le nom du réseau pour lequel vous souhaitez lister les instances de calcul.
Sélectionnez l'onglet Instances pour afficher les instances de ce réseau.
gcloud
Pour afficher les instances de calcul qui utilisent un réseau spécifique, utilisez la commande
gcloud compute instances list
.Utilisez l'option
--filter
pour n'afficher que les instances qui utilisent un réseau spécifique. Vous pouvez également utiliser un indicateur--format
pour limiter et mettre en forme les résultats, par exemple :gcloud compute instances list \ --filter 'networkInterfaces[].network:NETWORK_NAME' \ --format="table(name:sort=1,machineType.basename(),zone.basename(),networkInterfaces[].subnetwork)"
Le résultat ressemble à ce qui suit :
NAME: c2-tier1-multinic MACHINE_TYPE: c2-standard-30 ZONE: us-central1-c SUBNETWORK: ['https://www.s3nsapis.fr/compute/v1/projects/my-project/regions/us-central1/subnetworks/default', 'https://www.s3nsapis.fr/compute/v1/projects/my-project/regions/us-central1/subnetworks/webapps-external-subnet']
NAME: c3-with-lssd MACHINE_TYPE: c3-standard-4-lssd ZONE: us-central1-a SUBNETWORK: ['https://www.s3nsapis.fr/compute/v1/projects/my-project/regions/us-central1/subnetworks/default']
NAME: example-instance3 MACHINE_TYPE: n2-custom-2-163840-ext ZONE: us-central1-b SUBNETWORK: ['https://www.s3nsapis.fr/compute/v1/projects/my-project/regions/us-central1/subnetworks/default']
NAME: n4-test-windows MACHINE_TYPE: n4-standard-2 ZONE: us-central1-c SUBNETWORK: ['https://www.s3nsapis.fr/compute/v1/projects/my-project/regions/us-central1/subnetworks/default']Déterminer si le réseau Tier_1 est activé
Utilisez l'une des méthodes suivantes pour déterminer si les performances réseau Tier_1 par VM sont activées pour une instance.
Console
Dans la console Trusted Cloud , accédez à la page Instances de VM.
Facultatif : Utilisez la zone
Filtrer pour limiter le nombre d'instances affichées.Cliquez sur le nom de l'instance que vous souhaitez inspecter.
Dans la section Mise en réseau, vérifiez la valeur de Niveau de bande passante de sortie totale :
TIER_1
: le réseau Tier_1 est activé.-
: la mise en réseau Tier_1 n'est pas activée.
gcloud
Pour afficher le paramètre
networkPerformanceConfig
d'une instance, utilisez la commandegcloud compute instances describe
. Vous pouvez ajouter une option--format
à la commande pour limiter les informations renvoyées à des champs spécifiques et modifier leur affichage. Par exemple :gcloud compute instances describe INSTANCE_NAME \ --zone=ZONE \ --format="text(name, networkPerformanceConfig)"
Si la mise en réseau Tier_1 n'est pas configurée pour l'instance, le champ
networkPerformanceConfig
n'est pas inclus dans le résultat. Si la mise en réseau de niveau 1 est activée pour une instance, le résultat ressemble à ce qui suit :name: c2-tier1-multinic networkPerformanceConfig.totalEgressBandwidthTier: TIER_1
REST
Envoyez une requête
GET
à la méthodeinstances.get
. En ajoutant un paramètre de requête$fields
à la requête, vous pouvez limiter la sortie aux champsname
,networkPerformanceConfig
etnicType
.GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/INSTANCE_NAME?$fields=name,networkPerformanceConfig,networkInterfaces.nicType
Remplacez les éléments suivants :
PROJECT_NAME
: nom du projet contenant l'instanceZONE
: zone de l'instance sur laquelle vous souhaitez effectuer la requêteINSTANCE_NAME
: nom de la ressource d'instance à renvoyer
Si la mise en réseau Tier_1 n'est pas configurée pour l'instance, le champ
networkPerformanceConfig
n'est pas inclus dans le résultat. Si la mise en réseau de niveau 1 est activée pour une instance, le résultat ressemble à ce qui suit :{ "name": "c2-tier1-multinic", "networkInterfaces": [ { "nicType": "GVNIC" }, { "nicType": "GVNIC" } ], "networkPerformanceConfig": { "totalEgressBandwidthTier": "TIER_1" } }
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/08 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/08 (UTC)."],[[["This guide details how to view network configurations, including interfaces, networks, subnets, and IP addresses for Google Cloud compute instances."],["Authentication is necessary for accessing Google Cloud services and APIs, with options provided for using the console, gcloud CLI, or REST API, and instructions given on how to complete this."],["You can view IP addresses (both internal and external, IPv4 or IPv6) for a compute instance through the Google Cloud console or using the `gcloud` command-line tool, and filter the output for specific addresses."],["Network interface details, including associated networks, subnets, and IP addresses, can be viewed via the Google Cloud console or by using the `gcloud` CLI with the `gcloud compute instances describe` command."],["You can determine whether Tier_1 networking is enabled for an instance through the Google Cloud console or the `gcloud` command, by inspecting the `networkPerformanceConfig` setting."]]],[]] -