Mitigation anhand der ID abrufen¶

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 Dropped-Data-Report 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. Sie benötigen für den ausgewählten Zeitraum mindestens READ-Berechtigungen.

Note

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

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

Beschreibung¶

Mit der Get-Mitigation-Anfrage fordern Sie eine einzelne Mitigation für eine angegebene ID an.

Voraussetzungen¶

Werte der Anfrage: Mitigation-ID {mitigation}

Objekte: keine

Anfrage¶

Um eine Mitigation anzufordern, fügen Sie die Mitigation-ID {mitigation} in den Pfad der Anfrage ein.

Als Ergebnis erhalten Sie ein Objekt 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 der Mitigation.	`object`
`network`	Das Netzwerk oder bei einer partiellen Mitigation die spezifische IP-Adresse, die mitigiert wird.	`string`
`mitigation_type`	Der angewendete Mitigationstyp.	`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`	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 als Prozentwert.	`number`
`configured_pps_percentage`	Die konfigurierten Pakete pro Sekunde als Prozentwert.	`number`
`peak_bw`	Die Spitzenbandbreite der Mitigation.	`number($float)`
`peak_pps`	Der Spitzenwert der Pakete pro Sekunde der Mitigation.	`number($float)`
`total_bw`	Die Gesamtbandbreite der Mitigation.	`number($float)`
`total_pps`	Die Gesamtzahl der Pakete pro Sekunde der Mitigation.	`number($float)`
`dropped_bits` (falls Dropped-Data-Report aktiviert)	Die Gesamtzahl der während der Mitigation verworfenen Bits.	`integer`
`dropped_packets` (falls Dropped-Data-Report aktiviert)	Die Gesamtzahl der während der Mitigation verworfenen Pakete.	`integer`
`has_report`	Zeigt an, ob für die Mitigation ein Report verfügbar ist.	`true` `false`
`start_user`	Der Nutzende, der die Mitigation gestartet hat.	`object`
`end_user`	Der Nutzende, der die Mitigation beendet hat; null, solange die Mitigation läuft.	`object`
`peaks`	Die Aufschlüsselung des Spitzenverkehrs der Mitigation.	`object`

Beispiel¶

Beispiel-Antwort:

{
  "id": "string",
  "organisation": {},
  "network": "string",
  "mitigation_type": "ACTION_BLACKHOLE",
  "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": {},
  "end_user": {},
  "peaks": {}
}

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.