Alle Mitigationen einer 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 (falls die Funktion für den Bericht verworfener 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.

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

Beschreibung

Mit der List-Organisation-Mitigations-Anfrage fordern Sie eine Liste aller Mitigationen für eine angegebene Organisation an.

Voraussetzungen

Werte der Anfrage: Organisation-ID {organisation}

Objekte: keine

Anfrage

Um eine Liste aller Mitigationen anzufordern, fügen Sie die Organisation-ID {organisation} dem Pfad der Anfrage 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, angegeben als Objekt.	`object`
`network`	Das mitigierte Netzwerk oder bei einer Teil-Mitigation die spezifische 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`	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 Prozentsatz.	`number`
`configured_pps_percentage`	Die konfigurierten Pakete pro Sekunde als Prozentsatz.	`number`
`peak_bw`	Die Spitzenbandbreite der Mitigation.	`number($float)`
`peak_pps`	Die Spitzen-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)`
`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, angegeben als Objekt mit ID und Anzeigename.	`object`
`end_user`	Die Nutzenden, die die Mitigation beendet haben, angegeben als Objekt mit ID und Anzeigename. Der Wert ist null, solange die Mitigation 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,
      "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.