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. |
|
type |
Der Typ des IP-Filter-Eintrags. |
|
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. |
|
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. |