IP-Filter-Einträge für eine Subdomain aus einer CSV-Payload importieren¶

Note

Der Request-Body ist eine reine CSV-Payload, keine JSON-Payload. Zeilen, die sich nicht als gültige IP-Adresse oder als gültiger CIDR-Bereich parsen lassen, werden abgelehnt und als Validierungsfehler zurückgegeben.

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

Beschreibung¶

Mit der Import-IP-Filter-Anfrage importieren Sie IP-Filter-Einträge für eine Subdomain der Organisation als Sammelimport aus einer reinen CSV-Payload.

Voraussetzungen¶

Werte der Anfrage: Domain-ID {domainId}, Subdomain name {vHostName}, type (Query-Parameter)

Objekte: keine

Anfrage¶

Um IP-Filter-Einträge für eine Subdomain zu importieren, fügen Sie die Domain-ID {domainId} und den Subdomain name {vHostName} dem Pfad der Anfrage hinzu. Der Query-Parameter type ist erforderlich und definiert den IP-Filter-Typ, der auf jeden importierten Eintrag angewendet wird.

Attribut	Beschreibung	Werte
`type`	Der IP-Filter-Typ, der auf alle importierten Einträge angewendet wird. Erforderlicher Query-Parameter.	`ALLOWLIST` `WHITELIST` `BLACKLIST` `BLOCKLIST` `ALLOWLIST_REQUEST_LIMITER` `WHITELIST_REQUEST_LIMITER`

Der Request-Body ist kein JSON-Objekt, sondern reiner CSV-Inhalt. Jede Zeile stellt einen IP-Filter-Eintrag mit den folgenden durch Komma getrennten Spalten dar. Ein Eintrag mit demselben Wert und Typ wie ein bestehender Eintrag aktualisiert diesen Eintrag, anstatt ein Duplikat zu erstellen:

Attribut	Beschreibung	Werte
`IP`	Der Wert des IP-Filter-Eintrags im Format einer IP-Adresse oder CIDR-Notation.	`string`
`Expires on`	Das Ablaufdatum des Eintrags im ISO-8601-Format (z. B. `yyyy-mm-ddThh:mm:ss+hhmm`), leer, wenn der Eintrag nicht abläuft.	`string($date-time)`
`Comments`	Der für den Eintrag gespeicherte Kommentar.	`string`

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.
404	Die Anfrage war nicht erfolgreich, da die angeforderte Ressource nicht gefunden wurde.