DNS-Verlauf

Gesamten Verlauf abrufen (Get All DNS Zones History)

Ruft den Änderungsverlauf (Audit-Logs) für alle DNS-Zonen innerhalb einer bestimmten Organisation ab. Die Ergebnisse werden paginiert zurückgegeben.

URL: GET /api/v1/organizations/{organizationId}/dns-zones/history

Pfadparameter:

• organizationId (String/UUID, erforderlich): Die eindeutige ID der Organisation.

Query-Parameter (optional):

• page (Integer): Die aktuelle Seitennummer (Standard: 1).
• size (Integer): Anzahl der Einträge pro Seite (Maximal: 500, Standard: 50).
• filter (String): Filtert die Ergebnisse basierend auf bestimmten Bedingungen (z. B. actionType eq Update).
• sort (String): Sortiert die Ergebnisse (z. B. timestamp:desc).
• search (String): Führt eine Volltextsuche über mehrere Felder durch.

Beispielanfrage (cURL):

curl -X GET "[https://publicapi.stackit.domains/api/v1/organizations/0a35deaa-6e8d-4cdb-9de3-9e8928658ae6/dns-zones/history?page=1&size=20](https://publicapi.stackit.domains/api/v1/organizations/0a35deaa-6e8d-4cdb-9de3-9e8928658ae6/dns-zones/history?page=1&size=20)" \
-H "Authorization: Bearer <YOUR_TOKEN>"

Beispielantwort (200 OK):

{
  "items": [
    {
      "historyId": "5f93e5bc-bcc8-47bd-b6cd-4183cded90a6",
      "timestamp": "2025-01-23T10:53:54.415Z",
      "actionType": "Restore",
      "resourceType": "DnsZone",
      "productId": "dcadda4d-ca05-4756-9ba5-a444e2cd9afd",
      "organizationId": "0a35deaa-6e8d-4cdb-9de3-9e8928658ae6",
      "userName": "initialuser@stackit.cloud",
      "changeDetails": "Restored DNS Zone to snapshot from 2025-01-22",
      "version": 1
    },
    {
      "historyId": "9a23e5bc-bcc8-47bd-b6cd-4183cded90a9",
      "timestamp": "2025-01-22T08:30:00.000Z",
      "actionType": "Update",
      "resourceType": "DnsZone",
      "productId": "dcadda4d-ca05-4756-9ba5-a444e2cd9afd",
      "organizationId": "0a35deaa-6e8d-4cdb-9de3-9e8928658ae6",
      "userName": "admin@stackit.cloud",
      "changeDetails": "Updated SOA Refresh Interval",
      "version": 0
    }
  ],
  "pagination": {
    "page": 1,
    "size": 20,
    "totalCount": 21,
    "totalPages": 2
  }
}

Zonenspezifischen Verlauf abrufen (Get DNS Zone History)

Ruft detaillierte Protokolleinträge und Snapshots für eine bestimmte DNS-Zone ab. Dies ist der erste Schritt, wenn Sie eine bestimmte Zone wiederherstellen möchten, um die korrekte historyId zu identifizieren.

URL: GET /api/v1/organizations/{organizationId}/dns-zones/{dnsZoneId}/history

Pfadparameter:

• organizationId (String/UUID, erforderlich): Die eindeutige ID der Organisation.
• dnsZoneId (String/UUID, erforderlich): Die eindeutige ID der DNS-Zone.

(Die Query-Parameter für Paginierung, Filterung, Sortierung und Suche sind identisch mit denen des gesamten Verlaufs).

Beispielanfrage (cURL):

curl -X GET "https://publicapi.stackit.domains/api/v1/organizations/0a35deaa-6e8d-4cdb-9de3-9e8928658ae6/dns-zones/dcadda4d-ca05-4756-9ba5-a444e2cd9afd/history" \
-H "Authorization: Bearer <YOUR_TOKEN>"

Beispielantwort (200 OK) Die Antwortstruktur ist identisch mit der Gesamtabfrage (HistoryPaginationResponse), gefiltert nach der jeweiligen Zone.

DNS-Zone wiederherstellen

Stellt eine bestimmte DNS-Zone aus dem Verlauf (Snapshot) auf einen früheren Zustand wieder her.

This action overwrites the current state of the DNS zone (including all records and forwards) with the state of the selected snapshot.

URL: POST /api/v1/organizations/{organizationId}/dns-zones/{dnsZoneId}/history/{historyId}/restore

Path Parameters:

• organizationId (String/UUID, erforderlich): Die eindeutige ID der Organisation.
• dnsZoneId (String/UUID, erforderlich): Die eindeutige ID der wiederherzustellenden DNS-Zone.
• historyId (string/UUID, required): (String/UUID, erforderlich): Die ID des Verlaufseintrags (Snapshots), auf den die Zone wiederhergestellt werden soll.

Beispielanfrage (cURL):

curl -X POST "https://publicapi.stackit.domains/api/v1/organizations/0a35deaa-6e8d-4cdb-9de3-9e8928658ae6/dns-zones/dcadda4d-ca05-4756-9ba5-a444e2cd9afd/history/9a23e5bc-bcc8-47bd-b6cd-4183cded90a9/restore" \
-H "Authorization: Bearer <YOUR_TOKEN>" \
-H "Content-Length: 0"

Beispielantwort:

(204 No Content) Wenn die Wiederherstellung erfolgreich war, antwortet der Server mit dem HTTP-Statuscode 204 No Content und einem leeren Body.