Create a DNS Record
Similar to creating a primary zone, you need to provide the UUID of the primary zone to host the new record.
Note: DNS records are further categorized into various record types, each with unique specifications. For more information, seeFAQ.
Prerequisite: You need an IONOS Cloud account with API credentials configured with the appropriate permissions.
To create a primary zone of Type A, follow this step:
1. Perform aPOST request with these details:
corresponding UUID of the primary 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.1TTL you need (minimum 60 seconds and maximum 86.400 seconds), and
status of the DNS record (enable), true or false.
Result: On a successfulPOST 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 primary zone name.
Request
curl--location\<!--markdown-link-check-disable-next-line-->--requestPOST'https://dns.de-fra.ionos.com/zones/<zone-uuid>/records/<record-uuid>'\--header'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJraWQiO'\--header'Content-Type: application/json'\--data'{ "properties": { "name": "*", "type": "A", "content": "172.30.40.50, "ttl": 3600, "enabled": true }}'Response
202 Successful operation
Response Fields
id
string
UUID of the newly created record
90d81ac0-3a30-44d4-95a5-12959effa6ee
type
string
Type of the resource
record
href
string
Absolute path to the newly created DNS record
https://dns.de-fra.ionos.com/zones/9747ccb3-e51f-4d5c-8641-b0e8805149cc/records/aa957ef3-f29e-4ebc-ba01-a763abf02878
createdDate
string
Record creation timestamp
2022-08-21T15:52:53Z
createdBy
string
Unique name of the identity that created the record
ionos:iam:cloud:31960002:users/87f9a82e-b28d-49ed-9d04-fba2c0459cd3
createdByUserId
string
The unique ID of the user who created the record
87f9a82e-b28d-49ed-9d04-fba2c0459cd3
lastModifiedDate
string
Record update timestamp
2022-08-21T15:52:53Z
lastModifiedBy
string
Unique name of the identity that created the record
ionos:iam:cloud:31960002:users/87f9a82e-b28d-49ed-9d04-fba2c0459cd3
lastModifiedByUserId
string
Unique ID of the user has last modified the record
63cef532-26fe-4a64-a4e0-de7c8a506c90
resourceURN
string
Unique name of the resource
ionos:<product>:<location>:<contract>:<resource-path>
zoneId
string
UUID of the primary 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
Quota
To retrieve the quota of DNS records, perform aGET request to the/quota endpoint.
Result: On a successfulGET request, you receive a response containing the quota limits and quota usage for your contract.
Request
Response
200 OK
Response Fields
records
string
Number of DNS records
100000
reverseRecords
string
Number of reverse DNS records
5000
secondaryZones
string
Number of secondary zones
100000
zones
string
Number of primary zones
50000
records
string
Number of DNS records used
9
reverseRecords
string
Number of reverse DNS records used
1
secondaryZones
string
Number of secondary zones used
6
zones
string
Number of primary zones used
5
Last updated
Was this helpful?