Zum Inhalt
Myra Online-Hilfe Stand · 21.08.2026

Die Einstellungen eines IP-Filter-Eintrags ändern

Note

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

Note

Stellen Sie sicher, dass die ID des DNS-Eintrags im Pfad der Anfrage mit dem Wert des Attributs id im Body übereinstimmt.

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

Beschreibung

Mit der Change-IP-Filter-Anfrage ändern Sie die Einstellungen eines IP-Filter-Eintrags einer Subdomain der Organisation.

Voraussetzungen

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

Objekte: IpFilterVO

Anfrage

Um einen IP-Filter-Eintrag einer Domain zu ändern, fügen Sie die Domain-ID {domainId}, den Subdomain name {name} und die IP-Filter-ID {id} dem Pfad der Anfrage hinzu.

Für eine detaillierte Spezifikation, welche Informationen zum Ändern eines IP-Filter-Eintrags erforderlich sind, muss im Body das Objekt 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
id Die ID des Eintrags. integer
modified Das Datum der letzten Änderung im ISO-8601-Format. string($date-time)

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 das Objekt IpFilterVO mit den geänderten Informationen 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
200 Die Anfrage war erfolgreich.
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.