Projekte und API-Token
Wie Ressourcen gruppiert werden, wer darauf zugreifen kann und wie sich Tools authentifizieren.
Organisationen und Projekte
Bei der Registrierung erhalten Sie eine persönliche Organisation. Der Organisation gehören das Prepaid-Guthaben,
die Limits, Zahlungen und monatlichen Abrechnungen. Mitglieder einer Organisation haben eine
dieser Rollen: owner, admin, billing oder member.
Ressourcen (Server, Volumes, Netzwerke, …) befinden sich in Projekten innerhalb der Organisation. Ein Projekt ist
ein Arbeitsbereich: Es gruppiert Ressourcen, gibt Personen Zugriff darauf und enthält die API-Token, mit denen sie
automatisiert werden. Verwenden Sie getrennte Projekte, um Umgebungen voneinander zu trennen, z. B. production und
staging. Ihre effektive Rolle in einem Projekt ist admin, member oder readonly.
Ein Projekt lässt sich nur löschen, wenn es keine Ressourcen mehr enthält.
API-Token
Tools wie die odx CLI, der Terraform-Provider und Ihre eigenen Skripte
authentifizieren sich mit einem Projekt-API-Token:
- Ein Token gehört zu genau einem Projekt und sieht nur dessen Ressourcen.
- Sein Scope ist
read(es kann auflisten und lesen, jede Änderung wird mit403 forbiddenabgelehnt) oderread_write. - Es kann ein Ablaufdatum haben. Die Console zeigt an, wann jedes Token zuletzt verwendet wurde.
- Das Secret beginnt mit
odx_und wird nur einmal beim Erstellen angezeigt. Bewahren Sie es in einem Passwortmanager oder Secret Store auf. Widerrufen Sie Token, die Sie nicht mehr benötigen; der Widerruf wirkt sofort.
Token erstellen Sie in der Console: Projects → Ihr Projekt → API tokens → Create API token. Token lassen sich nur in einer Console-Sitzung erstellen und widerrufen, nicht mit einem anderen Token.
Senden Sie das Token als Bearer-Token:
curl -H "Authorization: Bearer $ODX_TOKEN" https://api.odinex.cloud/v1/serversWer ein read_write-Token besitzt, kann in diesem Projekt Ressourcen erstellen und löschen – und damit Kosten
verursachen. Committen Sie Token nie in die Versionsverwaltung und fügen Sie sie nie in Tickets ein.
Alle Token eines Projekts teilen sich ein gemeinsames Ratenlimit.
Die Console-Sitzung
Die Console nutzt dieselbe API, allerdings mit einem Session-Cookie statt eines Tokens. Endpunkte für Konto, Projekte, Abrechnung und Support (in der API-Referenz als Console session gekennzeichnet) funktionieren nur mit einer Sitzung.