Zum Inhalt springen

Dokumentation

ResellerAPI

Rootserver Starten/Stoppen

POST/vm/{internalId}/power/change

Änderen den Power-Status deines Rootservers.

Parameter

Pfad

  • internalIdstringPflicht

    Die **VM-ID**, nicht die Kundenprodukt-ID. Eine falsche Kennung erzeugt hier nicht immer „VM not found" — bei den Power-Endpunkten kommt stattdessen „Failed to change power state".

    Beispiel
    pvm4Kx2QmVb9NrT6sLdHe

Anfragekörper

Pflicht

application/json

object

  • modestringPflicht
    Erlaubte Werte
    STARTSHUTDOWNSTOPREBOOTRESETRESUMESUSPEND

Antworten

200Erfolg; `data` ist `null`.

application/json

object

  • statusstringPflicht
  • requestIdstringPflicht
  • messagestringPflicht
  • dataobject
400Fachliche Ablehnung. Verzweigen Sie auf `data.code`, wenn vorhanden; ein `400` ohne `code` bedeutet „nicht wiederholen, Eingabe prüfen".

application/json

object

  • statusstringPflicht
  • requestIdstringPflicht
  • messagestringPflicht
  • dataobject
401Schlüssel fehlt, ist unbekannt, widerrufen oder abgelaufen — **oder** der Pfad gehört nicht zum Reseller-Umfang. Diese Antwort entsteht im Sicherheitsfilter und trägt **kein** `data` und **kein** `requestId`. Kommt die Ablehnung dagegen aus einem Handler, ist der volle Umschlag mit `data.requested-function` gefüllt.

application/json

object

Zuletzt aktualisiert:

Feedback zu dieser Seite