Examples in

DNS-Einträge

Ein Record-Set ist ein Tupel (name, type) innerhalb einer Zone und enthält einen oder mehrere Werte. www.example.com → A → 203.0.113.5 ist ein A-Record-Set mit einem einzigen Wert; Sets mit mehreren Werten (Round-Robin-DNS) enthalten N Werte unter einer Set-ID.

Unterstützte Eintragstypen

Typ	Zweck	Beispielwert
A	IPv4-Adresse	`203.0.113.5`
AAAA	IPv6-Adresse	`2001:db8::1`
CNAME	Alias auf einen anderen Namen	`other.example.com.`
MX	Mailserver	`10 mail.example.com.`
TXT	Freitext — Verifizierung, SPF, DKIM, DMARC	`"v=spf1 -all"`
SRV	Standort eines Dienstes	`10 5 5060 sip.example.com.`
NS	Delegierung an andere Nameserver	`ns1.other.com.`
CAA	Autorisierung von Zertifizierungsstellen	`0 issue "letsencrypt.org"`
PTR	Reverse-DNS-Zeiger (für Floating-IPs)	Siehe Floating-IPs

Nicht unterstützt werden: ALIAS / ANAME (CNAME-Flattening am Apex) — verwenden Sie stattdessen den CNAME auf einer Subdomain oder am Apex einen A-Eintrag, der auf eine Floating-IP zeigt.

Einträge mit mehreren Werten

Sie können mehrere Werte in ein Record-Set aufnehmen:

Text

www.example.com → A → 203.0.113.5
                  → 203.0.113.6
                  → 203.0.113.7

Die Nameserver liefern bei jeder Abfrage alle drei Werte, und Resolver verteilen die Requests darauf — einfaches Round-Robin-Load-Balancing ohne LB. Für echtes Load-Balancing richten Sie den Eintrag stattdessen auf die VIP eines Load Balancers; mehrere Werte sind für Fälle gedacht, in denen Client + Resolver das Failover selbst übernehmen können (die meisten modernen HTTP-Clients können das).

TTLs

Jedes Record-Set hat eine TTL in Sekunden — wie lange Resolver die Antwort zwischenspeichern, bevor sie erneut abfragen. Standardwerte:

A / AAAA / CNAME: 300 Sekunden (5 Minuten) — gut für schnelle Updates / Failover
MX / NS: 3600 (1 Stunde) — diese ändern sich selten
TXT für Verifizierung: 60 — kurz, damit erneute Verifizierungsprüfungen schnell gehen

Wählen Sie niedrigere TTLs, solange Sie noch aktiv ändern; erhöhen Sie sie, sobald die Einträge stabil sind, um Abfragevolumen + Kosten zu senken.

Nächste Schritte

DNS-Zonen — der Container, in dem Einträge liegen.
Floating-IPs — häufiges Ziel von A/AAAA-Einträgen.
Load Balancer — VIP-Ziel für Dienste mit mehr Traffic.

Reference

GET/api/v1/recordsets/

List All Recordsets

Lists all DNS recordsets owned by the calling project across zones.

Parameters

Name	In	Type	Description
limit	query	integer \| null	—
marker	query	string \| null	—
sort_dir	query	string \| null	—
sort_key	query	string \| null	—
name	query	string \| null	—
type	query	"A" \| "AAAA" \| "MX" \| "CNAME" \| "TXT" \| "NS" \| "SOA" \| "SPF" \| "SRV" \| "PTR" \| "CAA" \| "SSHFP" \| "NAPTR" \| null	—
ttl	query	integer \| null	—
status	query	string \| null	—
description	query	string \| null	—
data	query	string \| null	—

Responses

200Successful Response
401Unauthorized
403Forbidden
422Validation error
429Too Many Requests
500Internal Server Error

Example

curl -X GET "https://api.nimbusnexus.net/api/v1/recordsets/" \
  -H "Authorization: Bearer $NIMBUS_KEY"

GET/api/v1/zones/{zone_id}/recordsets/

List Zone Recordsets

Lists the recordsets contained in the specified DNS zone.

Parameters

Name	In	Type	Description
zone_id*	path	string	Parent zone ID
limit	query	integer \| null	—
marker	query	string \| null	—
sort_dir	query	string \| null	—
sort_key	query	string \| null	—
name	query	string \| null	—
type	query	"A" \| "AAAA" \| "MX" \| "CNAME" \| "TXT" \| "NS" \| "SOA" \| "SPF" \| "SRV" \| "PTR" \| "CAA" \| "SSHFP" \| "NAPTR" \| null	—
ttl	query	integer \| null	—
status	query	string \| null	—
description	query	string \| null	—

Responses

200Successful Response
401Unauthorized
403Forbidden
404Not Found
422Validation error
429Too Many Requests
500Internal Server Error

Example

curl -X GET "https://api.nimbusnexus.net/api/v1/zones/<zone_id>/recordsets/" \
  -H "Authorization: Bearer $NIMBUS_KEY"

POST/api/v1/zones/{zone_id}/recordsets/

Create Recordset

Creates a new recordset within the specified DNS zone.

Parameters

Name	In	Type	Description
zone_id*	path	string	Parent zone ID

Request body

Field	Type	Description
name*	string	RecordSet name (relative or FQDN)
type*	"A" \| "AAAA" \| "MX" \| "CNAME" \| "TXT" \| "NS" \| "SOA" \| "SPF" \| "SRV" \| "PTR" \| "CAA" \| "SSHFP" \| "NAPTR"	—
records*	array of string	List of RR data strings
ttl	integer \| null	TTL for the recordset
description	string \| null	Human-readable description

Responses

201Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
422Validation error
429Too Many Requests
500Internal Server Error

Example

curl -X POST "https://api.nimbusnexus.net/api/v1/zones/<zone_id>/recordsets/" \
  -H "Authorization: Bearer $NIMBUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Example",
    "type": "A",
    "records": [
      "example"
    ]
  }'

GET/api/v1/zones/{zone_id}/recordsets/{recordset_id}

Get Recordset

Retrieves a single recordset by zone and recordset identifiers.

Parameters

Name	In	Type	Description
zone_id*	path	string	Parent zone ID
recordset_id*	path	string	Recordset ID
admin_domain	query	string \| null	—
admin_project	query	string \| null	—

Responses

200Successful Response
401Unauthorized
403Forbidden
404Not Found
422Validation error
429Too Many Requests
500Internal Server Error

Example

curl -X GET "https://api.nimbusnexus.net/api/v1/zones/<zone_id>/recordsets/<recordset_id>" \
  -H "Authorization: Bearer $NIMBUS_KEY"

PUT/api/v1/zones/{zone_id}/recordsets/{recordset_id}

Update Recordset

Updates the records or attributes of an existing recordset.

Parameters

Name	In	Type	Description
recordset_id*	path	string	Recordset ID
zone_id*	path	string	Parent zone ID

Request body

Field	Type	Description
ttl	integer \| null	—
description	string \| null	—
records	array of string \| null	List of RR data strings

Responses

202Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
422Validation error
429Too Many Requests
500Internal Server Error

Example

curl -X PUT "https://api.nimbusnexus.net/api/v1/zones/<zone_id>/recordsets/<recordset_id>" \
  -H "Authorization: Bearer $NIMBUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE/api/v1/zones/{zone_id}/recordsets/{recordset_id}

Delete Recordset

Deletes a recordset from the specified DNS zone.

Parameters

Name	In	Type	Description
recordset_id*	path	string	Recordset ID
zone_id*	path	string	Parent zone ID
admin_domain	query	string \| null	—
admin_project	query	string \| null	—

Responses

202Successful Response
401Unauthorized
403Forbidden
404Not Found
422Validation error
429Too Many Requests
500Internal Server Error

Example

curl -X DELETE "https://api.nimbusnexus.net/api/v1/zones/<zone_id>/recordsets/<recordset_id>" \
  -H "Authorization: Bearer $NIMBUS_KEY"

Need to make a real call? Try these endpoints in the live Swagger UI →

Edit this page on GitHub