API-Dokumentation

VPS upgraden

Upgrade VPS-Ressourcen wie CPU-Kerne, RAM, Festplatte, Backup-Slots und Netzwerkgeschwindigkeit. Nur Upgrades sind erlaubt — alle Werte müssen größer oder gleich der aktuellen Konfiguration sein.

Das Upgrade wird sofort über eine anteilige Einmalzahlung abgerechnet, basierend auf den verbleibenden Tagen im aktuellen Abrechnungszeitraum. Deine gespeicherte Zahlungsmethode (Mandat) wird automatisch belastet. Infrastrukturänderungen werden asynchron nach der Zahlungsbestätigung angewendet, was in der Regel einige Sekunden dauert.

Dein wiederkehrender Abonnementbetrag wird nach dem Upgrade auf den neuen monatlichen Preis aktualisiert.

Anfrage

POST /api/v1/vps/:id/upgrade

Erforderlicher Scope: vps:provision

Pfad-Parameter

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

Alle Felder sind optional. Gib nur die Werte an, die du ändern möchtest. Nicht angegebene Felder behalten ihre aktuellen Werte.

Parameter Erforderlich Beschreibung
cores Nein Neue Anzahl CPU-Kerne (muss >= aktuell sein)
mem Nein Neuer RAM in GB (muss >= aktuell sein)
disk Nein Neuer NVMe-Speicher in GB (muss >= aktuell sein)
storage Nein Neuer HDD-Speicher in GB (muss >= aktuell sein)
backupSlots Nein Neue Anzahl Backup-Slots (muss >= aktuell sein)
networkSpeed Nein Neue Netzwerkgeschwindigkeit in Mbit/s (muss >= aktuell sein)

Antwort

{
  "data": {
    "id": "507f1f77bcf86cd799439011",
    "name": "Produktions-Server",
    "orderId": "609c1f77bcf86cd799439022",
    "paymentId": "tr_AbCdEf1234",
    "status": "payment_pending",
    "immediateCost": 4.52,
    "newMonthlyAmount": 29.99,
    "requested": {
      "cores": 8,
      "mem": 16,
      "disk": 160,
      "storage": 500,
      "backupSlots": 4,
      "networkSpeed": 2000
    }
  }
}

Antwortfelder

Feld Typ Beschreibung
id string Die VPS-ID
name string Der VPS-Anzeigename
orderId string Die Upgrade-Bestell-ID zur Nachverfolgung
paymentId string Die Mollie-Zahlungs-ID
status string "payment_pending" (Mandatsbelastung eingeleitet) oder "completed"
immediateCost number Anteilige Einmalbelastung in EUR für den verbleibenden Abrechnungszeitraum
newMonthlyAmount number Aktualisierter monatlicher Abonnementpreis in EUR nach dem Upgrade
requested object Die angeforderte neue Ressourcenkonfiguration
requested.cores number Angeforderte Anzahl CPU-Kerne
requested.mem number Angeforderter RAM in GB
requested.disk number Angeforderter NVMe-Speicher in GB
requested.storage number Angeforderter HDD-Speicher in GB
requested.backupSlots number Angeforderte Anzahl Backup-Slots
requested.networkSpeed number Angeforderte Netzwerkgeschwindigkeit in Mbit/s

Abrechnung

Die Upgrade-Kosten werden wie folgt berechnet:

  1. Die monatliche Preisdifferenz zwischen der aktuellen und neuen Konfiguration wird ermittelt
  2. Die verbleibenden Tage im aktuellen Abrechnungszeitraum werden gezählt
  3. Eine anteilige Einmalbelastung wird berechnet: (neuerMonatspreis - aktuellerMonatspreis) / Gesamttage * verbleibendeTage
  4. Deine gespeicherte Zahlungsmethode wird mit dem anteiligen Betrag belastet
  5. Nach erfolgreicher Zahlung wird das wiederkehrende Abonnement auf den neuen Monatspreis aktualisiert

Infrastrukturänderungen (CPU, RAM, Festplatte usw.) werden automatisch nach Zahlungsbestätigung angewendet.

Fehlerantworten

Status Code Beschreibung
400 DOWNGRADE_NOT_ALLOWED Ein oder mehrere Werte sind kleiner als die aktuelle Konfiguration
400 NO_CHANGES Keine Änderungen erkannt
400 NO_MANDATE Keine gültige Zahlungsmethode hinterlegt
400 NO_SUBSCRIPTION Kein aktives Abonnement für dieses VPS gefunden
400 NO_BILLING_DIFFERENCE Keine Preisdifferenz für dieses Upgrade
403 INSUFFICIENT_SCOPE API-Schlüssel hat nicht den erforderlichen vps:provision-Scope
404 NOT_FOUND VPS nicht gefunden oder kein Eigentümerzugriff
409 DUPLICATE_UPGRADE Eine Upgrade-Bestellung ist bereits ausstehend für dieses VPS
500 PAYMENT_NOT_CONFIGURED Zahlungsdienst nicht konfiguriert
502 PAYMENT_FAILED Zahlung konnte nicht erstellt werden
502 SUBSCRIPTION_FETCH_FAILED Abonnementdetails konnten nicht abgerufen werden

Beispiel

# CPU und RAM upgraden
curl -X POST https://hosting.site.quest/api/v1/vps/507f1f77bcf86cd799439011/upgrade \
  -H "Authorization: Bearer sq_live_a94ecfca096d..." \
  -H "Content-Type: application/json" \
  -d '{"cores": 8, "mem": 16}'

# Festplatte und Netzwerkgeschwindigkeit upgraden
curl -X POST https://hosting.site.quest/api/v1/vps/507f1f77bcf86cd799439011/upgrade \
  -H "Authorization: Bearer sq_live_a94ecfca096d..." \
  -H "Content-Type: application/json" \
  -d '{"disk": 320, "networkSpeed": 2000}'

MCP

Diese Aktion ist auch über das upgrade_vm MCP-Tool verfügbar. Bei der Verwendung von MCP folgt das Upgrade dem gleichen Abrechnungsablauf — deine gespeicherte Zahlungsmethode wird mit dem anteiligen Betrag belastet und Infrastrukturänderungen werden nach Zahlungsbestätigung angewendet.