Einen IP-Filter-Eintrag hinzufügen¶

Note

Wenn die optionalen Attribute nicht gesetzt sind, setzt das System einen Standardwert ein.

Note

Der Body enthält die Attribute id, created und modified nicht. Die Werte dieser Attribute werden vom System nach dem Erstellen der Einträge gesetzt.

Senden einer POST-Anfrage an den Endpunkt /domain/{domainId}/ip-filters/{name}.

Beschreibung¶

Mit der Add-IP-Filter-Anfrage fügen Sie einen IP-Filter-Eintrag für die IP-Filter einer Subdomain der Organisation hinzu.

Voraussetzungen¶

Werte der Anfrage: Domain-ID {domainId}, Subdomain name {name}

Objekte: IpFilterVO

Anfrage¶

Um einen oder mehrere IP-Filter-Einträge für eine Subdomain hinzuzufügen, fügen Sie die Domain-ID {domainId} und den Subdomain name {name} dem Pfad der Anfrage hinzu.

Für eine detaillierte Spezifikation, welche Informationen zum Hinzufügen eines IP-Filter-Eintrags erforderlich sind, müssen im Body ein oder mehrere Objekte IpFilterVO mit den folgenden Attributen definiert werden:

Attribut	Beschreibung	Werte
`value`	Die Werte im Format einer IP-Adresse oder CIDR-Notation für den IP-Filter.	Einzelne IP-Adresse CIDR-Notation IP-Adressbereich
`type`	Der Typ des IP-Filter-Eintrags.	`WHITELIST` `BLACKLIST` `WHITELIST_REQUEST_LIMITER`

Die folgenden Attribute sind optional:

Attribut	Beschreibung	Werte
`SubdomainName`	Der Name der Subdomain, für die der IP-Filter-Eintrag verwendet wird.	`string`
`enabled`	Die Verfügbarkeit des Eintrags.	`true` `false`

Das System gibt als Antwort das Objekt IpFilterVO mit den Informationen zum neuen Eintrag zurück.

Beispiel¶

Beispiel-Request-Body:

{
  "objectType": "string",
  "value": "string",
  "type": "string",
  "expireDate": "string",
  "subDomainName": "string",
  "comment": "string",
  "enabled": true
}

Antworten¶

Die folgenden Antworten sind möglich:

STATUSCODE	BESCHREIBUNG
201	Die Anfrage war erfolgreich und ein neues Objekt wurde erstellt.
400	Die Anfrage war nicht erfolgreich. Die Anfrage war fehlerhaft oder es fehlen Informationen.
401	Die Anfrage war nicht erfolgreich, da die Authentifizierung fehlerhaft war.
403	Die Anfrage war nicht erfolgreich, da die erforderlichen Berechtigungen fehlen.