API-Token, REST-API & CLI – RST Cloud Docs

Alle Dienste lassen sich auch ohne das Portal steuern – über die REST-API unter https://api.rstcloud.de oder das CLI-Tool rstcloud. Jeder Zugriff erfolgt mit einem persönlichen Token und gilt nur für Ihre eigenen Dienste.

1. API-Token erstellen

Im Manage-Portal unter API einen Token mit Bezeichnung anlegen. Der Token wird einmalig angezeigt – sicher aufbewahren. Token lassen sich dort jederzeit widerrufen.

2. CLI installieren

Laden Sie das passende Binary herunter:

Linux (x64): rstcloud-linux-x64
macOS (Apple Silicon): rstcloud-macos-arm64
Windows (x64): rstcloud-windows-x64.exe

Unter Linux/macOS ausführbar machen und in den PATH legen:

chmod +x rstcloud-macos-arm64
sudo mv rstcloud-macos-arm64 /usr/local/bin/rstcloud

Unter macOS ggf. einmalig in den Systemeinstellungen → Datenschutz freigeben.

3. Anmelden & nutzen

rstcloud login <TOKEN>
rstcloud locations
rstcloud products vserver
rstcloud vserver create --product <key> --location <id> --os <id> \
    --name web1 --cores 2 --ram 2048 --disk 40
rstcloud vserver list
rstcloud vserver action <id> reboot
rstcloud app list
rstcloud db create --product <key> --location <id> --engine MariaDb --version 11 \
    --name meinedb --cores 1 --ram 1024 --disk 20

rstcloud help zeigt alle Befehle.

4. Direkt per HTTP

Jeder Endpunkt erwartet den Header Authorization: Bearer <TOKEN>:

curl -H "Authorization: Bearer $TOKEN" https://api.rstcloud.de/api/v1/vservers

Verfügbare Ressourcen: locations, os-images, products, vservers, apps, databases, storage, domains, firewalls. Anlegen/Löschen/Aktionen sind kostenpflichtig wie im Portal und erscheinen im Änderungsprotokoll.