Agrega, actualiza y borra registros

Console

1. En la consola de Google Cloud, ve 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 Crear conjunto de registros, en el campo Nombre de DNS, ingresa el subdominio de la zona 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 de nivel superior. 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 del 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. Haga 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 que el agente de resolución almacena en caché este conjunto de registros de recursos, por ejemplo, 30
• RRSET_TYPE: El tipo de registro de recursos 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://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets
{
    "name": RRSET_NAME,
    "type": RRSET_TYPE,
    "ttl": TTL,
    "rrdatas": [[RR_DATA_1, RR_DATA_2]]
}

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 que el agente de resolución almacena 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…

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
}

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 con comodines, 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 crear 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…

Console

1. En la consola de Google Cloud, ve a la página de Cloud DNS.

   Ve 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 muestran 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 de DNS de tu proyecto.

El comando genera la respuesta JSON para el conjunto de registros de recursos de los primeros 100 registros. Puedes especificar estos 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 --name también debe estar presente

API

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

GET https://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONErrsets

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

Console

1. En la consola de Google Cloud, ve 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 recursos 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://www.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.

Console

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

1. En la consola de Google Cloud, ve 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 al conjunto de registros de recursos que deseas actualizar, haz clic en Editar edit.

4. Después de realizar las actualizaciones necesarias, haga 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 que el agente de resolución almacena en caché este conjunto de registros de recursos, por ejemplo, 30
• RRSET_TYPE: El tipo de registro de recursos 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://www.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 recursos de este conjunto de registros de recursos, por ejemplo, A.
• TTL: el TTL en segundos que el agente de resolución almacena 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…

Console

1. En la consola de Google Cloud, ve 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 de una zona, haz clic en el nombre de la zona.

3. Junto a 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 recursos 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://www.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 recursos de este conjunto de registros de recursos, por ejemplo, A.

gcloud

1. Para importar 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 con 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, se reemplazan los registros NS de la zona con 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 @ que denota la parte superior de la zona. En el archivo con formato de zona BIND, para un nombre de DNS como example.com, el signo @ hace referencia a example.com.. Sin embargo, en Cloud DNS, el signo arroba (@) se trata literalmente cuando se definen los nombres de los registros. Para crear un conjunto de registros de recursos para la parte superior de la zona en Cloud DNS, usa el nombre de dominio completo, por ejemplo, example.com..

     in.smtp              IN MX 5 gmail-smtp-in.l.google.com
     in.smtp.example.com. IN MX 5 gmail-smtp-in.l.google.com.example.com.
     

     Para importar tus archivos de zona, agrega un punto final (.) al final de los nombres de dominio que deben estar completamente calificados.

2. Para exportar un conjunto de registros de recursos, usa el comando dns record-sets export. Para especificar que los conjuntos de registros de recursos se exporten a un archivo con formato de zona BIND, usa la marca --zone-file-format. Por ejemplo:

   example.com. 21600 IN NS ns-gcp-private.googledomains.com.
   example.com. 21600 IN SOA ns-gcp-private.googledomains.com.
   cloud-dns-hostmaster.google.com. 1 21600 3600 259200 300
   host1.example.com. 300 IN A 192.0.2.91
   

   Si omites la marca --zone-file-format, export exporta el conjunto de registros de recursos a un archivo de registros con formato YAML:

   gcloud dns record-sets export example.zone -z=examplezonename
   

   Por ejemplo:

   ---
   kind: dns#resourceRecordSet
   name: example.com.
   rrdatas:
   - ns-gcp-private.googledomains.com.
   ttl: 21600
   type: NS
   ---
   kind: dns#resourceRecordSet
   name: example.com.
   rrdatas:
   - ns-gcp-private.googledomains.com. cloud-dns-hostmaster.google.com. 1 21600 3600 259200 300
   ttl: 21600
   type: SOA
   ---
   kind: dns#resourceRecordSet
   name: host1.example.com.
   rrdatas:
   - 192.0.2.91
   ttl: 300
   type: A
   
   

   Cloud DNS admite el tipo de registro ALIAS, que no es un tipo de registro DNS estándar y no es compatible con BIND. Si exportas conjuntos de registros de recursos a BIND, se omiten los registros ALIAS. Si una zona tiene una política de enrutamiento, se exporta como un registro con datos de registro de recursos vacíos (rrdata).