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,