Agrega, actualiza y borra registros

En esta página, se describe cómo agregar, actualizar y borrar conjuntos de registros de recursos.

Para ver la lista de tipos de registros de recursos admitidos, consulta Tipos de registros de recursos admitidos.

Antes de comenzar

  1. Crea una zona administrada. Completa los requisitos previos para crear una zona administrada y crea una zona administrada.

  2. Selecciona un tipo de registro de recursos compatible. Elige un tipo de registro de recursos para tu conjunto de registros de recursos.

Agrega un conjunto de registros de recursos

Sigue estos pasos para crear un conjunto de registros de recursos:

Consola

  1. En la consola Google Cloud , dirígete a la página Zonas de Cloud DNS.

    Ir a Zonas de Cloud DNS

  2. Haz clic en el nombre de la zona administrada a la que deseas agregar el registro.

  3. En la página Detalles de la zona, haz clic en Agregar estándar.

  4. En la página Crea un conjunto de registros, en el campo Nombre de DNS, ingresa el subdominio de la zona del DNS, por ejemplo, mail. El punto final se agrega automáticamente al final.

    Para crear un registro DNS comodín, ingresa un asterisco, por ejemplo, *.example.com.

    El signo arroba (@) no crea automáticamente un registro del dominio raíz. Para crear un registro de recursos en la parte superior del dominio, deja el campo Nombre de DNS en blanco.

  5. Selecciona el Tipo de registros de recursos, por ejemplo, MX.

  6. En el campo TTL, ingresa un valor numérico para el tiempo de actividad del registro de recursos. Este valor indica el tiempo que se puede almacenar en caché. El valor debe ser un número entero positivo.

  7. En el menú Unidad TTL, selecciona la unidad de tiempo, por ejemplo, minutes.

  8. Según el tipo de registro de recursos que seleccionaste, propaga los campos restantes.

  9. Para ingresar información adicional, haz clic en Agregar elemento.

  10. Haz clic en Crear.

gcloud

Para agregar un conjunto de registros de recursos, usa el comando gcloud dns record-sets create:

gcloud dns record-sets create RRSET_NAME \
    --rrdatas=RR_DATA \
    --ttl=TTL \
    --type=RRSET_TYPE \
    --zone=MANAGED_ZONE

Reemplaza lo siguiente:

  • RRSET_NAME: el nombre de DNS que coincide con las consultas entrantes con el nombre DNS de esta zona como sufijo; por ejemplo, test.example.com
  • RR_DATA: un valor arbitrario asociado con el conjunto de registros de recursos; por ejemplo, 198.51.100.5. También puedes ingresar varios valores, rrdata1 rrdata2 rrdata3; por ejemplo, 198.51.100.5 10.2.3.4…
  • TTL: el TTL en segundos para que el agente de resolución almacene en caché este conjunto de registros de recursos; por ejemplo, 30
  • RRSET_TYPE: el tipo de registro de recurso de este conjunto de registros de recursos; por ejemplo, A
  • MANAGED_ZONE: la zona administrada con la que está afiliado este conjunto de registros de recursos; por ejemplo, my-zone-name. El nombre de este conjunto de registros de recursos debe tener el nombre de DNS de la zona administrada como su sufijo

API

Para agregar un conjunto de registros de recursos, usa el método resourceRecordSets.create:

POST https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets
{
    "name": "RRSET_NAME",
    "type": "RRSET_TYPE",
    "ttl": TTL,
    "rrdatas": [ RR_DATA ]
}

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto
  • MANAGED_ZONE: la zona administrada con la que está afiliado este conjunto de registros de recursos; por ejemplo, my-zone-name. El nombre de este conjunto de registros de recursos debe tener el nombre de DNS de la zona administrada como su sufijo
  • RRSET_NAME: el nombre de DNS que coincide con las consultas entrantes con el nombre DNS de esta zona como sufijo; por ejemplo, test.example.com
  • RRSET_TYPE: el tipo de registro de recurso de este conjunto de registros de recursos; por ejemplo, A
  • TTL: el TTL en segundos para que el agente de resolución almacene en caché este conjunto de registros de recursos; por ejemplo, 30
  • RR_DATA: un valor arbitrario asociado con el conjunto de registros de recursos; por ejemplo, "198.51.100.5". También puedes ingresar varios valores en una lista separada por comas; por ejemplo, "198.51.100.5","10.2.3.4"

Terraform 

resource "google_dns_managed_zone" "parent_zone" {
  name        = "sample-zone"
  dns_name    = "sample-zone.hashicorptest.com."
  description = "Test Description"
}

resource "google_dns_record_set" "default" {
  managed_zone = google_dns_managed_zone.parent_zone.name
  name         = "test-record.sample-zone.hashicorptest.com."
  type         = "A"
  rrdatas      = ["10.0.0.1", "10.1.0.1"]
  ttl          = 86400
}

Agrega una colección de conjuntos de registros de recursos en una transacción

Puedes agregar varios conjuntos de registros de recursos creando una transacción que especifique los cambios. Una transacción es un grupo de uno o más cambios de registros DNS que se deben aplicar como una unidad. La transacción se completa o falla en su totalidad, lo que garantiza que tus datos nunca queden en un estado incoherente. Solo puedes crear una transacción con gcloud CLI o la API de Cloud DNS.

Para crear una transacción, sigue estos pasos:

gcloud

  1. Para iniciar una transacción, usa el comando gcloud dns record-sets transaction start:

    gcloud dns record-sets transaction start \
   --zone=MANAGED_ZONE

    Reemplaza MANAGED_ZONE por el nombre de la zona administrada cuyos conjuntos de registros de recursos quieres administrar; por ejemplo, my-zone-name.

  2. Para agregar un conjunto de registros de recursos como parte de una transacción, usa el comando gcloud dns record-sets transaction add:

    gcloud dns record-sets transaction add RR_DATA \
   --name=DNS_NAME \
   --ttl=TTL \
   --type=RECORD_TYPE \
   --zone=MANAGED_ZONE

    Reemplaza lo siguiente:

    • RR_DATA: un valor arbitrario asociado con el conjunto de registros de recursos; por ejemplo, 198.51.100.5. También puedes ingresar varios valores, rrdata1 rrdata2 rrdata3; por ejemplo, 198.51.100.5 10.2.3.4…
    • DNS_NAME: el nombre de dominio o DNS del conjunto de registros que se agregará; por ejemplo, test.example.com
    • TTL: el tiempo de actividad (TTL) para el conjunto de registros en cantidad de segundos; por ejemplo, 300
    • RECORD_TYPE: el tipo de registro; por ejemplo, A
    • MANAGED_ZONE: el nombre de la zona administrada cuyos conjuntos de registros de recursos quieres administrar; por ejemplo,my-zone-name

  3. Para ejecutar la transacción, usa el comando gcloud dns record-sets transaction execute:

    gcloud dns record-sets transaction execute \
   --zone=MANAGED_ZONE

  4. Para agregar una transacción comodín, usa el comando gcloud dns record-sets transaction add:

    gcloud dns record-sets transaction add \
   --zone=MANAGED_ZONE \
   --name=WILDCARD_DNS_NAME \
   --type=RECORD_TYPE \
   --ttl=TTL

    Reemplaza lo siguiente:

    • MANAGED_ZONE: el nombre de la zona administrada cuyos conjuntos de registros de recursos quieres administrar; por ejemplo,my-zone-name
    • WILDCARD_DNS_NAME: el nombre de dominio o DNS del conjunto de registros de recursos que deseas agregar; por ejemplo, *.example.com. (ten en cuenta el punto final)
    • RECORD_TYPE: el tipo de registro; por ejemplo, CNAME
    • TTL: el TTL del conjunto de registros en cantidad de segundos; por ejemplo, 300

API

Para actualizar una transacción con nuevos conjuntos de registros de recursos, usa el método changes.create:

POST https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/changes

{
  "deletions": []
  "additions": [
    {
      "name": DNS_NAME,
      "type": RECORD_TYPE,
      "ttl": TTL,
      "rrdatas": [
        RR_DATA
      ]
    }
  ]
}

Reemplaza lo siguiente:

  • PROJECT_ID: el ID de tu proyecto
  • MANAGED_ZONE: el nombre o ID de tu zona administrada
  • DNS_NAME: el nombre de dominio o DNS del conjunto de registros; por ejemplo, test.example.com. (ten en cuenta el punto final)
  • RECORD_TYPE: el tipo de registro
  • TTL: el tiempo de actividad (TTL) para el conjunto de registros en cantidad de segundos; por ejemplo, 30
  • RR_DATA: un valor arbitrario asociado con el conjunto de registros de recursos; por ejemplo, 198.51.100.5. También puedes ingresar varios valores, rrdata1 rrdata2 rrdata3; por ejemplo, 198.51.100.5 10.2.3.4…

Para entregar correos electrónicos a tu dominio, debes agregar registros MX a tu zona. Si usas Google Workspace como proveedor del Protocolo de transferencia simple de correo electrónico (SMTP), consulta la página de asistencia para configurar registros MX de Google Workspace. De lo contrario, usa los detalles del registro MX de tu proveedor y sigue el proceso de configuración que se describe para Google Workspace.

Visualiza los conjuntos de registros de recursos de una zona

Para ver los conjuntos de registros de recursos de una zona, sigue estos pasos:

Consola

  1. En la consola Google Cloud , dirígete a la página de Cloud DNS.

    Ir a Cloud DNS

  2. En la pestaña Zonas, haz clic en la zona para la que deseas ver los conjuntos de registros de recursos.

    En la página Detalles de la zona, se enumeran los detalles de todos los conjuntos de registros de recursos de esa zona.

gcloud

Para ver los registros DNS de tu zona, usa el comando gcloud dns record-sets list:

gcloud dns record-sets list \
   --zone="ZONE_NAME"

Reemplaza ZONE_NAME por el nombre de una zona del DNS de tu proyecto.

El comando genera la respuesta JSON para el conjunto de registros de recursos de los primeros 100 registros. Puedes especificar los siguientes parámetros adicionales:

  • --limit: la cantidad máxima de conjuntos de registros en la lista
  • --name: solo enumera conjuntos de registros de recursos con este nombre de dominio exacto
  • --type: solo detalla los registros de este tipo. Si está presente, el parámetro también debe estar presente.

API

Para ver los registros DNS de tu zona, usa el método resourceRecordSets.list:

GET https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto
  • MANAGED_ZONE: la zona administrada con la que está afiliado este conjunto de registros de recursos; por ejemplo, my-zone-name. El nombre de este conjunto de registros de recursos debe tener el nombre de DNS de la zona administrada como su sufijo

Visualiza detalles de un conjunto de registros de recursos

En este procedimiento, se da por sentado que ya creaste un conjunto de registros de recursos dentro de la zona administrada de Cloud DNS.

Para visualizar los detalles de un conjunto de registros de recursos existente, sigue estos pasos:

Consola

  1. En la consola Google Cloud , dirígete a la página Zonas de Cloud DNS.

    Ir a Zonas de Cloud DNS

  2. Haz clic en la zona que contiene el conjunto de registros de recursos.

  3. Haz clic en el conjunto de registros de recursos cuyos detalles deseas ver.

    En la página Detalles del conjunto de registros de recursos, se muestran los detalles del conjunto de registros de recursos.

gcloud

Para ver los detalles de un conjunto de registros de recursos existente, usa el comando gcloud dns record-sets describe:

gcloud dns record-sets describe RRSET_NAME \
  --type=RRSET_TYPE \
  --zone=MANAGED_ZONE

Reemplaza lo siguiente:

  • RRSET_NAME: el nombre de DNS que coincide con las consultas entrantes con el nombre DNS de esta zona como sufijo; por ejemplo, test.example.com
  • RRSET_TYPE: el tipo de registro de recurso de este conjunto de registros de recursos; por ejemplo, A
  • MANAGED_ZONE: la zona administrada con la que está afiliado este conjunto de registros de recursos; por ejemplo, my-zone-name. El nombre de este conjunto de registros de recursos debe tener el nombre de DNS de la zona administrada como su sufijo

API

Para obtener los detalles de un conjunto de registros de recursos existente, usa el método resourceRecordSets.get:

GET https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets/RRSET_NAME/RRSET_TYPE

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto
  • MANAGED_ZONE: la zona administrada con la que está afiliado este conjunto de registros de recursos; por ejemplo, my-zone-name. El nombre de este conjunto de registros de recursos debe tener el nombre de DNS de la zona administrada como su sufijo
  • RRSET_NAME: el nombre de DNS que coincide con las consultas entrantes con el nombre DNS de esta zona como sufijo; por ejemplo, test.example.com
  • RRSET_TYPE: el tipo de registro de este conjunto de registros de recursos; por ejemplo, A

Actualiza un conjunto de registros de recursos

Para crear un conjunto de registros, sigue estos pasos:

Consola

Para aplicar una actualización parcial a un conjunto de registros de recursos existente, sigue estos pasos:

  1. En la consola Google Cloud , dirígete a la página Zonas de Cloud DNS.

    Ir a Zonas de Cloud DNS

  2. Haz clic en la zona para la que deseas actualizar el conjunto de registros de recursos.

  3. En la página Detalles de la zona, junto con el conjunto de registros de recursos que deseas actualizar, haz clic en Editar.

  4. Después de realizar las actualizaciones necesarias, haz clic en Guardar.

.

gcloud

Para aplicar una actualización parcial a un conjunto de registros de recursos existente, usa el comando gcloud dns record-sets update:

gcloud dns record-sets update RRSET_NAME \
    --rrdatas=RR_DATA \
    --ttl=TTL \
    --type=RRSET_TYPE \
    --zone=MANAGED_ZONE

Reemplaza lo siguiente:

  • RRSET_NAME: el nombre de DNS que coincide con las consultas entrantes con el nombre DNS de esta zona como sufijo; por ejemplo, test.example.com
  • RR_DATA: un valor arbitrario asociado con el conjunto de registros de recursos; por ejemplo, 198.51.100.5. También puedes ingresar varios valores, rrdata1 rrdata2 rrdata3; por ejemplo, 198.51.100.5 10.2.3.4…
  • TTL: el TTL en segundos para que el agente de resolución almacene en caché este conjunto de registros de recursos; por ejemplo, 30
  • RRSET_TYPE: el tipo de registro de recurso de este conjunto de registros de recursos; por ejemplo, A
  • MANAGED_ZONE: la zona administrada con la que está afiliado este conjunto de registros de recursos; por ejemplo, my-zone-name. El nombre de este conjunto de registros de recursos debe tener el nombre de DNS de la zona administrada como su sufijo

API

Para aplicar una actualización parcial a un conjunto de registros de recursos existente, usa el método resourceRecordSets.patch:

PATCH https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets/RRSET_NAME/RRSET_TYPE
{
  "ttl": TTL,
  "rrdatas": RR_DATA,
  "update_mask": {
      "paths": ["rrset.ttl", "rrset.rrdatas"]
  }
}

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto
  • MANAGED_ZONE: la zona administrada con la que está afiliado este conjunto de registros de recursos; por ejemplo, my-zone-name. El nombre de este conjunto de registros de recursos debe tener el nombre de DNS de la zona administrada como su sufijo
  • RRSET_NAME: el nombre de DNS que coincide con las consultas entrantes con el nombre DNS de esta zona como sufijo; por ejemplo, test.example.com
  • RRSET_TYPE: el tipo de registro de recurso de este conjunto de registros de recursos; por ejemplo, A
  • TTL: el TTL en segundos para que el agente de resolución almacene en caché este conjunto de registros de recursos; por ejemplo, 30
  • RR_DATA: un valor arbitrario asociado con el conjunto de registros de recursos; por ejemplo, 198.51.100.5. También puedes ingresar varios valores, rrdata1 rrdata2 rrdata3; por ejemplo, 198.51.100.5 10.2.3.4…

Borra conjuntos de registros de recursos

Cuando borras conjuntos de registros de recursos, sus registros DNS se quitan de forma permanente y no se pueden recuperar. Para evitar perder tus registros DNS, exporta los conjuntos de registros de recursos antes de su eliminación. Para obtener información sobre cómo exportar conjuntos de registros de recursos, consulta Importa y exporta conjuntos de registros de recursos.

Las zonas públicas de Cloud DNS son autorizadas, y los tipos de registros de servidor de nombres (NS) y de inicio de autoridad (SOA) se encuentran en el dominio raíz de la zona, que es la raíz de ese dominio. Cloud DNS crea automáticamente registros NS y SOA en el dominio raíz. Estos registros no se pueden borrar con la API de Cloud DNS y se borran automáticamente cuando se borra la zona. Para obtener más información, consulta RFC 1034.

Para borrar conjuntos de registros de recursos, sigue estos pasos:

Consola

  1. En la consola Google Cloud , dirígete a la página de Cloud DNS.

    Ir a Zonas de Cloud DNS

    Los registros de la zona se enumeran en la página Detalles de la zona.

  2. Para borrar conjuntos de registros de recursos en una zona, haz clic en el nombre de la zona.

  3. Junto con los conjuntos de registros de recursos que deseas borrar, selecciona la casilla de verificación.

  4. Haz clic en Borrar conjuntos de registros.

gcloud

Para borrar un conjunto de registros de recursos existente, usa el comando gcloud dns record-sets delete:

gcloud dns record-sets delete RRSET_NAME \
    --type=RRSET_TYPE \
    --zone=MANAGED_ZONE

Reemplaza lo siguiente:

  • RRSET_NAME: el nombre de DNS que coincide con las consultas entrantes con el nombre DNS de esta zona como sufijo; por ejemplo, test.example.com
  • RRSET_TYPE: el tipo de registro de recurso de este conjunto de registros de recursos; por ejemplo, A
  • MANAGED_ZONE: la zona administrada con la que está afiliado este conjunto de registros de recursos; por ejemplo, my-zone-name. El nombre de este conjunto de registros de recursos debe tener el nombre de DNS de la zona administrada como su sufijo

API

Para borrar un conjunto de registros de recursos existente, usa el método resourceRecordSets.delete:

DELETE https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets/RRSET_NAME/RRSET_TYPE

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto
  • MANAGED_ZONE: la zona administrada con la que está afiliado este conjunto de registros de recursos; por ejemplo, my-zone-name. El nombre de este conjunto de registros de recursos debe tener el nombre de DNS de la zona administrada como su sufijo
  • RRSET_NAME: el nombre de DNS que coincide con las consultas entrantes con el nombre DNS de esta zona como sufijo; por ejemplo, test.example.com
  • RRSET_TYPE: el tipo de registro de recurso de este conjunto de registros de recursos; por ejemplo, A

Importa y exporta conjuntos de registros de recursos

Para copiar conjuntos de registros de recursos dentro y fuera de una zona administrada, puedes usar los comandos import y export. Puedes importar y exportar al formato de archivo de zona BIND o al formato de archivo YAML.

gcloud

  1. Para crear un conjunto de registros de recursos, usa el comando dns record-sets import:

    gcloud dns record-sets import -z=ZONE_NAME

    Si deseas especificar el formato de archivo del archivo de zona, usa el comando anterior con la marca --zone-file-format. Si omites la marca, debes proporcionar un archivo de zona en formato YAML.

    Reemplaza ZONE_NAME por un nombre nuevo para tu zona.

    • Cuando usas el comando gcloud dns record-sets import con la marca --replace-origin-ns, este reemplaza los registros NS de la zona por los registros NS especificados en el archivo de zona. Estos registros deben coincidir con los servidores de nombres asignados por Cloud DNS para alojar la zona. También deben coincidir con los registros NS especificados en la zona superior (de delegación). De forma predeterminada, Cloud DNS no reemplaza los registros NS. Si usas esta marca, debes verificar que los registros NS sean correctos.

    • Cuando importes conjuntos de registros como un archivo con formato de zona BIND, quita el signo arroba (@) que denota el dominio raíz de la zona. En el archivo con formato de zona BIND, para un nombre de DNS como