Los registros PTR configurables te permiten definir el registro DNS inverso asociado a la dirección IP externa de una instancia de VM para que las aplicaciones que dependen de estos registros puedan funcionar correctamente.
Algunas aplicaciones requieren registros de DNS inverso (registros PTR) para resolver direcciones IP en nombres de dominio. Por ejemplo, las aplicaciones que usan SMTP requieren un registro PTR que apunte al dominio desde el que se envía un correo. Sin ese registro, los filtros de spam pueden marcar los correos con una reputación baja, lo que provoca que los correos acaben en las carpetas de spam o que no se envíen.
Solo puedes añadir registros PTR a la interfaz de red principal de una instancia de máquina virtual. Los registros PTR no están disponibles para los front-ends de balanceadores de carga, Cloud NAT ni otras direcciones IP que no sean de máquinas virtuales.
Los registros PTR de IPv6 solo están disponibles si la interfaz de red principal de la instancia está conectada a una subred de doble pila o solo IPv6 que tenga un intervalo de direcciones IPv6 externas. En las interfaces de red de doble pila, puedes tener registros PTR de IPv4 e IPv6 independientes.
Para crear registros PTR personalizados que anulen los nombres PTR de DNS internos creados automáticamente, consulta Zonas de búsqueda inversa gestionadas.
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 .
Verificar la propiedad del dominio
Antes de crear una VM con un registro PTR personalizado, verifica que eres el propietario del nombre de dominio. Verificar la propiedad es una medida de seguridad para demostrar a Google que eres el propietario del dominio.
Puedes verificar tu nombre de dominio de dos formas:
- Si tienes una cuenta de Google, puedes verificar tu sitio con Search Console.
- Si tienes una cuenta de Google o de otro tipo, puedes verificarla añadiendo la dirección IP de tu máquina virtual a tu configuración de DNS.
Verificar mediante Search Console
- Abre Search Console e inicia sesión con la cuenta de Google que usarás para añadir un registro PTR a tu instancia. Puedes verificar la propiedad del dominio con varias cuentas.
- Introduce el nombre de dominio PTR.
- Haz clic en Continuar.
- Siga las instrucciones y, a continuación, haga clic en Ir a la propiedad.
- Haz clic en Configuración (en el menú de la izquierda, cerca de la parte inferior) y, a continuación, en Verificación de la propiedad.
Una vez que hayas verificado que eres el propietario del dominio, en el panel Configuración, haz clic en Usuarios para ver a otros propietarios verificados. Para añadir registros PTR en otros dominios, haz clic en el selector de propiedades de la izquierda, donde se muestra tu dominio actual. Haga clic en Añadir una propiedad para añadir esos dominios.
Si el nombre de dominio no se verifica inmediatamente, utilice el método recomendado para obtener la verificación.
Verificar añadiendo la dirección IP de la máquina virtual a la configuración de DNS
- Si tu VM aún no existe, reserva una dirección IP externa estática regional y úsala más adelante durante la creación de la VM.
- Añade un registro "A" con la dirección IP externa de la VM a la configuración DNS de tu dominio.
Crear instancias de VM con registros PTR
Puedes especificar registros PTR al crear instancias. Para añadir un registro PTR a una instancia, consulta Añadir registros PTR.
Consola
En la Google Cloud consola, ve a la página Crear una instancia.
Especifica los detalles de la VM.
Despliega la sección Opciones avanzadas y sigue estos pasos:
- Despliega la sección Redes.
- Crea una o varias interfaces de red para usar con esta VM. También puedes usar la interfaz de red predeterminada.
- En la sección Interfaces de red, despliega la primera interfaz de red, que es la interfaz de red principal.
- En la sección Public DNS PTR record (Registro PTR de DNS público), selecciona cada tipo de registro PTR que quieras añadir.
- En el campo Nombre de dominio PTR, introduce un nombre de dominio para cada tipo de registro PTR que quieras añadir.
- En el campo Dirección IPv4 externa o Dirección IPv6 externa, elige la dirección IP que hayas reservado anteriormente. Si has verificado la dirección IP de tu VM a través de tu configuración de DNS, debes especificar esa dirección.
- Para confirmar la configuración de la interfaz de red, haz clic en Hecho.
Configura las propiedades restantes de tu nueva máquina virtual.
En la parte inferior de la página, haz clic en Crear.
Una vez que se haya iniciado la VM, puedes ejecutar una búsqueda de DNS inverso en la dirección IP externa de tu VM para confirmar que el registro PTR funciona correctamente.
gcloud
Para crear una instancia con un registro PTR de IPv4 asociado, usa el comando
gcloud instances create
.gcloud compute instances create INSTANCE_NAME \ --image-family IMAGE_FAMILY \ --image-project IMAGE_PROJECT \ --public-ptr \ --public-ptr-domain DOMAIN_NAME \ --address=IP_ADDRESS
Haz los cambios siguientes:
INSTANCE_NAME
: el nombre de la nueva instancia de VM.IMAGE_FAMILY
: una de las familias de imágenes disponibles.IMAGE_PROJECT
: el Google Cloud proyecto con el que se resuelven todas las referencias a imágenes y familias de imágenes. Si no proporcionas un nombre de proyecto, se usará el proyecto predeterminado actual.DOMAIN_NAME
: el nombre de dominio que se va a añadir a esta instancia.IP_ADDRESS
: la dirección IP que habías reservado. Si has verificado la dirección IP de tu VM a través de tu configuración de DNS, debes especificar esa dirección.
Para crear una instancia con un registro PTR IPv6 asociado, haz lo siguiente:
REST
Para crear una instancia con un registro PTR IPv4, haz una solicitud
POST
al métodoinstances.insert
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances { "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE", "name": "INSTANCE_NAME", "disks": [ { "initializeParams": { "sourceImage": "projects/debian-cloud/global/images/family/debian-10" }, "boot": true } ], "networkInterfaces": [ { "network": "NETWORK", "accessConfigs": [ { "type": "ONE_TO_ONE_NAT", "name": "External NAT", "natIP": "IP_ADDRESS", "publicPtrDomainName": "DOMAIN_NAME", "setPublicPtr": true } ] } ] }
Haz los cambios siguientes:
PROJECT_ID
: el ID de tu proyecto.ZONE
: la zona de tu instancia.MACHINE_TYPE
: el tipo de máquina.INSTANCE_NAME
: el nombre de la instancia.NETWORK
: la URL de la cadena.IP_ADDRESS
: la dirección IP que habías reservado. Si has verificado la dirección IP de tu VM a través de tu configuración de DNS, debes especificar esa dirección.DOMAIN_NAME
: el nombre de dominio que se va a añadir.
Para crear una instancia con un registro PTR IPv6, sigue estos pasos:
Añadir registros PTR
Para añadir registros PTR, actualiza la configuración de acceso en la interfaz de red principal,
nic0
, de una instancia de máquina virtual.Consola
En la consola de Google Cloud , ve a la página Instancias de VM.
Haz clic en la instancia que quieras editar.
Haz clic en Editar.
En la sección Interfaces de red, haga clic en la interfaz de red principal.
En la sección Registro PTR de DNS público, selecciona cada tipo de registro PTR que quieras añadir.
En el campo Nombre de dominio PTR, introduce un nombre de dominio para cada tipo de registro PTR que quieras añadir.
Haz clic en Hecho y, a continuación, en Guardar.
gcloud
Si tu VM no tiene una configuración de acceso, añade una con el comando
gcloud compute instances add-access-config
.gcloud compute instances add-access-config INSTANCE_NAME
Sustituye
INSTANCE_NAME
por el nombre de tu instancia.Actualiza la configuración de acceso para añadir el registro PTR mediante el comando
gcloud compute instances update-access-config
. Para añadir registros PTR de IPv4 e IPv6, usa los siguientes comandos por separado.En IPv4:
gcloud compute instances update-access-config INSTANCE_NAME \ --public-ptr \ --public-ptr-domain DOMAIN_NAME
En IPv6:
gcloud compute instances update-access-config INSTANCE_NAME \ --ipv6-public-ptr-domain=DOMAIN_NAME
Haz los cambios siguientes:
INSTANCE_NAME
: el nombre de la instancia que se va a actualizar.DOMAIN_NAME
: el nombre de dominio que se va a añadir.
REST
Si tu VM no tiene una configuración de acceso, añade una haciendo una solicitud
POST
al métodoinstances.addAccessConfig
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/addAccessConfig?networkInterface="nic0"
Actualiza la configuración de acceso para añadir el registro PTR haciendo una solicitud
POST
al métodoinstances.updateAccessConfig
. Para añadir registros PTR tanto IPv4 como IPv6, haz las siguientes solicitudes por separado.En IPv4:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/updateAccessConfig?networkInterface=nic0 { "setPublicPtr": true, "publicPtrDomainName": "DOMAIN_NAME", "type": "ONE_TO_ONE_NAT" }
En IPv6:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/updateAccessConfig?networkInterface=nic0 { "publicPtrDomainName": "DOMAIN_NAME", "type": "DIRECT_IPV6" }
Haz los cambios siguientes:
PROJECT_ID
: el ID del proyecto.ZONE
: la zona de la instancia.INSTANCE_NAME
: el nombre de la instancia.DOMAIN_NAME
: el nombre de dominio que se va a añadir.
Eliminar registros PTR
Para quitar registros PTR, actualiza la configuración de acceso en la interfaz de red principal,
nic0
, de una instancia de VM. Cuando quitas un registro PTR, Google Cloud responde a las peticiones de DNS invertidas con un nombre de dominio completo predeterminado:googleusercontent.com
.Consola
En la consola de Google Cloud , ve a la página Instancias de VM.
Haz clic en la instancia que quieras editar.
Haz clic en Editar.
En la sección Interfaces de red, haz clic en la interfaz de red principal.
En la sección Registro PTR de DNS público, desmarca la casilla de cada tipo de registro PTR que quieras quitar.
Haz clic en Hecho y, a continuación, en Guardar.
gcloud
Para eliminar un registro PTR, usa el comando
gcloud compute instances update-access-config
. Para eliminar los registros PTR de IPv4 e IPv6, usa los siguientes comandos por separado.En IPv4:
gcloud compute instances update-access-config INSTANCE_NAME \ --no-public-ptr
En IPv6:
gcloud compute instances update-access-config INSTANCE_NAME \ --no-ipv6-public-ptr
Sustituye
INSTANCE_NAME
por el nombre de la instancia que quieras actualizar.REST
Para eliminar un registro PTR, haz una solicitud al método
POST
instances.updateAccessConfig
. Para eliminar los registros PTR de IPv4 e IPv6, haz las siguientes solicitudes individualmente.En IPv4:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/updateAccessConfig?networkInterface=nic0 { "setPublicPtr": false, "type": "ONE_TO_ONE_NAT" }
En IPv6:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/updateAccessConfig?networkInterface=nic0 { "publicPtrDomainName": "", "type": "DIRECT_IPV6" }
Haz los cambios siguientes:
PROJECT_ID
: el ID del proyecto.ZONE
: la zona de la instancia.INSTANCE_NAME
: el nombre de la instancia.
Limitaciones
Cuando una VM se migra a otro host como parte del proceso de migración en directo durante los eventos de mantenimiento, la lógica del registro PTR no gestiona correctamente algunos casos extremos y revierte los registros PTR de DNS al nombre de dominio completo (FQDN)
googleusercontent.com
. Para restaurar la funcionalidad, vuelva a aplicar el registro PTR.Cuando detienes una VM que tiene un registro PTR de IPv6, este se anula temporalmente y no se puede ver en la VM. El registro se vuelve a añadir automáticamente al reiniciar la VM.
Siguientes pasos
- Para obtener información general sobre cómo configurar y gestionar direcciones IP externas estáticas para tus recursos, consulta el artículo Reservar una dirección IP externa estática.
- Para saber cómo crear y gestionar instancias de máquina virtual, consulta Crear y poner en marcha una instancia de VM.
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).
-