Sigue las instrucciones de esta página para ver las interfaces de red, las redes, las subredes y las direcciones IP de una instancia de proceso.
Antes de empezar
-
Si aún no lo has hecho, configura la autenticación.
La autenticación verifica tu identidad para acceder a Google Cloud servicios y APIs. Para ejecutar código o ejemplos desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando:
gcloud init
Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.
- Set a default region and zone.
REST
Para usar las muestras de la API REST de esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la CLI de gcloud.
Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando:
gcloud init
Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.
Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .
Roles obligatorios
Para obtener los permisos que necesitas para ver la configuración de red de una instancia, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Administrador de instancias de Compute (v. 1) (
roles/compute.instanceAdmin.v1
) o Administrador de redes de Compute (roles/compute.networkAdmin
) en el proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.Este rol predefinido contiene los permisos necesarios para ver la configuración de red de una instancia. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:
Permisos obligatorios
Para ver la configuración de red de una instancia, se necesitan los siguientes permisos:
-
Para ver la configuración de red de una instancia, haz lo siguiente:
compute.instances.get
en la instancia -
Para ver las direcciones IP de una instancia, haz lo siguiente:
compute.instances.list
en el proyecto
También puedes obtener estos permisos con roles personalizados u otros roles predefinidos.
Ver direcciones IP
Puedes ver las direcciones IP internas y externas de tu instancia. Las direcciones IP pueden ser IPv4 o IPv6.
Consola
En la consola de Google Cloud , ve a la página Instancias de VM.
Opcional: Usa el cuadro
Filtrar para limitar el número de instancias que se muestran.Si la instancia tiene una dirección IP externa, aparecerá en la columna IP externa.
Si la columna IP externa está vacía, significa que la instancia no tiene ninguna dirección IP externa. Si la instancia no tiene una dirección IP externa, puedes asignarle una.
En función de las opciones de visualización de columnas, es posible que veas más o menos columnas que en la imagen anterior.
gcloud
Hay dos comandos que puedes usar para ver las direcciones IP de una instancia:
gcloud compute instances list
muestra todas las direcciones IP que usa una instancia de proceso, ya sean estáticas o efímeras.gcloud compute addresses list
muestra todas las direcciones IP reservadas que se han asignado a una instancia de computación.
En esta tarea se muestra cómo ver las direcciones IP mediante comandos de
gcloud compute instances
.Para ver las direcciones IP internas y externas de tus instancias, usa el comando
gcloud compute instances list
.gcloud compute instances list
Puedes añadir la cláusula
--filter
para restringir el número de instancias devueltas por el comando. Por ejemplo,--filter='zone:us-central1-c'
.El resultado debería ser similar al siguiente:
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 el campo Dirección IP externa está vacío, significa que no hay ninguna dirección IP de ese tipo definida para la instancia. Puedes asignar una.
Para ver la dirección IP interna o externa de una instancia específica, usa el comando
gcloud compute instances describe
con la marca--format
para filtrar el resultado.Direcciones internas
Para ver la dirección IP interna de una instancia específica, usa uno de los siguientes comandos:
Direcciones IPv4:
gcloud compute instances describe INSTANCE_NAME \ --zone=ZONE \ --format='get(networkInterfaces[0].networkIP)'
192.0.2.11
Direcciones IPv6:
gcloud compute instances describe INSTANCE_NAME \ --zone=ZONE \ --format='get(networkInterfaces[0].ipv6Address)'
2001:db8:2:2:2:2:2:2
Direcciones externas
Para ver la dirección IP externa de una instancia específica, usa uno de los siguientes comandos:
Direcciones IPv4:
gcloud compute instances describe INSTANCE_NAME \ --zone=ZONE \ --format='get(networkInterfaces[0].accessConfigs[0].natIP)'
203.0.113.6
Direcciones IPv6:
gcloud compute instances describe INSTANCE_NAME \ --zone=ZONE \ --format='get(networkInterfaces[0].ipv6AccessConfigs[0].externalIpv6)'
2001:db8:3:3:3:3:3:3
Haz los cambios siguientes:
INSTANCE_NAME
: el nombre de la instancia cuya IP interna o externa quieres verZONE
: el nombre de la zona en la que se encuentra la instancia
Si el comando no devuelve una dirección IP, significa que la instancia no tiene configurada ninguna dirección IP externa.
REST
Haz una solicitud
GET
al métodoinstances.get
. Si añades un parámetro de consulta$fields
a la solicitud, puedes restringir la salida a los campos que te interesen.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/INSTANCE_NAME$fields=name,networkInterfaces.networkIP,networkInterfaces.accessConfigs.natIP,networkInterfaces.ipv6AccessConfigs.externalIpv6
Haz los cambios siguientes:
PROJECT_NAME
: el nombre del proyecto que contiene la instanciaZONE
: la zona de la instancia que quieras consultarINSTANCE_NAME
: el nombre del recurso de instancia que se va a devolver.
Si no se configura ninguna de las direcciones IP, ese campo no aparecerá en el resultado. En el caso de una instancia de proceso que usa una red de doble pila con una dirección IPv6 externa, el cuerpo de la respuesta será similar al siguiente:
{ "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" } ] } ] }
Los siguientes campos contienen la información obligatoria:
networkIP
: la dirección IPv4 interna asignadanatIP
: la dirección IPv4 externa asignadaexternalIpv6
: la dirección IPv6 externa asignada
Python
Java
Ver las interfaces de red de una instancia
Cada instancia de proceso tiene al menos una interfaz de red. Puede ver las propiedades configuradas de las interfaces de red de una instancia de las siguientes formas.
Consola
En la consola de Google Cloud , ve a la página Instancias de VM.
Opcional: Usa el cuadro
Filtrar para limitar el número de instancias que se muestran.Haga clic en el nombre de la instancia que quiera inspeccionar.
En la sección Redes, en Interfaces de red, puedes ver las interfaces de red (NICs) creadas para la instancia, la red y la subred asociadas a cada NIC, así como las direcciones IP asignadas.
Puedes hacer clic en el nombre de una NIC para abrir la página Detalles de la interfaz de red. En esta página, puede ver los cortafuegos y las rutas que usa la NIC, así como realizar una prueba de conectividad para la NIC.
gcloud
Para ver las interfaces de red de una instancia de proceso, usa el comando
gcloud compute instances describe
. Puedes añadir una opción--format
al comando para restringir la información devuelta a campos específicos y cambiar la forma en que se muestra. Por ejemplo:gcloud compute instances describe INSTANCE_NAME --zone=ZONE \ --format="flattened(name,networkInterfaces[].name, networkInterfaces[].network.basename(), networkInterfaces[].stackType, networkInterfaces[].nicType)"
Haz los cambios siguientes:
INSTANCE_NAME
: el nombre de la instancia que quieres verZONE
: la zona de la instancia que quieras ver
El resultado debería ser similar al siguiente:
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
Crea una solicitud
GET
para el métodoinstances.get
. Si añade el parámetro de consulta$fields
a la solicitud, puede restringir la salida a la propiedadnetworkInterfaces
.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/INSTANCE_NAME?$fields=networkInterfaces
Haz los cambios siguientes:
PROJECT_NAME
: el nombre del proyecto que contiene la instanciaZONE
: la zona de la instancia que quieras consultarINSTANCE_NAME
: el nombre del recurso de instancia que se va a devolver.
El resultado debería ser similar al siguiente:
{ "networkInterfaces": [ { "kind": "compute#networkInterface", "network": "https://www.googleapis.com/compute/v1/projects/my-project/global/networks/network-name-1", "subnetwork": "https://www.googleapis.com/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.googleapis.com/compute/v1/projects/my-project/global/networks/network-name-2", "subnetwork": "https://www.googleapis.com/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" } ] }
Ver la configuración de la interfaz de red dinámica de una instancia
Si has configurado NICs dinámicas para una instancia, puedes usar uno de los siguientes métodos para consultar la información de las NICs dinámicas.gcloud
Para ver las interfaces de red de una instancia de proceso, usa el comando
gcloud beta compute instances describe
. Puedes añadir una opción--format
al comando para restringir la información devuelta a campos específicos y cambiar la forma en que se muestra. Por ejemplo:gcloud compute instances describe INSTANCE_NAME --zone=ZONE \ --format="flattened(name,networkInterfaces[].name, networkInterfaces[].network.basename(), networkInterfaces[].stackType, networkInterfaces[].parentNicName)"
El resultado debería ser similar al siguiente:
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
Crea una solicitud
GET
para el métodoinstances.get
. Si añade el parámetro de consulta$fields
a la solicitud, puede restringir la salida a la propiedadnetworkInterfaces
.Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
PROJECT_ID
: ID del proyecto que contiene la instanciaZONE
: zona de la instanciaINSTANCE_NAME
: el nombre de la instancia.
Método HTTP y URL:
GET https://compute.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE/instances/INSTANCE_NAME?$fields=networkInterfaces
Para enviar tu solicitud, despliega una de estas opciones:
Deberías recibir una respuesta JSON similar a la siguiente:
{ "networkInterfaces": [ { "kind": "compute#networkInterface", "network": "https://www.googleapis.com/compute/beta/projects/my-project/global/networks/network-name-1", "subnetwork": "https://www.googleapis.com/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.googleapis.com/compute/beta/projects/my-project/global/networks/network-name-2", "subnetwork": "https://www.googleapis.com/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.googleapis.com/compute/beta/projects/my-project/global/networks/network-name-3", "subnetwork": "https://www.googleapis.com/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" } ] }
Ver todas las instancias de proceso de una red
Utilice uno de los siguientes métodos para ver todas las instancias de proceso de una red determinada.
Consola
En la Google Cloud consola, ve a la página Redes de VPC.
Opcional: Usa el cuadro
Filtrar para limitar el número de redes que se muestran.Haga clic en el nombre de la red de la que quiera obtener una lista de instancias de computación.
Selecciona la pestaña Instancias para ver las instancias de esa red.
gcloud
Para ver las instancias de proceso que usan una red específica, usa el comando
gcloud compute instances list
.Usa la marca
--filter
para mostrar solo las instancias que usan una red específica. También puedes usar una marca--format
para restringir y dar formato a los resultados. Por ejemplo:gcloud compute instances list \ --filter 'networkInterfaces[].network:NETWORK_NAME' \ --format="table(name:sort=1,machineType.basename(),zone.basename(),networkInterfaces[].subnetwork)"
El resultado debería ser similar al siguiente:
NAME: c2-tier1-multinic MACHINE_TYPE: c2-standard-30 ZONE: us-central1-c SUBNETWORK: ['https://www.googleapis.com/compute/v1/projects/my-project/regions/us-central1/subnetworks/default', 'https://www.googleapis.com/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.googleapis.com/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.googleapis.com/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.googleapis.com/compute/v1/projects/my-project/regions/us-central1/subnetworks/default']Determinar si la red de nivel 1 está habilitada
Utiliza uno de los siguientes métodos para determinar si el rendimiento de red Tier_1 por VM está habilitado en una instancia.
Consola
En la consola de Google Cloud , ve a la página Instancias de VM.
Opcional: Usa el cuadro
Filtrar para limitar el número de instancias que se muestran.Haga clic en el nombre de la instancia que quiera inspeccionar.
En la sección Redes, comprueba el valor de Nivel de ancho de banda de salida total:
TIER_1
: la red de nivel 1 está habilitada.-
: la red de nivel 1 no está habilitada.
gcloud
Para ver el ajuste
networkPerformanceConfig
de una instancia, usa el comandogcloud compute instances describe
. Puedes añadir una opción--format
al comando para restringir la información devuelta a campos específicos y cambiar la forma en que se muestra. Por ejemplo:gcloud compute instances describe INSTANCE_NAME \ --zone=ZONE \ --format="text(name, networkPerformanceConfig)"
Si la red de nivel 1 no está configurada para la instancia, el campo
networkPerformanceConfig
no se incluye en el resultado. Si la red de nivel 1 está habilitada en una instancia, el resultado será similar al siguiente:name: c2-tier1-multinic networkPerformanceConfig.totalEgressBandwidthTier: TIER_1
REST
Crea una solicitud
GET
para el métodoinstances.get
. Si añades el parámetro de consulta$fields
a la solicitud, puedes restringir la salida a los camposname
,networkPerformanceConfig
ynicType
.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/INSTANCE_NAME?$fields=name,networkPerformanceConfig,networkInterfaces.nicType
Haz los cambios siguientes:
PROJECT_NAME
: el nombre del proyecto que contiene la instanciaZONE
: la zona de la instancia que quieras consultarINSTANCE_NAME
: el nombre del recurso de instancia que se va a devolver.
Si la red de nivel 1 no está configurada para la instancia, el campo
networkPerformanceConfig
no se incluye en el resultado. Si la red de nivel 1 está habilitada en una instancia, el resultado será similar al siguiente:{ "name": "c2-tier1-multinic", "networkInterfaces": [ { "nicType": "GVNIC" }, { "nicType": "GVNIC" } ], "networkPerformanceConfig": { "totalEgressBandwidthTier": "TIER_1" } }
A menos que se indique lo contrario, el contenido de esta página está sujeto a la licencia Reconocimiento 4.0 de Creative Commons y las muestras de código están sujetas a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio web de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-09-12 (UTC).
-