|
Der nachfolgende Artikel beschreibt, wie Sie über die weber.cloud REST-API die DNS-Zonen und DNS-Einträge Ihrer Domains verwalten können.
Die Basis-URL für alle API-Zugriffe ist https://my.weber.cloud/api. Die eigentlichen API-Befehle werden an diese Basis-URL angehängt.
Um auf die API zugreifen zu können, müssen die Zugangsdaten Ihres API-Benutzerkontos bei jedem Befehlsaufruf mittels Basic-Auth angegeben werden.
Je nachdem, ob DNS-Zonen/Einträge aufgelistet, geändert oder gelöscht werden sollen, werden für die API-Befehle unterschiedliche Request-Arten verwendet: GET-Requests zum Abfragen, PUT-Requests zum Ändern und DELETE-Requests zum löschen.
Folgende API-Befehle zur DNS-Verwaltung stehen aktuell zur Verfügung:
| Befehl |
Beschreibung |
GET /dns |
Listet alle DNS-Zonen aller DNS-Services auf.
Beispiel mit curl:
curl -u user@example.com https://my.weber.cloud/api/dns
|
GET /service/@service_id/dns |
Listet alle DNS-Zonen eines bestimmten DNS-Services auf. Die @service_id kann dem Output des GET /dns Befehls entnommen werden.
Beispiel mit curl:
curl -u user@example.com https://my.weber.cloud/api/service/1234/dns
|
GET /service/@service_id/dns/@zone_id |
Listet alle DNS-Einträge einer bestimmten DNS-Zone auf. Die @zone_id dieser DNS-Zone kann mittels dem GET /dns oder dem GET /service/@service_id/dns Befehl ermittelt werden.
Beispiel mit curl:
curl -u user@example.com https://my.weber.cloud/api/service/1234/dns/5678
|
DELETE /service/@service_id/dns/@zone_id |
Löscht eine DNS-Zone. Die @zone_id der zu löschenden Zone kann mittels dem GET /dns oder dem GET /service/@service_id/dns Befehl ermittelt werden.
Beispiel mit curl:
curl -u user@example.com -X DELETE https://my.weber.cloud/api/service/1234/dns/5678
|
POST /service/@service_id/dns/@zone_id/records |
Fügt einen neuen DNS-Eintrag zu einer DNS-Zone hinzu. Die anzugebenden Parameter für den neuen Eintrag können dem Output von GET /service/@service_id/dns/@zone_id entnommen werden.
Beispiele mit curl:
curl -u user@example.com -X POST -H "Content-Type: application/json" -d '{"name":"subdomain","type":"A","content":"192.168.169.170","ttl":86400}' https://my.weber.cloud/api/service/1234/dns/5678/records
curl -u user@example.com -X POST -H "Content-Type: application/json" -d '{"name":"subdomain","type":"MX","content":"mx.example.com","ttl":86400,"priority":80}' https://my.weber.cloud/api/service/1234/dns/5678/records
|
PUT /service/@service_id/dns/@zone_id/records/@record_id |
Ändert die Werte eines bestehenden DNS-Eintrags in einer DNS-Zone. Die @record_id und die Parameter zur Änderung des Eintrags können dem Output von GET /service/@service_id/dns/@zone_id entnommen werden.
Beispiel mit curl:
curl -u user@example.com -X PUT -H "Content-Type: application/json" -d '{"name":"subdomain","type":"MX","content":"mx1.example.com","ttl":86400,"priority":50}' https://my.weber.cloud/api/service/1234/dns/5678/records/90123
|
DELETE /service/@service_id/dns/@zone_id/records/@record_id |
Löscht einen DNS-Eintrag aus einer DNS-Zone. Die @record_id kann dem Output von GET /service/@service_id/dns/@zone_id entnommen werden.
Beispiel mit curl:
curl -u user@example.com -X DELETE https://my.weber.cloud/api/service/1234/dns/5678/records/90123
|
| 
(0 Stimme(n))