Alle Mitigationen der Organisation auflisten

Note

Die Schwellenwert- und Traffic-Kennzahlen — configured_bw, configured_pps, configured_bw_percentage, configured_pps_percentage, actual_bw, actual_pps, peak_bw, peak_pps, total_bw, total_pps sowie 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 /mitigations.

Beschreibung

Mit der List-Mitigations-Anfrage fordern Sie eine Liste aller Mitigationen der Organisation an.

Voraussetzungen

Werte der Anfrage: keine

Objekte: keine

Anfrage

Um eine Liste aller Mitigationen anzufordern, fügen Sie dem Pfad der Anfrage keine zusätzlichen Informationen hinzu.

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 mitigierte Netzwerk oder bei einer Teil-Mitigation eine einzelne IP-Adresse.	`string`
`mitigation_type`	Der Typ der angewendeten Mitigation.	`ACTION_BLACKHOLE` `ACTION_MITIGATE_ONPREM` `ACTION_MITIGATE_CLOUD`
`mitigation_cause`	Wie die Mitigation ausgelöst wurde.	`MANUAL_TRIGGER` `AUTO_TRIGGER` `OPS_TRIGGER` `UNKNOWN_TRIGGER`
`start`	Wann die Mitigation begonnen hat.	`string($date-time)`
`end`	Wann die Mitigation beendet wurde; null, solange sie noch läuft.	`string($date-time)`
`created_at`	Das Erstellungsdatum des Eintrags im ISO-8601-Format.	`string($date-time)`
`updated_at`	Das Datum der letzten Aktualisierung des Eintrags im ISO-8601-Format.	`string($date-time)`
`actual_bw`	Die gemessene Bandbreite zu Beginn der Mitigation.	`number($float)`
`actual_pps`	Die gemessene Paketrate zu Beginn der Mitigation.	`number($float)`
`configured_bw`	Der zu Beginn der Mitigation konfigurierte Bandbreitenschwellenwert.	`number($float)`
`configured_pps`	Der zu Beginn der Mitigation konfigurierte Paketratenschwellenwert.	`number($float)`
`configured_bw_percentage`	Der Bandbreitenschwellenwert als Prozentsatz der berechneten Baseline.	`number`
`configured_pps_percentage`	Der Paketratenschwellenwert als Prozentsatz der berechneten Baseline.	`number`
`peak_bw`	Die während der Mitigation beobachtete Spitzenbandbreite.	`number($float)`
`peak_pps`	Die während der Mitigation beobachtete Spitzenpaketrate.	`number($float)`
`total_bw`	Die während der Mitigation verarbeiteten Bits insgesamt.	`number($float)`
`total_pps`	Die während der Mitigation verarbeiteten Pakete insgesamt.	`number($float)`
`dropped_bits`	Die während der Mitigation verworfenen Bits insgesamt.	`integer`
`dropped_packets`	Die während der Mitigation verworfenen Pakete insgesamt.	`integer`
`has_report`	Definiert, ob ein detaillierter Mitigationsbericht verfügbar ist.	`true` `false`
`start_user`	Wer die Mitigation gestartet hat.	`object`
`end_user`	Wer die Mitigation beendet hat; null, solange sie noch 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.