Alle Mitigationen eines Netzwerks auflisten¶

Note

Die Schwellenwert- und Traffic-Werte — configured_bw, configured_pps, configured_bw_percentage, configured_pps_percentage, actual_bw, actual_pps, peak_bw, peak_pps, total_bw, total_pps sowie (wenn die Funktion für den Bericht zu verworfenen Daten aktiviert ist) dropped_bits und dropped_packets — werden nur für automatische (durch Erkennung ausgelöste) Mitigationen zurückgegeben. Bei manuellen Mitigationen, die keine Erkennungsdaten enthalten, entfallen sie.

Note

SOC-Konten müssen stattdessen eine Organisation explizit über den Endpunkt /organisations/{organisation}/mitigations adressieren.

Senden einer GET-Anfrage an den Endpunkt /networks/{network}/mitigations.

Beschreibung¶

Mit der List-Network-Mitigations-Anfrage fordern Sie eine Liste aller Mitigationen eines angegebenen Netzwerks an.

Voraussetzungen¶

Werte der Anfrage: Netzwerk-ID {network}

Objekte: keine

Anfrage¶

Um eine Liste aller Mitigationen eines Netzwerks anzufordern, fügen Sie die Netzwerk-ID {network} in den Pfad der Anfrage ein.

Als Ergebnis erhalten Sie ein oder mehrere Objekte MitigationVO mit den angefragten Informationen.

Das Objekt liefert die folgenden Informationen:

Attribut	Beschreibung	Werte
`id`	Die ID der Mitigation.	`string`
`organisation`	Die zugehörige Organisation.	`object`
`network`	Das Netzwerk oder, bei einer partiellen Mitigation, die spezifische IP, die mitigiert wird.	`string`
`mitigation_type`	Der Typ der Mitigation.	`ACTION_BLACKHOLE` `ACTION_MITIGATE_ONPREM` `ACTION_MITIGATE_CLOUD`
`mitigation_cause`	Die Art, wie die Mitigation ausgelöst wurde.	`MANUAL_TRIGGER` `AUTO_TRIGGER` `OPS_TRIGGER` `UNKNOWN_TRIGGER`
`start`	Das Startdatum der Mitigation im ISO-8601-Format.	`string($date-time)`
`end`	Das Enddatum der Mitigation im ISO-8601-Format.	`string($date-time)`
`created_at`	Das Erstellungsdatum im ISO-8601-Format.	`string($date-time)`
`updated_at`	Das Datum der letzten Änderung im ISO-8601-Format.	`string($date-time)`
`actual_bw`	Die tatsächliche Bandbreite der Mitigation.	`number($float)`
`actual_pps`	Die tatsächlichen Pakete pro Sekunde der Mitigation.	`number($float)`
`configured_bw`	Die konfigurierte Bandbreite der Mitigation.	`number($float)`
`configured_pps`	Die konfigurierten Pakete pro Sekunde der Mitigation.	`number($float)`
`configured_bw_percentage`	Die konfigurierte Bandbreite in Prozent.	`number`
`configured_pps_percentage`	Die konfigurierten Pakete pro Sekunde in Prozent.	`number`
`peak_bw`	Die Spitzenbandbreite der Mitigation.	`number($float)`
`peak_pps`	Die maximalen Pakete pro Sekunde der Mitigation.	`number($float)`
`total_bw`	Die Gesamtbandbreite der Mitigation.	`number($float)`
`total_pps`	Die gesamten Pakete pro Sekunde der Mitigation.	`number($float)`
`dropped_bits` (falls Bericht zu verworfenen Daten aktiviert)	Die während der Mitigation verworfenen Bits insgesamt.	`integer`
`dropped_packets` (falls Bericht zu verworfenen Daten aktiviert)	Die während der Mitigation verworfenen Pakete insgesamt.	`integer`
`has_report`	Zeigt an, ob ein Bericht für die Mitigation verfügbar ist.	`true` `false`
`start_user`	Die Nutzenden, die die Mitigation gestartet haben.	`object`
`end_user`	Die Nutzenden, die die Mitigation beendet haben. Dieser Wert ist null, solange die Mitigation läuft.	`object`

Beispiel¶

Beispiel-Antwort:

{
  "data": [
    {
      "id": "xY9pQ5wR1",
      "organisation": {
        "id": "aB3cD4eF5",
        "name": "ACME GmbH"
      },
      "network": "192.0.2.0/24",
      "mitigation_type": "ACTION_MITIGATE_ONPREM",
      "mitigation_cause": "MANUAL_TRIGGER",
      "start": "2026-01-01T00:00:00+00:00",
      "end": "2026-01-01T00:00:00+00:00",
      "created_at": "2026-01-01T00:00:00+00:00",
      "updated_at": "2026-01-01T00:00:00+00:00",
      "actual_bw": 0,
      "actual_pps": 0,
      "configured_bw": 0,
      "configured_pps": 0,
      "configured_bw_percentage": 0,
      "configured_pps_percentage": 0,
      "peak_bw": 0,
      "peak_pps": 0,
      "total_bw": 0,
      "total_pps": 0,
      "dropped_bits": 0,
      "dropped_packets": 0,
      "has_report": true,
      "start_user": {
        "id": "pQ7rS8tU9",
        "name": "Max Mustermann"
      },
      "end_user": {
        "id": "pQ7rS8tU9",
        "name": "Max Mustermann"
      }
    }
  ],
  "links": {
    "first": "https://datahub-api.com/api/networks?page=1",
    "last": "https://datahub-api.com/api/networks?page=5",
    "prev": null,
    "next": "https://datahub-api.com/api/networks?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 5,
    "links": [
      {
        "url": "https://datahub-api.com/api/networks?page=2",
        "label": "Next »",
        "active": false
      }
    ],
    "path": "https://datahub-api.com/api/networks",
    "per_page": 15,
    "to": 15,
    "total": 64
  }
}

Antworten¶

Die folgenden Antworten sind möglich:

STATUSCODE	BESCHREIBUNG
200	Die Anfrage war erfolgreich.
401	Die Anfrage war nicht erfolgreich, da die Authentifizierung fehlerhaft war.
403	Die Anfrage war nicht erfolgreich, da die erforderlichen Berechtigungen fehlen.