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_calculated`	Der berechnete PPS-Schwellenwert.	`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`	Bei „true" wird das Netzwerk im Dashboard nur zur Überwachung angezeigt und kann nicht mitigiert werden.	`true` `false`
`subnet_mitigation_override`	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`
`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_calculated`	Der berechnete PPS-Schwellenwert.	`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`	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`
`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_calculated": 800,
  "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",
  "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.