Mitigationsstatistiken für einen Monat auflisten¶

Note

Diese Anfrage steht ausschließlich Super-Admin-Nutzenden zur Verfügung.

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

Beschreibung¶

Mit der Get-Mitigation-Statistics-Anfrage fordern Sie die Mitigationsstatistiken für einen angegebenen Monat der Organisation an.

Voraussetzungen¶

Werte der Anfrage: Monat {group}

Objekte: keine

Anfrage¶

Um die Mitigationsstatistiken anzufordern, fügen Sie den Monat {group} (im Format YYYY-MM) dem Pfad der Anfrage hinzu.

Als Ergebnis erhalten Sie ein oder mehrere Objekte MitigationStatisticVO mit den angefragten Informationen.

Das Objekt liefert die folgenden Informationen:

Attribut	Beschreibung	Werte
`org`	Der Name der Organisation.	`string`
`network`	Die IP-Adresse oder das CIDR des mitigierten Netzwerks.	`string`
`start`	Datum und Uhrzeit des Beginns der Mitigation im ISO-8601-Format.	`string($date-time)`
`end`	Datum und Uhrzeit des Endes der Mitigation im ISO-8601-Format.	`string($date-time)`
`trigger_type`	Der Auslösetyp der Mitigation.	`MANUAL_TRIGGER` `AUTOMATIC_TRIGGER` `OPERATIONS_TRIGGER` `UNKNOWN_TRIGGER`
`actual_bw`	Die gemessene Bandbreite in Mbps zu Beginn der Mitigation.	`integer`
`configured_bw`	Der konfigurierte Bandbreitenschwellenwert in Mbps.	`integer`
`actual_pps`	Die gemessenen Pakete pro Sekunde zu Beginn der Mitigation.	`integer`
`configured_pps`	Der konfigurierte Paketratenschwellenwert.	`integer`
`peak_bw`	Die während der Mitigation beobachtete Spitzenbandbreite in Mbps.	`integer`
`peak_pps`	Die während der Mitigation beobachtete Spitzen-Paketrate.	`integer`
`total_bw`	Die während der Mitigation empfangene Gesamtbandbreite in Bits.	`integer`
`total_pps`	Die während der Mitigation empfangenen Pakete insgesamt.	`integer`
`dropped_bits`	Die von der Mitigation verworfenen Bits insgesamt.	`integer`
`dropped_packets`	Die von der Mitigation verworfenen Pakete insgesamt.	`integer`

Beispiel¶

Beispiel-Antwort:

{
  "data": [
    {
      "org": "Test Organisation",
      "network": "172.0.0.1",
      "start": "2026-01-01T00:00:00+00:00",
      "end": "2026-01-01T00:00:00+00:00",
      "trigger_type": "MANUAL_TRIGGER",
      "actual_bw": 100,
      "configured_bw": 200,
      "actual_pps": 1500,
      "configured_pps": 2000,
      "peak_bw": 400,
      "peak_pps": 3000,
      "total_bw": 123456,
      "total_pps": 78910,
      "dropped_bits": 10000,
      "dropped_packets": 2000
    }
  ],
  "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.