Aktive manuelle Mitigation eines Netzwerks stoppen¶

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

Beschreibung¶

Mit der Stop-Mitigation-Anfrage stoppen Sie die aktive manuelle Mitigation für ein angegebenes Netzwerk.

Voraussetzungen¶

Werte der Anfrage: Netzwerk-ID {network}

Objekte: keine

Anfrage¶

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

Die folgenden Attribute sind optional:

Attribut	Beschreibung	Werte
`ip`	Eine Liste einzelner IPs innerhalb des Netzwerks, für die die Mitigation gestoppt werden soll. Fehlt die Angabe, wird die Mitigation für den gesamten Netzwerk-CIDR gestoppt.	`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`	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; null, solange die Mitigation läuft.	`object`

Beispiel¶

Beispiel-Request-Body:

{
  "ip": [
    "string"
  ]
}

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.