Einstellungen eines Netzwerks ändern¶

Note

Der Body muss die Attribute id und modified enthalten, um den entsprechenden Eintrag zu identifizieren.

Note

Die ID des Eintrags im Pfad der Anfrage muss mit dem Wert des Attributs id im Body übereinstimmen.

Note

Die Attribute pps_limit und pps_limit_percentage schließen sich gegenseitig aus; Gleiches gilt für bw_limit und bw_limit_percentage.

Note

Der Status enabled und das Attribut subnet_mitigation_override lassen sich nicht ändern, solange für das Netzwerk eine aktive Mitigation läuft.

Note

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

Senden einer PATCH-Anfrage an den Endpunkt /networks/{network}.

Beschreibung¶

Mit der Change-Network-Anfrage ändern Sie die Einstellungen eines Netzwerks der Organisation.

Voraussetzungen¶

Werte der Anfrage: Netzwerk-ID {network}

Objekte: NetworkVO

Anfrage¶

Um die Einstellungen eines Netzwerks zu ändern, fügen Sie die Netzwerk-ID {network} in den Pfad der Anfrage ein.

Für eine detaillierte Spezifikation, welche Informationen zum Ändern der Einstellungen eines Netzwerks erforderlich sind, muss im Body ein Objekt NetworkVO mit den folgenden Attributen definiert werden:

Attribut	Beschreibung	Werte
`id`	Die ID des Netzwerks.	`string`
`modified`	Das Datum der letzten Änderung im ISO-8601-Format.	`string($date-time)`
`cidr`	Der CIDR-Bereich des Netzwerks.	`string`
`enabled`	Definiert, ob die automatische Mitigation für das Netzwerk aktiviert ist. Bei false können keine automatischen Mitigationen ausgelöst werden; manuelle Mitigationen und Ops-Mitigationen sind davon nicht betroffen.	`true` `false`
`pps_limit`	Der PPS-Schwellenwert.	`integer`
`bw_limit`	Der Bandbreiten-Schwellenwert in Mbps.	`integer`

Die folgenden Attribute sind optional:

Attribut	Beschreibung	Werte
`name`	Der Name des Netzwerks.	`string`
`pps_limit_percentage` (falls prozentuale Schwellenwerte aktiviert)	Der PPS-Grenzwert in Prozent.	`integer`
`pps_limit_calculated`	Der berechnete PPS-Schwellenwert.	`integer`
`bw_limit_percentage` (falls prozentuale Schwellenwerte aktiviert)	Der Bandbreiten-Grenzwert in Prozent.	`integer`
`bw_limit_calculated`	Der berechnete Bandbreiten-Schwellenwert.	`integer`
`team_id`	Die ID der Organisation, zu der dieses Netzwerk gehört.	`string`
`autoStatus`	Definiert, ob für das Netzwerk aktuell eine automatische Mitigation läuft.	`true` `false`
`manualStatus`	Definiert, ob für das Netzwerk aktuell eine manuelle Mitigation läuft.	`true` `false`
`active_partial_mitigations`	Die aktiven partiellen manuellen Mitigationen.	`array`
`active_partial_auto_mitigations`	Die aktiven partiellen automatischen Mitigationen.	`array`
`country_blocks`	Die aktiven Länderblockierungen.	`array`
`data_only` (falls verfügbar)	Bei true wird das Netzwerk im Dashboard nur zur Überwachung angezeigt und kann nicht mitigiert werden.	`true` `false`
`subnet_mitigation_override` (falls Subnetz-Override aktiviert)	Definiert, ob die Subnetzgrößen-Beschränkung für Cloud- oder Hybrid-Mitigation überschrieben wird.	`true` `false`
`extra`	Zusätzliche Informationen zum Netzwerk.	`object`
`mitigation_type`	Der konfigurierte Mitigationstyp.	`string`
`network_type` (falls Netzwerktypen aktiviert)	Der Typ des Netzwerks.	`string`
`customer_reference` (falls Kundenreferenzen aktiviert)	Die Kundenreferenz-Kennung.	`string`
`emails`	Die E-Mail-Adressen für Benachrichtigungen.	`array`
`duration`	Die Standard-Mitigationsdauer in Sekunden.	`integer`
`auto_mitigation_strategy`	Die für automatische Mitigationen verwendete Strategie.	`string`

Als Ergebnis erhalten Sie ein Objekt NetworkVO mit den angefragten Informationen.

Das Objekt liefert die folgenden Informationen:

Attribut	Beschreibung	Werte
`id`	Die ID des Netzwerks.	`string`
`name`	Der Name des Netzwerks.	`string`
`cidr`	Der CIDR-Bereich des Netzwerks.	`string`
`enabled`	Definiert, ob die automatische Mitigation für das Netzwerk aktiviert ist. Bei false können keine automatischen Mitigationen ausgelöst werden; manuelle Mitigationen und Ops-Mitigationen sind davon nicht betroffen.	`true` `false`
`pps_limit`	Der PPS-Schwellenwert.	`integer`
`bw_limit`	Der Bandbreiten-Schwellenwert in Mbps.	`integer`
`pps_limit_percentage` (falls prozentuale Schwellenwerte aktiviert)	Der PPS-Grenzwert in Prozent.	`integer`
`pps_limit_calculated`	Der berechnete PPS-Schwellenwert.	`integer`
`bw_limit_percentage` (falls prozentuale Schwellenwerte aktiviert)	Der Bandbreiten-Grenzwert in Prozent.	`integer`
`bw_limit_calculated`	Der berechnete Bandbreiten-Schwellenwert.	`integer`
`team_id`	Die ID der Organisation, zu der dieses Netzwerk gehört.	`string`
`autoStatus`	Definiert, ob für das Netzwerk aktuell eine automatische Mitigation läuft.	`true` `false`
`manualStatus`	Definiert, ob für das Netzwerk aktuell eine manuelle Mitigation läuft.	`true` `false`
`active_partial_mitigations`	Die aktiven partiellen manuellen Mitigationen.	`array`
`active_partial_auto_mitigations`	Die aktiven partiellen automatischen Mitigationen.	`array`
`country_blocks`	Die aktiven Länderblockierungen.	`array`
`data_only` (falls verfügbar)	Bei true wird das Netzwerk im Dashboard nur zur Überwachung angezeigt und kann nicht mitigiert werden.	`true` `false`
`extra`	Zusätzliche Informationen zum Netzwerk.	`object`
`mitigation_type`	Der konfigurierte Mitigationstyp.	`string`
`network_type` (falls Netzwerktypen aktiviert)	Der Typ des Netzwerks.	`string`
`customer_reference` (falls Kundenreferenzen aktiviert)	Die Kundenreferenz-Kennung.	`string`
`emails`	Die E-Mail-Adressen für Benachrichtigungen.	`array`
`duration`	Die Standard-Mitigationsdauer in Sekunden.	`integer`
`auto_mitigation_strategy`	Die für automatische Mitigationen verwendete Strategie.	`string`

Beispiel¶

Beispiel-Request-Body:

{
  "name": "Production Network",
  "cidr": "127.0.0.1/32",
  "enabled": true,
  "pps_limit": 1000,
  "bw_limit": 200,
  "pps_limit_percentage": 80,
  "pps_limit_calculated": 800,
  "bw_limit_percentage": 80,
  "bw_limit_calculated": 160,
  "team_id": "xY9pQ5wR1",
  "autoStatus": false,
  "manualStatus": false,
  "active_partial_mitigations": [
    {}
  ],
  "active_partial_auto_mitigations": [
    {}
  ],
  "country_blocks": [
    {}
  ],
  "data_only": false,
  "allow_manual_mitigation": true,
  "extra": {},
  "mitigation_type": "string",
  "network_type": "string",
  "customer_reference": "abc",
  "emails": [
    "string"
  ],
  "duration": 3600,
  "auto_mitigation_strategy": "ip"
}

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.
422	Die Anfrage war nicht erfolgreich, da die übermittelten Daten nicht verarbeitet werden konnten.