Create a DNS Record
Similar to creating a DNS zone, you need to provide the UUID of the DNS zone to host the new record.
Note: There are various record types for DNS records, and each of them has unique specifications.
Prerequisite: You need an IONOS Cloud account with API credentials configured with the appropriate permissions.
To create a DNS zone of Type A, follow this step:
Perform a POST request with these details:
corresponding UUID of the DNS zone,
name of the subdomain; example: www
record type; in this case: A,
content or destination of the A record in the form of an IPv4 address; example: 1.1.1.1
TTL you need (minimum 60 seconds and maximum 86.400 seconds), and
status of the DNS record (enable), true or false.
Result: On a successful POST request, you receive a response with the DNS record having the UUID assigned.
Info: If you want to create a Wildcard DNS record, you need to provide “*” as the name of your DNS record to match the requests for all non-existent names under your DNS zone name.
Request
Response
202 Successful operation
Response Fields
Field | Type | Description | Example |
---|---|---|---|
id | string | UUID of the newly created DNS record | 90d81ac0-3a30-44d4-95a5-12959effa6ee |
createdDate | string | DNS record creation timestamp | 2023-03-15T09:58:59.147746133Z |
lastModifiedDate | string | DNS record update timestamp | 2023-03-15T09:58:59.147746133Z |
zoneId | string | UUID of the DNS zone of the DNS record | 2a4428b3-dbe0-4357-9c02-609025b3a40f |
fqdn | string | Fully qualified domain name resulting from the record name and the zoneName | *.example.com |
state | string | State of the request | CREATED |
Create records of other types
Create records of other types Cloud DNS supports the following record types: A, AAAA , CNAME, ALIAS, MX, NS, SOA, SRV, TXT, CAA, SSHFP, TLSA, SMIMEA, DS, HTTPS, SVCB, OPENPGPKEY, CERT, URI, RP and LOC.
Here is a brief explanation of the most common record types:
A: Specifies the IPv4 address associated with a zone name.
AAAA: Specifies the IPv6 address associated with a zone name.
MX: Specifies the mail exchange servers for a zone name.
CNAME: Specifies an alias for a zone name, allowing multiple names to resolve to the same IP address.
TXT: Allows arbitrary text to be associated with a zone name that is commonly used for SPF records and other types of verification.
NS: Specifies the name servers for a zone name.
SRV: Specifies the location of services for a zone name that is commonly used for Session Initiation Protocol (SIP) and other protocols.
Here you can see examples of records with different record types:
Record Type | Record Name | Record Value | Notes |
---|---|---|---|
A | example.com | 192.168.1.1 | |
AAAA | example.com | 2001:0db8:85a3:0000:0000:8a2e:0370:7334 | |
MX | example.com | mail.example.com | Priority has to be provided |
CNAME | www.example.com | example.com | |
TXT | example.com | v=spf1 mx -all | |
NS | example.com | ns1.example.com | |
SRV | _sip._tcp.example.com | 10 5060 sipserver.example.com | Priority weight port has to be provided |
Last updated