VPS umbenennen
Aktualisiere den Anzeigenamen eines VPS. Dies ist ein lokaler Vorgang und hat keine Auswirkung auf den Hosting-Anbieter.
Anfrage
POST /api/v1/vps/{id}/rename
Erforderlicher Scope: vps:manage
Pfadparameter
| Parameter |
Typ |
Beschreibung |
id |
string |
Die VPS-ID |
Header
| Header |
Erforderlich |
Wert |
Authorization |
Ja |
Bearer DEIN_API_SCHLÜSSEL |
Content-Type |
Ja |
application/json |
Anfragekörper
| Feld |
Typ |
Erforderlich |
Beschreibung |
name |
string |
Ja |
Neuer Anzeigename (1–32 Zeichen) |
{
"name": "Produktionsserver"
}
Antwort
{
"data": {
"name": "Produktionsserver",
"success": true
}
}
Antwortfelder
| Feld |
Typ |
Beschreibung |
name |
string |
Der neue Anzeigename |
success |
boolean |
Ob die Umbenennung erfolgreich war |
Fehler
| Status |
Code |
Beschreibung |
| 400 |
INVALID_NAME |
Der Name muss 1–32 Zeichen lang sein |
| 400 |
INVALID_BODY |
Der Anfragekörper ist kein gültiges JSON |
| 404 |
NOT_FOUND |
VPS nicht gefunden oder kein Zugriff |
Beispiel
curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/rename" \
-H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
-H "Content-Type: application/json" \
-d '{"name": "Produktionsserver"}'
MCP
Diese Aktion ist auch über das rename_vm MCP-Tool verfügbar.