IBM Cloud Docs
Gestión de registros de DNS

Gestión de registros de DNS

Los registros de DNS hacen la conexión entre los nombres legibles y las direcciones IP. En las siguientes secciones se explica cómo gestionar los registros del DNS. Gestione los registros DNS mediante la interfaz de usuario, la CLI o la API.

Añadir registros DNS en la consola

  1. En la tabla de zonas DNS, pulse el nombre de zona en la que desea añadir registros. Aparecen más detalles sobre la zona seleccionada.
  2. Pulse Añadir registro para visualizar un panel en el que puede crear un registro.

Puede utilizar el menú Tipo para seleccionar el tipo de registro que quiere crear. Cada tipo de registro de DNS tiene un Nombre y un TTL (Time-To-Live) asociado.

Cuando especifica un nombre en el campo Nombre, se añade automáticamente un nombre de dominio, si no ha añadido uno manualmente. Por ejemplo, si escribe www o www.example.com en el campo Nombre, la API maneja ambas entradas como www.example.com. Si especifica el nombre de dominio exacto en el campo de nombre, entonces no se añadirá a sí mismo (por ejemplo, example.com se maneja como example.com). Sin embargo, la lista de registros de DNS solo muestra los nombres, sin el nombre de dominio añadido. Como resultado, www.example.com se muestra como www y example.com como example.com.

El valor de TTL mínimo soportado es 1 min y el máximo es 12 hours. El valor predeterminado de TTL es 15 min, pero los usuarios pueden cambiarlo.

Añadir un registro de tipo A en la consola

Para añadir este tipo de registro, deben existir valores válidos en los campos Nombre y Dirección IPv4. Especifique un valor de TTL en el menú de la lista, con un valor predeterminado de 15 min.

Campos obligatorios

  • Nombre
  • Dirección IPv4
  • TTL (el valor predeterminado es 15 minutos)

Añadir un registro de tipo AAAA en la consola

Para añadir este tipo de registro, deben existir valores válidos en los campos Nombre y Dirección IPv6. Especifique un valor de TTL en el menú de la lista, con un valor predeterminado de 15 min.

Campos obligatorios

  • Nombre
  • Dirección IPv6
  • TTL (el valor predeterminado es 15 minutos)

Añadir un registro de tipo CNAME en la consola

Para añadir este tipo de registro, debe existir un valor válido en el campo Nombre y un nombre de dominio completo debe estar en el campo Destino (FQDN). También se puede especificar un TTL en el menú de la lista, con un valor predeterminado de 15 min.

Campos obligatorios

  • Nombre
  • Destino (para CNAME)
  • TTL (el valor predeterminado es 15 minutos)

Añadir un registro de tipo MX en la consola

Para añadir este tipo de registro, debe existir un valor válido en el campo Nombre y un nombre de dominio completo debe estar en el campo Servidor de correo (FQDN), además debe existir un número válido en el campo Prioridad. Especifique un valor de TTL en el menú de la lista, con un valor predeterminado de 15 min.

Campos obligatorios

  • Nombre
  • Servidor de correo
  • TTL (el valor predeterminado es 15 minutos)
  • Prioridad (el valor predeterminado es 1)

Añadir un registro de tipo PTR en la consola

Para añadir este tipo de registro, debe tener un registro A o AAAA existente que no esté ya asociado a otro registro PTR. Seleccione un registro existente en el menú de la lista. Especifique un valor de TTL en el menú de la lista, con un valor predeterminado de 15 min.

Campos obligatorios

  • Seleccionar registro existente
  • TTL (el valor predeterminado es 15 minutos)

Añadir un registro de tipo SRV en la consola

Para añadir este tipo de registro, deben existir valores válidos en los campos Nombre, Nombre de servicio y Destino. Utilice el menú de la lista para seleccionar un protocolo, que toma como valor predeterminado el protocolo UDP. Adicionalmente, puede especificar Prioridad, Peso y Puerto. Estos tres campos predeterminados tienen un valor de 1. Especifique un valor de TTL en el menú de la lista, con un valor predeterminado de 15 min.

Campos obligatorios

  • Nombre
  • Nombre de servicio
  • Destino
  • TTL (el valor predeterminado es 15 minutos)
  • Protocolo (el valor predeterminado es UDP)
  • Prioridad (el valor predeterminado es 1)
  • Peso (el valor predeterminado es 1)
  • Puerto (el valor predeterminado es 1)

Añadir un registro de tipo TXT en la consola

Para añadir este tipo de registro, deben existir valores válidos en los campos Nombre y Contenido. Especifique un valor de TTL en el menú de la lista, con un valor predeterminado de 15 min.

Por razones de seguridad y privacidad, se recomienda no utilizar registros de tipo TXT para datos confidenciales.

Campos obligatorios

  • Nombre
  • Contenido
  • TTL (el valor predeterminado es 15 minutos)

Actualizar los registros DNS en la consola

En cada fila de registro, pulse el icono Editar para abrir un panel en el que puede actualizar el registro.

Eliminar registros DNS en la consola

En cada fila de registro, pulse el icono Suprimir para abrir un panel en el que puede confirmar el proceso de supresión.

Importar registros de recursos en la consola

Para importar registros de recursos, realice los pasos siguientes:

  1. En la instancia de DNS Services, seleccione la zona a la que desea importar registros

  2. Pulse Seleccionar acción de registro en la sección de detalles de zona y seleccione Importar registros

  3. Puede arrastrar y soltar el archivo de importación en el panel que aparece o pulsar el enlace para cargarlo desde el sistema

    Los archivos de importación deben estar en formato de texto sin formato y no pueden superar los 8 MB

  4. Pulse Importar registros

El archivo de importación debe seguir este formato de ejemplo:

www.test.com.  900 IN  A   127.0.0.1
www.test.com.  900 IN  AAAA    ::1
w3.test.com.   900 IN  CNAME   mydomain.com.
www.test.com.  900 IN  MX  1 mail.example.com.
_service._tcp.www.sample.com.   900 IN  SRV 1 1 1 mydomain.com.
www.test.com.  900 IN  TXT "my content"

Después de importar los registros, puede revisar los detalles del estado de importación, incluido el número de archivos que se han cargado correctamente y qué registros no se han podido cargar. Si necesita cargar archivos adicionales, pulse Cargar más archivos y repita los pasos de importación. Pulse el icono X situado en la parte superior derecha del panel para cerrar el panel de importación.

Exportar registros de recursos en la consola

Para exportar registros de recursos, realice los pasos siguientes:

  1. Desde la instancia de DNS Services, seleccione la zona desde la que desea exportar registros
  2. Pulse Seleccionar acción de registro en la sección de detalles de zona y seleccione Exportar registros
  3. Especifique un nombre para el archivo exportado o acepte el nombre predeterminado de records.txt
  4. Pulse Descargar

El archivo exportado se descarga en la ubicación de descarga predeterminada especificada por el navegador.

Gestión de reconfiguraciones DNS desde la CLI

Primero utilice el mandato ibmcloud dns instance-target para establecer la instancia de servicios DNS operativos de destino.

$ ibmcloud dns instances
Retrieving service instances for service 'dns-svcs' ...
OK

Name                 ID                                     Location   State    Service Name
DNS Services-km      ffffffff-b042-41fd-885e-000000000000   global     active   dns-svcs

$ ibmcloud dns instance-target "DNS Services-km"

Almacene el ID de zona en una variable de modo que pueda utilizarlo en los mandatos siguientes sin tener que escribirlo cada vez. Por ejemplo, para almacenar el ID de zona en una variable, ejecute este mandato:

DNS_ZONE_ID="example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae"

Crear un registro de recursos de tipo ' A ' desde la CLI

Utilice el mandato ibmcloud dns resource-record-create con la opción --type A para crear un registro de recurso de tipo A --name y --ipv4 son opciones obligatorias.

$ ibmcloud dns resource-record-create $DNS_ZONE_ID --type A --name www --ipv4 192.168.1.100
Creating resource record in zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' for service instance 'DNS Services-km' ...
OK

ID            A:f20cfe91-b936-4bad-a8d1-f7afa4ac32a6
Name          www.example.com
Type          A
Created On    2020-04-10 09:12:07.858707275 +0000 UTC
Modified On   2020-04-10 09:12:07.858707275 +0000 UTC
TTL           900
Data
    ip        192.168.1.100

Crear un registro de recurso de tipo 'SRV' desde la CLI

Utilice el mandato ibmcloud dns resource-record-create con la opción --type SRV para crear un registro de recurso de tipo SRV. --name, --service, --protocol y --target son opciones obligatorias.

$ ibmcloud dns resource-record-create $DNS_ZONE_ID --type SRV --name video --service _sip --protocol tcp --priority 10 --weight 10 --port 953 --target media.example.com
Creating resource record in zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' for service instance 'DNS Services-km' ...
OK

ID             SRV:c7c8938b-87c7-4aee-95fa-63f28452c8d4
Name           _sip._tcp.video.example.com
Type           SRV
Created On     2020-04-10 09:15:56.940189115 +0000 UTC
Modified On    2020-04-10 09:15:56.940189115 +0000 UTC
TTL            900
Data
    port       953
    priority   10
    target     media.example.com
    weight     10

Crear un registro de recursos de tipo "TXT" desde la CLI

Utilice el mandato ibmcloud dns resource-record-create con la opción --type TXT para crear un registro de recurso de tipo TXT. --name y --text son opciones obligatorias.

$ ibmcloud dns resource-record-create $DNS_ZONE_ID --type TXT --name text --text "This is a text record."
Creating resource record in zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' for service instance 'DNS Services-km' ...
OK

ID            TXT:92648285-c7e5-49ef-bf8b-a5be91d5c5d3
Name          text.example.com
Type          TXT
Created On    2020-04-10 09:16:50.169135062 +0000 UTC
Modified On   2020-04-10 09:16:50.169135062 +0000 UTC
TTL           900
Data
    text      This is a text record.

Crear un registro de recursos de tipo 'MX' desde la CLI

Utilice el mandato ibmcloud dns resource-record-create con la opción --type MX para crear un registro de recurso de tipo MX. --name y --exchange son opciones obligatorias.

$ ibmcloud dns resource-record-create $DNS_ZONE_ID --type MX --name mail --preference 10 --exchange exchange.example.com
Creating resource record in zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' for service instance 'DNS Services-km' ...
OK

ID               MX:900750bf-881d-402f-a482-20447f2e64a2
Name             mail.example.com
Type             MX
Created On       2020-04-10 09:18:08.299278244 +0000 UTC
Modified On      2020-04-10 09:18:08.299278244 +0000 UTC
TTL              900
Data
    preference   10
    exchange     exchange.example.com

Crear un registro de recursos de tipo 'PTR' desde la CLI

Utilice el mandato ibmcloud dns resource-record-create con la opción --type PTR para crear un registro de recurso de tipo PTR. --name y --ptrdname son opciones obligatorias.

$ ibmcloud dns resource-record-create $DNS_ZONE_ID --type PTR --name 192.168.1.100 --ptrdname www.example.com
Creating resource record in zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' for service instance 'DNS Services-km' ...
OK

ID             PTR:f20cfe91-b936-4bad-a8d1-f7afa4ac32a6
Name           192.168.1.100
Type           PTR
Created On     2020-04-10 09:34:49.722454606 +0000 UTC
Modified On    2020-04-10 09:34:49.722454606 +0000 UTC
TTL            900
Data
    ptrdname   www.example.com

Crear un registro de recursos de tipo 'CNAME' desde la CLI

Utilice el mandato ibmcloud dns resource-record-create con la opción --type CNAME para crear un registro de recurso de tipo CNAME. --name y --cname son opciones obligatorias.

$ ibmcloud dns resource-record-create $DNS_ZONE_ID --type CNAME --name web --cname www.example.com
Creating resource record in zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' for service instance 'DNS Services-km' ...
OK

ID            CNAME:6e80f079-effd-409a-a520-b8c1b10f6e6e
Name          web.example.com
Type          CNAME
Created On    2020-04-10 09:36:13.186040793 +0000 UTC
Modified On   2020-04-10 09:36:13.186040793 +0000 UTC
TTL           900
Data
    cname     www.example.com

Crear un registro de recursos de tipo 'AAAA' desde la CLI

Utilice el mandato ibmcloud dns resource-record-create con la opción --type AAAA para crear un registro de recurso de tipo AAAA. --name y --ipv6 son opciones obligatorias.

$ ibmcloud dns resource-record-create $DNS_ZONE_ID --type AAAA --name www --ipv6 2019::2020
Creating resource record in zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' for service instance 'DNS Services-km' ...
OK

ID            AAAA:37e1e701-e549-4ca1-8c22-86574bf4aaed
Name          www.example.com
Type          AAAA
Created On    2020-04-10 09:37:15.063814601 +0000 UTC
Modified On   2020-04-10 09:37:15.063814601 +0000 UTC
TTL           900
Data
    ip        2019::2020

Obtener un registro de recursos de la CLI

Utilice el mandato ibmcloud dns resource-record seguido por el ID de zona y el ID de registro de recurso para obtener detalles de un registro de recurso.

$ ibmcloud dns resource-record $DNS_ZONE_ID A:f20cfe91-b936-4bad-a8d1-f7afa4ac32a6
Getting resource record 'A:f20cfe91-b936-4bad-a8d1-f7afa4ac32a6' in zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' for service instance 'DNS Services-km' ...
OK

ID            A:f20cfe91-b936-4bad-a8d1-f7afa4ac32a6
Name          www.example.com
Type          A
Created On    2020-04-10 09:12:07.858707275 +0000 UTC
Modified On   2020-04-10 09:34:49.986883927 +0000 UTC
TTL           900
Data
    ip        192.168.1.100

Listar registros de recursos desde la CLI

Utilice el mandato ibmcloud dns resource-records seguido por el ID de zona para listar todos los registros de recursos.

$ ibmcloud dns resource-records $DNS_ZONE_ID
Listing resource records in zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' for service instance 'DNS Services-km' ...
OK
ID                                           Name                          Type    TTL
AAAA:37e1e701-e549-4ca1-8c22-86574bf4aaed    www.example.com               AAAA    900
CNAME:6e80f079-effd-409a-a520-b8c1b10f6e6e   web.example.com               CNAME   900
MX:900750bf-881d-402f-a482-20447f2e64a2      mail.example.com              MX      900
TXT:92648285-c7e5-49ef-bf8b-a5be91d5c5d3     text.example.com              TXT     900
SRV:c7c8938b-87c7-4aee-95fa-63f28452c8d4     _sip._tcp.video.example.com   SRV     900
A:f20cfe91-b936-4bad-a8d1-f7afa4ac32a6       www.example.com               A       900
PTR:f20cfe91-b936-4bad-a8d1-f7afa4ac32a6     192.168.1.100                 PTR     900

Actualizar un registro de recursos desde la CLI

Utilice el mandato ibmcloud dns resource-record-update seguido por el ID de zona y el ID de registro de recurso para actualizar un registro de recurso.

$ ibmcloud dns resource-record-update $DNS_ZONE_ID A:f20cfe91-b936-4bad-a8d1-f7afa4ac32a6 --name www --ipv4 10.10.1.1
Updating resource record 'A:f20cfe91-b936-4bad-a8d1-f7afa4ac32a6' in zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' for service instance 'DNS Services-km' ...
OK

ID            A:f20cfe91-b936-4bad-a8d1-f7afa4ac32a6
Name          www.example.com
Type          A
Created On    2020-04-10 09:12:07.858707275 +0000 UTC
Modified On   2020-04-10 09:40:55.204076727 +0000 UTC
TTL           900
Data
    ip        10.10.1.1

Eliminar un registro de recursos desde la CLI

Utilice el mandato ibmcloud dns resource-record-delete seguido por el ID de zona y el ID de registro de recurso para suprimir un registro de recurso.

$ ibmcloud dns resource-record-delete $DNS_ZONE_ID PTR:f20cfe91-b936-4bad-a8d1-f7afa4ac32a6
Really delete resource record 'PTR:f20cfe91-b936-4bad-a8d1-f7afa4ac32a6' in zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' for service instance 'DNS Services-km'? [y/N]> y
Deleting resource record 'PTR:f20cfe91-b936-4bad-a8d1-f7afa4ac32a6' in zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' for service instance 'DNS Services-km' ...
OK

Gestión de registros DNS con la API

Primero, almacene el punto final de la API en una variable para poder utilizarla en las solicitudes de API sin tener que escribir el URL completo. Por ejemplo, para almacenar el punto final de producción en una variable, ejecute este mandato:

DNSSVCS_ENDPOINT=https://api.dns-svcs.cloud.ibm.com

Para verificar que esta variable se ha guardado, ejecute echo $DNSSVCS_ENDPOINT y asegúrese de que la respuesta no está vacía.

Crear un registro de recursos de tipo " A " con la API

Solicitud

curl -X POST \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/resource_records \
  -H "Authorization: $TOKEN" \
  -d '{
    "name":"www.example.com",
    "type":"A",
    "rdata": {
            "ip":"1.2.6.7"
        },
    "ttl":300
}'

Respuesta

{
    "id": "fa57d5d0-7729-4770-af27-6d7f8dce860c",
    "created_on": "2019-08-12 08:03:03.910471016 +0000 UTC",
    "modified_on": "2019-08-12 08:03:03.910471016 +0000 UTC",
    "rtype": "A",
    "ttl": 300,
    "name": "www.example.com",
    "id": "A:fa57d5d0-7729-4770-af27-6d7f8dce860c",
    "rdata": {
        "ip": "1.2.6.7"
    }
}

Crear un registro de recursos de tipo "SRV" con la API

Solicitud

curl -X POST \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/resource_records \
  -H "Authorization: $TOKEN" \
  -d '{
    "type": "SRV",
    "name": "example.com",
    "service": "srv",
    "protocol": "udp",
    "rdata": {
        "priority": 100,
        "weight": 100,
        "port": 8000,
        "target": "siphost.com"
    }
}'

Respuesta

{
    "created_on": "2019-08-16 08:07:41.113606 +0000 UTC",
    "modified_on": "2019-08-16 08:07:41.113606 +0000 UTC",
    "rtype": "SRV",
    "ttl": 60,
    "name": "example.com",
    "id": "SRV:7562b1f9-1a6a-4189-b794-dd84c91d6a28",
    "rdata": {
        "priority": 100,
        "weight": 100,
        "port": 8000,
        "target": "siphost.com"
    },
    "service": "srv",
    "protocol": "udp"
}

Crear un registro de recursos de tipo "TXT" con la API

Solicitud

curl -X POST \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/resource_records \
  -H "Authorization: $TOKEN" \
  -d '{
    "type": "TXT",
    "name": "txt.example.com",
    "rdata": {
        "txtdata": "txt strings"
    }
}'

Respuesta

{
    "created_on": "2019-08-16 08:15:53.360664 +0000 UTC",
    "modified_on": "2019-08-16 08:15:53.360664 +0000 UTC",
    "rtype": "TXT",
    "ttl": 60,
    "name": "txt.example.com",
    "id": "TXT:c6221d5f-69d7-4717-9951-4f69b2680fd4",
    "rdata": {
        "txtdata": "txt strings"
    }
}

Crear un registro de recursos de tipo "MX" con la API

Solicitud

curl -X POST \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/resource_records \
  -H "Authorization: $TOKEN" \
  -d '{
    "type": "MX",
    "name": "mx1.example.com",
    "rdata": {
        "exchange": "mailserver.example.com",
        "preference": 10
    }
}'

Respuesta

{
    "created_on": "2019-08-16 08:21:20.308716 +0000 UTC",
    "modified_on": "2019-08-16 08:21:20.308716 +0000 UTC",
    "rtype": "MX",
    "ttl": 60,
    "name": "mx1.example.com",
    "id": "MX:8e1b201e-00dd-46a0-a3ec-46573f908870",
    "rdata": {
        "preference": 10,
        "exchange": "mailserver.example.com"
    }
}

Crear un registro de recursos de tipo "PTR" con la API

Solicitud

curl -X POST \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/resource_records \
  -H "Authorization: $TOKEN" \
  -d '{
    "type": "PTR",
    "name": "192.168.10.100",
    "rdata": {
       "ptrdname": "www1.example.com"
    }
}'

Respuesta

{
    "created_on": "2019-08-30 06:48:16.971764628 +0000 UTC",
    "modified_on": "2019-08-30 06:48:16.971764628 +0000 UTC",
    "rtype": "PTR",
    "ttl": 60,
    "name": "100.10.168.192.in-addr.arpa",
    "id": "PTR:a47dd63a-e65a-4280-8f53-3cdb433cc78a",
    "rdata": {
        "ptrdname": "www1.example.com"
    }
}

Crear un registro de recursos de tipo "CNAME" con la API

Solicitud

curl -X POST \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/resource_records \
  -H "Authorization: $TOKEN" \
  -d '{
    "type": "CNAME",
    "name": "cname.example.com",
    "rdata": {
       "cname": "clientinterface.com"
    }
}'

Respuesta

{
    "created_on": "2019-08-16 08:29:36.710416 +0000 UTC",
    "modified_on": "2019-08-16 08:29:36.710416 +0000 UTC",
    "rtype": "CNAME",
    "ttl": 60,
    "name": "cname.example.com",
    "id": "CNAME:c95916ba-5504-499a-943a-21f5befe92b5",
    "rdata": {
        "cname": "clientinterface.com"
    }
}

Creación de un registro de recursos de tipo "AAAA" con la API

Solicitud

curl -X POST \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/resource_records \
  -H "Authorization: $TOKEN" \
  -d '{
    "type": "AAAA",
    "name": "test.example.com",
    "rdata": {
       "ip": "8000::2000"
    }
}'

Respuesta

{
    "created_on": "2019-08-16 08:34:38.311539 +0000 UTC",
    "modified_on": "2019-08-16 08:34:38.311539 +0000 UTC",
    "rtype": "AAAA",
    "ttl": 60,
    "name": "test.example.com",
    "id": "AAAA:894e165b-f066-434d-9b58-4afc2dca62c9",
    "rdata": {
        "ip": "8000::2000"
    }
}

Obtener un registro de recursos con la API

Solicitud

curl -X GET \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/resource_records/$RECORD_ID \
  -H "Authorization: $TOKEN"

Respuesta

{
    "created_on": "2019-08-12 08:03:03.910471016 +0000 UTC",
    "modified_on": "2019-08-12 08:03:32.875065176 +0000 UTC",
    "rtype": "A",
    "ttl": 300,
    "name": "www.example.com",
    "id": "A:fa57d5d0-7729-4770-af27-6d7f8dce860c",
    "rdata": {
        "ip": "9.4.6.7"
    }
}

Listar registros de recursos con la API

Solicitud

curl -X GET \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/resource_records?limit=50&offset=0 \
  -H "Authorization: $TOKEN"

Respuesta

{
    "offset": 0,
    "limit": 50,
    "total_count": 1,
    "first": {
      "href": "https://api.dns-svcs.cloud.ibm.com/v1/instances/ec0c4ee2-5d1f-4066-bcf2-dc9f3122c638/dnszones/example.com:4759caa4-d4fa-4fb9-7848-f463de19b392/resource_records?limit=50"
    },
    "resource_records": [
        {
            "created_on": "2019-08-30 04:10:25.092468565 +0000 UTC",
            "modified_on": "2019-08-30 04:10:25.092468565 +0000 UTC",
            "rtype": "A",
            "ttl": 60,
            "name": "www.example.com",
            "id": "A:ec0c4ee2-5d1f-4066-bcf2-dc9f3122c639",
            "rdata": {
                "ip": "192.168.10.100"
            }
        }
    ]
}

Actualizar un registro de recursos con la API

Solicitud

curl -X PUT \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/resource_records/$RECORD_ID \
  -H "Authorization: $TOKEN" \
  -d '{
    "name":"www",
    "rdata": {
            "ip":"7.7.7.7"
        },
    "ttl":300
}'

Respuesta

{
    "created_on":"2019-09-10 20:03:25.249355942 +0000 UTC",
    "modified_on":"2019-09-11 16:13:17.350043736 +0000 UTC",
    "rtype":"A",
    "ttl":300,
    "name":"www",
    "id":"A:139eb9f3-c646-4eb6-92fa-3ddabfb1b84f",
    "rdata":{
        "ip":"7.7.7.7"
    }
}

Eliminar un registro de recursos con la API

Solicitud

curl -X DELETE \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/resource_records/$RECORD_ID \
  -H "Authorization: $TOKEN"

Respuesta

HTTP 204 is returned, no content in response.

Importación masiva de registros de recursos desde un archivo de zona DNS con la API

Solicitud

curl -X POST \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/import_resource_records --form "file=@./bind.cfg" \
  -H "Authorization: $TOKEN"

Respuesta

{
    "total_records_parsed": 17,
    "records_added": 17,
    "records_failed": 0,
    "records_added_by_type": {
        "A": 10,
        "AAAA": 2,
        "CNAME": 4,
        "SRV": 0,
        "TXT": 0,
        "MX": 0,
        "PTR": 1
    },
    "records_failed_by_type": {
        "A": 0,
        "AAAA": 0,
        "CNAME": 0,
        "SRV": 0,
        "TXT": 0,
        "MX": 0,
        "PTR": 0
    },
    "message": null,
    "errors": null
}

Exportación masiva de registros de recursos a un archivo de zona DNS con la API

Solicitud

curl -X GET \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/export_resource_records -o dns_records.cfg \
  -H "Authorization: $TOKEN"

Respuesta

HTTP 200 is returned with zone file content in byte format