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 procesamiento.
Antes de comenzar
-
Si aún no lo hiciste, configura la autenticación.
La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las APIs de Google Cloud .
Para ejecutar código o muestras 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
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
- Set a default region and zone.
-
Consulta la configuración de red de una instancia:
compute.instances.get
en la instancia -
Para ver las direcciones IP de una instancia, haz clic en
compute.instances.list
en el proyecto. En la Google Cloud consola, ve a la página Instancias de VM.
Opcional: Usa el cuadro
Filtro para restringir la cantidad de instancias que se muestran.Si la instancia tiene una dirección IP externa, esta aparece en la columna IP externa.
Si la columna IP externa está vacía, significa que la instancia no tiene una dirección IP externa. Si la instancia no tiene una dirección IP externa, puedes asignarle una.
gcloud compute instances list
muestra todas las direcciones IP que usa una instancia de procesamiento, ya sean estáticas o efímeras.gcloud compute addresses list
muestra todas las direcciones IP reservadas que se asignan a una instancia de procesamiento.Para ver las direcciones IP internas y externas de tus instancias, usa el comando
gcloud compute instances list
.gcloud compute instances list
Puedes agregar la cláusula
--filter
para restringir la cantidad de instancias que devuelve el comando, por ejemplo,--filter='zone:us-central1-c'
.El resultado es similar a este:
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 una dirección IP definida de ese tipo 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 una 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
Reemplaza lo siguiente:
INSTANCE_NAME
: El nombre de la instancia cuya IP interna o externa deseas 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 una dirección IP externa.
PROJECT_NAME
: El nombre del proyecto que contiene la instanciaZONE
: Es la zona de la instancia que deseas consultar.INSTANCE_NAME
: El nombre del recurso de la instancia que se devolveránetworkIP
: La dirección IPv4 interna asignadanatIP
: La dirección IPv4 externa asignadaexternalIpv6
: Es la dirección IPv6 externa asignada.En la Google Cloud consola, ve a la página Instancias de VM.
Opcional: Usa el cuadro
Filtro para restringir la cantidad de instancias que se muestran.Haz clic en el nombre de la instancia que deseas inspeccionar.
En la sección Herramientas de redes, en Interfaces de red, puedes ver las interfaces de red (NIC) creadas para la instancia, la red y la subred asociadas con cada NIC, y sus 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, puedes ver los firewalls y las rutas que usa la NIC, y también realizar una prueba de conectividad para la NIC.
INSTANCE_NAME
: Es el nombre de la instancia que se visualizará.ZONE
: Es la zona de la instancia que deseas ver.PROJECT_NAME
: El nombre del proyecto que contiene la instanciaZONE
: Es la zona de la instancia que deseas consultar.INSTANCE_NAME
: El nombre del recurso de la instancia que se devolveráPROJECT_ID
: ID del proyecto que contiene la instanciaZONE
: Zona de la instanciaINSTANCE_NAME
: Es el nombre de la instancia.En la consola de Google Cloud , ve a la página Redes de VPC.
Opcional: Usa el cuadro
Filtro para restringir la cantidad de redes que se muestran.Haz clic en el nombre de la red para la que deseas enumerar las instancias de procesamiento.
Selecciona la pestaña Instancias para ver las instancias dentro de esa red.
En la Google Cloud consola, ve a la página Instancias de VM.
Opcional: Usa el cuadro
Filtro para restringir la cantidad de instancias que se muestran.Haz clic en el nombre de la instancia que deseas inspeccionar.
En la sección Herramientas de redes, verifica el valor de Nivel de ancho de banda de salida total:
TIER_1
: Las redes de nivel 1 están habilitadas.-
: Las redes Tier_1 no están habilitadas.
PROJECT_NAME
: El nombre del proyecto que contiene la instanciaZONE
: Es la zona de la instancia que deseas consultar.INSTANCE_NAME
: El nombre del recurso de la instancia que se devolverá
REST
Para usar las muestras de la API de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que proporcionas a la CLI de gcloud.
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
Si deseas obtener más información, consulta Autentica para usar REST en la Google Cloud documentación de autenticación.
Roles obligatorios
Para obtener los permisos que necesitas para ver la configuración de red de una instancia, pídele a tu administrador que te otorgue el rol de IAM de Administrador de instancias de Compute (v1) (
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 otorgar roles, consulta Administra 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 son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para ver la configuración de red de una instancia:
También puedes obtener estos permisos con roles personalizados o con 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.
Console
Según las opciones de visualización de columnas, es posible que veas más o menos columnas que las que aparecen en la imagen anterior.
gcloud
Existen dos comandos que puedes usar para ver las direcciones IP de una instancia:
En esta tarea, se muestra cómo ver las direcciones IP con los comandos de
gcloud compute instances
.REST
Realiza una solicitud
GET
al métodoinstances.get
. Si agregas un parámetro de consulta$fields
a la solicitud, puedes restringir el resultado solo a los campos de interés.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
Reemplaza lo siguiente:
Si no se configura ninguna de las direcciones IP, ese campo no aparecerá en el resultado. En el caso de una instancia de procesamiento que usa una red de pila doble con una dirección IPv6 externa, el cuerpo de la respuesta se asemeja 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 requerida:
Python
Java
Cómo ver las interfaces de red de una instancia
Cada instancia de procesamiento tiene al menos una interfaz de red. Puedes ver las propiedades configuradas de las interfaces de red de una instancia de las siguientes maneras.
Console
gcloud
Para ver las interfaces de red (NIC) de una instancia de procesamiento, usa el comando
gcloud compute instances describe
. Puedes agregar una opción--format
al comando para restringir la información que se devuelve 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)"
Reemplaza lo siguiente:
El resultado es similar a este:
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
Realiza una solicitud
GET
al métodoinstances.get
. Si agregas un parámetro de búsqueda$fields
a la solicitud, puedes restringir el resultado solo a la propiedadnetworkInterfaces
.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/INSTANCE_NAME?$fields=networkInterfaces
Reemplaza lo siguiente:
El resultado es similar a este:
{ "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" } ] }
Cómo ver la configuración de la interfaz de red dinámica de una instancia
Si configuraste NIC dinámicas para una instancia, puedes usar uno de los siguientes métodos para revisar la información de la NIC dinámica.gcloud
Para ver las interfaces de red (NIC) de una instancia de procesamiento, usa el comando
gcloud beta compute instances describe
. Puedes agregar una opción--format
al comando para restringir la información que se devuelve 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 es similar a este:
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
Realiza una solicitud
GET
al métodoinstances.get
. Si agregas un parámetro de búsqueda$fields
a la solicitud, puedes restringir el resultado solo a la propiedadnetworkInterfaces
.Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
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, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "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" } ] }
Cómo ver todas las instancias de procesamiento dentro de una red
Usa uno de los siguientes métodos para ver todas las instancias de procesamiento dentro de una red determinada.
Console
gcloud
Para ver las instancias de procesamiento que usan una red específica, usa el comando
gcloud compute instances list
.Usa una marca
--filter
para enumerar 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 es similar a este:
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']Cómo determinar si las herramientas de redes de Tier_1 están habilitadas
Usa uno de los siguientes métodos para determinar si el rendimiento de red Tier_1 por VM está habilitado para una instancia.
Console
gcloud
Para ver el parámetro de configuración
networkPerformanceConfig
de una instancia, usa el comandogcloud compute instances describe
. Puedes agregar una opción--format
al comando para restringir la información que se devuelve 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 las redes Tier_1 no están configuradas para la instancia, el campo
networkPerformanceConfig
no se incluye en el resultado. Si la red de nivel 1 está habilitada para una instancia, el resultado es similar al siguiente:name: c2-tier1-multinic networkPerformanceConfig.totalEgressBandwidthTier: TIER_1
REST
Realiza una solicitud
GET
al métodoinstances.get
. Si agregas un parámetro de consulta$fields
a la solicitud, puedes restringir el resultado solo 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
Reemplaza lo siguiente:
Si las redes Tier_1 no están configuradas para la instancia, el campo
networkPerformanceConfig
no se incluye en el resultado. Si la red de nivel 1 está habilitada para una instancia, el resultado es similar al siguiente:{ "name": "c2-tier1-multinic", "networkInterfaces": [ { "nicType": "GVNIC" }, { "nicType": "GVNIC" } ], "networkPerformanceConfig": { "totalEgressBandwidthTier": "TIER_1" } }
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-11 (UTC)
-