Manuelle Mitigation für ein Netzwerk starten¶

Note

Wenn für das Netzwerk bereits eine manuelle Mitigation aktiv ist, kann keine zweite gestartet werden. Die bestehende Mitigation muss zuerst gestoppt werden. Data-only-Netzwerke können nicht mitigiert werden.

Note

Eine partielle Mitigation kann bei einem Single-Host-Netzwerk (einem IPv4 /32 oder IPv6 /128) nicht gestartet werden, da es nur eine einzelne Adresse umfasst. Lassen Sie ip weg, um stattdessen das gesamte Netzwerk zu mitigieren.

Senden einer POST-Anfrage an den Endpunkt /networks/{network}/mitigation/start.

Beschreibung¶

Mit der Start-Manual-Mitigation-Anfrage starten Sie eine manuelle Mitigation für ein angegebenes Netzwerk.

Voraussetzungen¶

Werte der Anfrage: Netzwerk-ID {network}

Objekte: keine

Anfrage¶

Um eine manuelle Mitigation zu starten, fügen Sie die Netzwerk-ID {network} in den Pfad der Anfrage ein.

Der Body erfordert keine Attribute. Die folgenden Attribute sind optional:

Attribut	Beschreibung	Werte
`ip`	Eine Liste einzelner IPs innerhalb des Netzwerks für eine partielle Mitigation. Fehlt die Angabe, wird die gesamte Netzwerk-CIDR mitigiert. Es werden sowohl IPv4 als auch IPv6 akzeptiert.	`array`

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`	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.	`number($float)`
`actual_pps`	Die tatsächlichen Pakete pro Sekunde.	`number($float)`
`configured_bw`	Die konfigurierte Bandbreite.	`number($float)`
`configured_pps`	Die konfigurierten Pakete pro Sekunde.	`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.	`number($float)`
`peak_pps`	Die maximalen Pakete pro Sekunde.	`number($float)`
`total_bw`	Die Gesamtbandbreite.	`number($float)`
`total_pps`	Die gesamten Pakete pro Sekunde.	`number($float)`
`has_report`	Zeigt an, ob für die Mitigation ein Bericht verfügbar ist.	`true` `false`
`start_user`	Die Person, die die Mitigation gestartet hat.	`object`
`end_user`	Die Person, die die Mitigation beendet hat. Dieser Wert ist null, solange die Mitigation läuft.	`object`

Beispiel¶

Beispiel-Request-Body:

{
  "ip": [
    "192.0.2.1"
  ]
}

Antworten¶

Die folgenden Antworten sind möglich:

STATUSCODE	BESCHREIBUNG
200	Die Anfrage war erfolgreich.
304	Die Ressource wurde seit der letzten Anfrage nicht verändert.
401	Die Anfrage war nicht erfolgreich, da die Authentifizierung fehlerhaft war.
403	Die Anfrage war nicht erfolgreich, da die erforderlichen Berechtigungen fehlen.
422	Die Anfrage war nicht erfolgreich, da die übermittelten Daten nicht verarbeitet werden konnten.