Die Einstellungen einer Wartungsseite einer Subdomain ändern¶
Note
Der Body muss die Attribute id und modified enthalten, um den entsprechenden Eintrag zu identifizieren.
Note
In der Myra App wird weiterhin der Platzhalter twitter für X verwendet.
Note
Die ID des Eintrags im Pfad der Anfrage muss mit dem Wert des Attributs id im Body übereinstimmen.
Senden einer PUT-Anfrage an den Endpunkt /domain/{domainId}/{vHostName}/maintenances/{id}.
Beschreibung¶
Mit der Change-Maintenance-Page-Anfrage ändern Sie eine Wartungsseite einer Subdomain der Organisation.
Voraussetzungen¶
Werte der Anfrage: Domain-ID {domainId}, Subdomain name {vHostName}, Maintenance-Page-ID {id}
Objekte: MaintenanceVO
Anfrage¶
Um eine Wartungsseite einer Subdomain zu ändern, fügen Sie die Domain-ID {domainId}, den Subdomain name {vHostName} und die Maintenance-Page-ID {id} dem Pfad der HTTP-Anfrage hinzu.
Für eine detaillierte Spezifikation, welche Informationen zum Ändern einer Wartungsseite erforderlich sind, muss im Body das Objekt MaintenanceVO mit den folgenden Attributen definiert werden:
| Attribut | Beschreibung | Werte |
|---|---|---|
fqdn |
Der Name der Subdomain, der die Wartungsseite zugeordnet ist. | |
id |
Die ID der Wartungsseite. | integer |
modified |
Das Datum der letzten Änderung im ISO-8601-Format. | string($date-time) |
Die folgenden Attribute sind optional:
| Attribut | Beschreibung | Werte |
|---|---|---|
start |
Das Datum im ISO-8601-Format, ab dem die Wartungsseite aktiviert wird. | string($date-time) |
end |
Das Datum im ISO-8601-Format, bis zu dem die Wartungsseite aktiviert ist. | string($date-time) |
content |
Der Inhalt der Wartungsseite als HTML. Beachten Sie, dass keine Ressourcen aus der Subdomain eingebunden werden können, die Sie in den Wartungsmodus versetzt haben. Wenn Ihre Wartungsseite Bilder enthält, verwenden Sie eine andere Domain oder inline base64-codierte Bilder. | string |
active |
Die Verfügbarkeit der Wartungsseite. |
|
defaultPage |
Ein Array mit definierten Standardseiten, die anstelle einer eigenen Inhaltsseite verwendet werden sollen. | Von Myra generierte Standardseite, Link zu einer externen Seite wie Facebook oder X. Es können eine oder mehrere Standardseiten verwendet werden. |
vhostId |
Die ID der Subdomain, der die Wartungsseite zugeordnet ist. | integer |
Das System gibt das Objekt MaintenanceVO mit den geänderten Informationen zurück.
Beispiel¶
Beispiel-Request-Body:
{
"objectType": "string",
"fqdn": "string",
"start": "string",
"end": "string",
"content": "string",
"contentFrom": "string",
"active": true,
"defaultPage": "string",
"vhostId": 0,
"permissions": "string",
"comment": "string"
}
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. |