Dominios
Seguridad
Herramientas
Empresa
USD
ES

API externa

Añadir registros de recursos DNS

Permite añadir registros de recursos DNS a un dominio. Esta operación solo tendrá efecto si el dominio está delegado a uno de los proveedores de DNS gestionados por Regery

Parámetros de URL 

•︎ domain string 
Nombre de dominio completo FQDN

Parámetros del cuerpo POST 

•︎ records object[] 
Matriz de registros de recursos DNS. Las propiedades comunes a todos los registros se indican a continuación
•︎ name string 
El nombre del registro DNS es el nombre de dominio asociado a un registro DNS concreto. Es la parte situada más a la izquierda del registro DNS e indica el host o subdominio al que se aplica el registro. Si el nombre se refiere al dominio raíz (apex) y la parte del host/subdominio debe quedar vacía, se usa el valor @.
•︎ type string 
Los tipos de registro DNS (Domain Name System) son entradas concretas de un archivo de zona DNS que permiten asociar nombres de dominio a las direcciones IP correspondientes o proporcionar otros tipos de información.
•︎ ttl number | default = 3600 
DNS TTL significa Time to Live, o tiempo de vida (en segundos). Es un parámetro de un registro del sistema de nombres de dominio (DNS) que determina durante cuánto tiempo un resolvedor DNS debe guardar la información en caché antes de actualizarla desde los servidores DNS autoritativos. Se indica en segundos y ayuda a gestionar la caché DNS y a garantizar una resolución DNS eficiente en Internet. Valor mínimo: 60. Valor máximo: 32767

Definiciones de tipos 

•︎ A object 

A: dirección IPv4 de 32 bits; suele utilizarse para indicar la correspondencia entre un nombre de host y una dirección IP.

•︎ address string 
Dirección IPv4
•︎ AAAA object 

AAAA: dirección IPv6 de 128 bits; se utiliza para indicar la correspondencia entre un nombre de host y una dirección IP.

•︎ address string 
Dirección IPv6
•︎ CNAME object 

CNAME es un tipo de registro de recursos del sistema de nombres de dominio (DNS) que se utiliza para indicar que un nombre determinado es un alias de otro nombre (dominio canónico).

Un registro CNAME siempre debe apuntar a otro nombre de dominio y nunca a una dirección IP.

Toda la información de los demás registros del alias del dominio, incluidos los registros MX y otros, se obtendrá del dominio canónico. El registro CNAME debe ser el único registro de un nombre de dominio determinado y, según la especificación, no se permite utilizar CNAME para el dominio raíz de una zona.

•︎ target string 
Nombre de dominio completo (FQDN). El valor puede contener @ para referirse al nombre de dominio raíz. Por ejemplo, para el dominio example.com, el destino CNAME www.@ se mostrará como www.example.com.
•︎ MX object 

MX (servicio de correo) es un tipo de registro de recursos del sistema de nombres de dominio (DNS) que indica los servidores de correo responsables de gestionar el correo de un nombre de dominio determinado, así como la prioridad de los servidores si hay más de uno.

•︎ priority number 
El campo priority indica el orden en que deben usarse los servidores de correo para entregar el correo a un dominio concreto. Primero se intenta con los servidores cuyo valor de prioridad es más bajo y, si no están disponibles o no responden, se recurre a los de valor más alto.
•︎ exchange string 
El campo exchange indica el nombre de dominio del servidor de correo encargado de aceptar los mensajes de correo electrónico en nombre del dominio.
•︎ TXT object 

TXT (registro de texto) es un tipo de registro de recursos del sistema de nombres de dominio (DNS) que se utiliza para indicar información adicional sobre un dominio; a menudo estos datos no solo están destinados al software, sino también a las personas.

Por ejemplo, este registro se utiliza para indicar las políticas SPF (Sender Policy Framework) de los servidores de correo.

•︎ value string 
Datos de texto asociados al registro. Estos datos pueden contener cualquier información que el propietario del dominio quiera incluir en el registro DNS. Los registros TXT se usan habitualmente para fines diversos, como la validación del dominio para servicios de correo electrónico, los registros SPF para la autenticación del correo, los registros DKIM para la seguridad del correo y otros tipos de información de texto necesarios para configurar o validar un dominio.
•︎ SRV object 

SRV (Service Record Value) se utiliza a menudo para descubrir los servicios asociados a un dominio. Este registro contiene el nombre de host, el puerto y otros datos necesarios para descubrir el servicio.

•︎ service string 
Indica el nombre simbólico del servicio para el que se crea la entrada. El valor debe empezar por un guion bajo _. Este campo identifica el servicio o protocolo concreto que define el registro SRV. Algunos nombres de servicio habituales en los registros SRV son «_sip» para los servicios SIP (Session Initiation Protocol), «_ldap» para los servicios LDAP (Lightweight Directory Access Protocol), «_xmpp» para los servicios XMPP (Extensible Messaging and Presence Protocol), etc.
•︎ proto string 
Este campo indica el protocolo de transporte que usa el servicio definido en el registro. El valor debe empezar por un guion bajo _, por ejemplo _tcp. Este campo indica si el servicio usa TCP (Transmission Control Protocol), UDP (User Datagram Protocol) u otro protocolo de transporte para la comunicación.
•︎ priority number 
Indica la prioridad del host de destino en la entrada SRV, es decir, el orden en que deben usarse los hosts de destino cuando hay varios disponibles para un mismo servicio
•︎ weight number 
Se usa junto con el campo priority para repartir la carga entre varios registros SRV con la misma prioridad. El campo «weight» indica el peso relativo de un registro SRV frente a otros registros SRV con la misma prioridad
•︎ port number 
Indica el número de puerto TCP o UDP en el que está disponible el servicio indicado en la entrada.
•︎ target string 
Indica el nombre de dominio del host de destino que presta el servicio. Este campo contiene el nombre de host del servidor que ofrece el servicio indicado en el registro SRV
•︎ CAA object 

CAA permite al propietario de un nombre de dominio DNS indicar una o varias autoridades de certificación (CA) autorizadas a emitir certificados para el dominio.

•︎ value string 
Indica el nombre de dominio de la CA (autoridad de certificación) autorizada para emitir certificados SSL/TLS para el dominio correspondiente.
•︎ tag enum 
Indica el tipo de propiedad asociada al registro CAA
issue define las autoridades de certificación autorizadas para emitir certificados para un dominio
issuewild define las autoridades de certificación autorizadas para emitir certificados Wildcard para un dominio
iodef indica la dirección de correo electrónico a la que las autoridades de certificación deben notificar las infracciones de la política
issuemail extensión no estándar que autoriza a una autoridad de certificación a emitir certificados S/MIME (de correo electrónico) para un dominio
issuevmc extensión no estándar que autoriza a una autoridad de certificación a emitir certificados VMC (Verified Mark Certificates), que permiten mostrar el logotipo de una marca en los clientes de correo compatibles con BIMI (Brand Indicators for Message Identification)
•︎ NS object 

NS: este tipo de registro indica el servidor DNS autoritativo del nombre de dominio (este servidor contiene los registros DNS actualizados). A menudo, un dominio está delegado en varios servidores DNS y tiene varios registros NS que apuntan a los servidores principales y de respaldo.

Regery prohíbe crear un registro NS para el dominio raíz de una zona. Para ello, utiliza Acciones > Cambiar servidores DNS.

•︎ ns string 
Nombre de dominio del servidor DNS
•︎ ALIAS object 

ALIAS: al igual que un registro CNAME, asocia un nombre de alias con otro nombre de dominio (dominio canónico).

Este tipo de registro no está descrito directamente en la especificación de DNS y, a diferencia de CNAME, permite indicar registros adicionales de otros tipos. Por ejemplo, si un cliente DNS solicita un registro AAAA que no existe para un dominio alias, se solicitará de forma recursiva al dominio canónico. Si el registro AAAA existe, se devolverá su valor sin consulta recursiva.

•︎ target string 
Nombre de dominio completo (FQDN). El valor puede contener @ para referirse al nombre de dominio raíz (apex). Por ejemplo, para el dominio raíz example.com, el destino www.@ se mostrará como www.example.com.