Zum Inhalt springenZum Inhalt springen
Entronyx Cloud
Mein Konto
Sprache Deutsch, Preise in Euro — Angaben einblenden
Sprache
Deutsch
Währung
Euro (EUR)
Preise
netto, zzgl. 19 % MwSt.

Abrechnung in Euro aus Deutschland. Weitere Sprachen und Währungen sind derzeit nicht verfügbar.

Entronyx Cloud

Dokumentation

Erst der eine Aufruf, dann alles Weitere

Der nächste Abschnitt zeigt eine einzige Abfrage an ENTRONYX CLOUD und die Antwort darauf, Feld für Feld erklärt. Lesen genügt — ein Konto brauchen Sie erst zum Ausprobieren. Danach folgen Kommandozeile, Terraform und das Modell dahinter.

Zum ersten AufrufIndex durchsuchen

Die Suche im Index läuft vollständig in Ihrem Browser: Es verlässt keine Eingabe diese Seite und es wird keine Anfrage an einen Suchdienst gestellt.

Eckdaten der Schnittstelle

Artikel im Index
50
in zehn Bereichen
API-Version
v2
OpenAPI 3.1 als Beschreibung
Abkündigungsfrist
12 Monate
Weiterbetrieb bis zum Ende
Ratenbegrenzung
3.000/min
je Projekt und Token

Erster Aufruf

Eine Frage, eine Antwort

Die Schnittstelle ist eine HTTP-API: Sie schicken eine Adresse mit einem Token — einem Zugangsschlüssel, der Sie ausweist — und bekommen JSON zurück, ein Textformat, das Menschen lesen und Programme auswerten können. Der folgende Aufruf verändert nichts. Er fragt nur, was gerade läuft.

Die Anfragebash
# Ein Token liegt in der Umgebung, eine Projekt-ID kennt man aus dem Panel.
$ export ENTRONYX_TOKEN="ex_live_9f3c1a7d2b48e05c"
 
# Frage: Welche Instanzen laufen im Projekt, Standort Frankfurt?
$ curl -sS https://api.entronyx.cloud/v2/compute/instances \
    -H "Authorization: Bearer $ENTRONYX_TOKEN" \
    -H "X-Entronyx-Project: prj_4c81f0" \
    -G --data-urlencode "region=fra1"
Zwei Kopfzeilen tragen alles Nötige: das Token weist Sie aus, die Projekt-ID sagt, in welchem Bereich gesucht wird. -G hängt die Suchbedingungen an die Adresse, statt sie in den Rumpf zu schreiben.
Die Antwortjson
HTTP/2 200
content-type: application/json; charset=utf-8
x-request-id: req_8d41c0e7
x-ratelimit-remaining: 2999
 
{
  "data": [
    {
      "id": "inst_9a2f31",
      "name": "web-01",
      "state": "running",
      "flavor": "nx-4-8",
      "region": "fra1",
      "created_at": "2026-08-14T09:12:44Z",
      "network": {
        "ipv4": "185.42.7.19",
        "ipv6": "2a0e:97c0:3f0::19"
      }
    }
  ],
  "meta": {
    "total": 1,
    "next_cursor": null
  }
}
Der Status 200 steht für „gefunden und ausgeliefert“. Eine leere Trefferliste ist ebenfalls 200 — nicht 404. Ein 404 hieße: Diese Adresse gibt es nicht.

Was zurückkommt, Feld für Feld

data
Die Trefferliste. Sie heißt immer data und ist immer eine Liste, auch bei genau einem Treffer. Ihr Programm braucht deshalb keine Fallunterscheidung.
id
Die Ressourcenkennung. Sie ändert sich nie und gehört in jede Störungsmeldung — über den Namen allein lässt sich eine Instanz nicht zuordnen.
state
Der Betriebszustand: running, stopped, building oder error. Bei building heißt die richtige Reaktion erneut abfragen, nicht erneut erzeugen.
meta.next_cursor
Steht hier ein Wert, gibt es weitere Seiten; dann hängen Sie ihn als cursor an die nächste Abfrage. Bei null war das alles.
x-request-id
Die Kennung dieses einen Aufrufs, aus dem Antwortkopf. Nennen Sie sie im Ticket, dann findet der Support genau diese Anfrage im Protokoll.
x-ratelimit-remaining
Wie viele Aufrufe in der laufenden Minute noch frei sind. Bei 0 antwortet die Schnittstelle mit 429 statt mit Daten.
Terminalfenster mit einem laufenden Aufruf, daneben ein Notizblock mit handschriftlich notierter Projektkennung.
Der Aufruf braucht keine Bibliothek und keine Installation: curl liegt auf jedem Linux und macOS bereits vor. Bis zu 3.000 Aufrufe je Minute und Projekt sind frei — die drei Kopfzeilen oben sind alles, was ENTRONYX CLOUD von Ihnen braucht.

Schnellstart

Drei Wege zur selben Schnittstelle

Derselbe Vorgang wie oben, nur schreibend — und in drei Schreibweisen. Alle drei sprechen dieselbe Schnittstelle: die rohe HTTP-API, die Kommandozeile und der Terraform-Provider. Terraform ist ein Werkzeug, das Infrastruktur aus Textdateien aufbaut; der Provider ist das Modul, das ihm ENTRONYX CLOUD beibringt. Alle Aufrufe gehen an die Version v2 der Schnittstelle. Ältere Versionen kündigen wir zwölf Monate im Voraus an und betreiben sie in dieser Zeit weiter.

Basis-URL
api.entronyx.cloud
Authentifizierung
Bearer-Token
Ratenbegrenzung
3.000 / min
Format
JSON, UTF-8

HTTP-API mit curl

Eine Instanz erzeugenbash
# Eine Instanz erzeugen. Die Antwort trägt 201 und die neue Ressourcen-ID.
$ curl -sS -X POST https://api.entronyx.cloud/v2/compute/instances \
    -H "Authorization: Bearer $ENTRONYX_TOKEN" \
    -H "X-Entronyx-Project: prj_4c81f0" \
    -H "Content-Type: application/json" \
    -H "Idempotency-Key: 6f2a-web01-20260828" \
    -d '{
      "name": "web-01",
      "flavor": "nx-4-8",
      "region": "fra1",
      "image": "debian-13",
      "ssh_keys": ["key_7a21bc"],
      "private_network": "vnet_2f19",
      "backup_retention_days": 14
    }'
Der Kopf Idempotency-Key ist optional, aber dringend empfohlen. Er ist eine selbst gewählte Kennung für genau diesen einen Vorgang: Bricht die Verbindung ab und Sie wiederholen den Aufruf, erkennt ihn die Schnittstelle wieder und erzeugt keine zweite Instanz. Der Schlüssel ist 24 Stunden gültig.

Kommandozeile entronyx

Installation und typische Aufrufebash
# Installation unter Debian und Ubuntu
$ curl -fsSL https://pkg.entronyx.cloud/gpg | sudo tee /etc/apt/keyrings/entronyx.asc >/dev/null
$ echo "deb [signed-by=/etc/apt/keyrings/entronyx.asc] https://pkg.entronyx.cloud/apt stable main" \
    | sudo tee /etc/apt/sources.list.d/entronyx.list
$ sudo apt update && sudo apt install entronyx
 
# Anmelden und das aktive Projekt festlegen
$ entronyx auth login --token-file ~/.config/entronyx/token
$ entronyx config set-project prj_4c81f0
 
# Instanz erzeugen und nur die IPv4-Adresse ausgeben
$ entronyx compute create \
    --name web-01 --flavor nx-4-8 --region fra1 \
    --image debian-13 --ssh-key key_7a21bc \
    --output json --query ".network.ipv4"
 
# Knotengruppe eines Kubernetes-Clusters auf sechs Knoten setzen
$ entronyx k8s nodepool scale --cluster k8s-prod --pool general --count 6 --wait
 
# Alle Server einer Region auflisten, die älter als 400 Tage sind
$ entronyx bare-metal list --region fra2 --older-than 400d --output table
Ein statisch gelinktes Binary — eine einzelne Programmdatei ohne Laufzeitabhängigkeiten — für Linux, macOS und Windows. Rückgabewert (Exit-Code) 0 bei Erfolg, 2 bei Nutzungsfehlern, 3 bei API-Fehlern, 4 bei Zeitüberschreitung.

Terraform-Provider

Provider, Zustandsablage und drei Instanzenhcl
terraform {
  required_version = ">= 1.9"
 
  required_providers {
    entronyx = {
      source  = "entronyx/entronyx"
      version = "~> 2.4"
    }
  }
 
  # Zustand im eigenen Object Storage, mit serverseitiger Sperre.
  backend "s3" {
    bucket       = "tfstate-prod"
    key          = "infra/terraform.tfstate"
    endpoints    = { s3 = "https://s3.fra1.entronyx.cloud" }
    region       = "fra1"
    use_lockfile = true
 
    skip_credentials_validation = true
    skip_region_validation      = true
    skip_requesting_account_id  = true
  }
}
 
provider "entronyx" {
  # Token kommt aus ENTRONYX_TOKEN, nicht aus dieser Datei.
  project = "prj_4c81f0"
  region  = "fra1"
}
 
resource "entronyx_private_network" "core" {
  name     = "core"
  cidr     = "10.42.0.0/16"
  regions  = ["fra1", "fra2"]
}
 
resource "entronyx_compute_instance" "web" {
  count = 3
 
  name            = format("web-%02d", count.index + 1)
  flavor          = "nx-4-8"
  image           = "debian-13"
  region          = "fra1"
  ssh_keys        = [entronyx_ssh_key.deploy.id]
  private_network = entronyx_private_network.core.id
 
  backup {
    retention_days = 14
    window         = "02:00-04:00"
  }
 
  lifecycle {
    # Ein Wechsel des Abbilds erzwingt einen Neuaufbau — hier bewusst blockiert.
    prevent_destroy = true
  }
}
Der Provider liegt in der öffentlichen Registry unter entronyx/entronyx. Die Zustandsdatei lässt sich in unserem Object Storage ablegen. Die Sperre, die zwei gleichzeitige Läufe voneinander fernhält, nutzt bedingte Schreibvorgänge und braucht keine zusätzliche Datenbank.
Geöffnetes 2-HE-Servergehäuse von schräg oben auf der Werkbank: Kühlkörper mit Kupferboden über dem Sockel, bestückte und verriegelte Speicherbänke, Lüfterwand, hinten die Netzteile mit Kaltgerätebuchse, an der Front die Laufwerkseinschübe.

Ressourcenmodell

Vier Ebenen, mehr gibt es nicht

Die Kennungen aus dem Beispiel oben sind keine Zufallszeichen. Jede benennt eine Ebene, und die Ebenen stecken ineinander. Wer diese vier kennt, kann jede Adresse der Schnittstelle lesen.

  1. Ebene 1

    Konto

    Eine Rechnungseinheit

    Das Konto trägt Vertrag, Rechnungsanschrift und Zahlungsweise. Es enthält selbst keine Technik.

  2. Ebene 2

    Projekt

    prj_4c81f0

    Die Grenze für Rechte, Kosten und Ratenbegrenzung. Ein Token gilt für genau ein Projekt; wer zwei Projekte anspricht, braucht zwei Token.

  3. Ebene 3

    Region

    fra1, fra2, hel1

    Der physische Standort. Zwischen Regionen fließen Daten nur, wenn Sie es ausdrücklich einrichten — eine Ressource wechselt die Region nie von selbst.

  4. Ebene 4

    Ressource

    inst_9a2f31

    Instanz, Datenträger, Netz, Cluster. Jede trägt eine unveränderliche Kennung, jede lässt sich einzeln lesen, ändern und löschen.

Authentifizierung: ein Token, ein Projekt

Jeder Aufruf trägt ein Token im Kopf Authorization. Ein Token gilt für genau ein Projekt und für die Rechte, die Sie ihm bei der Ausstellung geben — Lesen, Betreiben, Abrechnen oder Verwalten.

  • Ein Token ist nur einmal sichtbar. Bei der Ausstellung, danach nie wieder. Verloren heißt neu ausstellen, nicht nachschlagen.
  • Ein Token gehört nie ins Repository. In die Umgebung, in einen Geheimnisspeicher oder in die Datei, die Ihre Kommandozeile liest — nie in eine Datei, die versioniert wird, also mit dem Quelltext geteilt.
  • 401 heißt Token, 403 heißt Recht. Bei 401 fehlt oder verfällt das Token. Bei 403 ist es gültig, deckt aber den angefragten Vorgang nicht ab.
Geschlossene Frontblende einer Serverzeile mit der eingeprägten Wortmarke ENTRONYX CLOUD.
Panel, Kommandozeile und Terraform-Provider gehen durch dieselbe Tür: Es gibt bei ENTRONYX CLOUD keinen zweiten, bequemeren Weg an der Rechteprüfung vorbei. Was ein Token nicht darf, kann auch ein Klick nicht.

Fehlerbehandlung

Was Ihr Client können muss

Jede Fehlerantwort enthält ein Objekt mit maschinenlesbarem Code, Klartextmeldung und einer Anfragekennung für Rückfragen — der x-request-id aus dem ersten Aufruf. Wiederholen Sie nur die Codes, die als wiederholbar gekennzeichnet sind. Bei allen anderen ändert sich das Ergebnis nicht, solange die Anfrage gleich bleibt.

Antwortcodes, die jeder Client behandeln sollte
CodeBedeutungWiederholbarEmpfohlenes Verhalten
400Anfrage fehlerhaft aufgebautneinAnfrage korrigieren, Fehlerobjekt auswerten
401Token fehlt, abgelaufen oder widerrufenneinNeues Token beziehen
403Token gültig, Berechtigung fehltneinBereich des Tokens prüfen
409Zustandskonflikt, z. B. Name vergebenneinVorhandene Ressource lesen
422Semantisch unzulässig, z. B. Flavor nicht in RegionneinAlternative wählen
429Ratenbegrenzung erreichtjaRetry-After abwarten, dann exponentiell zurückweichen (die Pause je Versuch verdoppeln)
500Unerwarteter Fehler auf unserer SeitejaBis zu 3 Versuche mit zufälliger Streuung
503Vorübergehend nicht verfügbarjaRetry-After beachten
Bei 429 und 503 steht die Wartezeit im Kopf Retry-After. Wer sie ignoriert und sofort erneut anfragt, verlängert die Sperre.

Index

Zehn Bereiche, alles durchsuchbar

Gesucht wird über Titel, Kurzbeschreibung und Pfad. Fundstellen sind im Text ausgezeichnet, die Trefferzahl wird angesagt, und die Trefferliste lässt sich vollständig mit den Pfeiltasten bedienen. Jeder Artikel trägt das Datum der letzten fachlichen Prüfung, nicht nur das der letzten Textänderung.

50 Artikel in 10 Bereichen

Pfeiltasten bewegen durch die Treffer, Enter öffnet einen Eintrag, Escape leert die Suche.

Erste Schritte

6 Artikel

Vom Konto bis zum ersten laufenden System. Wer hier durch ist, kann alles Weitere über die API automatisieren.

Bare Metal

5 Artikel

Dedizierte Hardware: Bereitstellung, Betriebssysteme, Wiederherstellung und Umgang mit Hardwarefehlern.

Cloud

5 Artikel

Instanzen, Abbilder, Snapshots und Skalierung in der Public Cloud. Sekundengenaue Abrechnung ab Start.

Kubernetes

5 Artikel

Verwaltete Cluster: Control Plane, Knotengruppen, Speicher- und Lastverteilungsanbindung.

Storage

5 Artikel

Object Storage, Block Storage, Backup und Archiv. Grenzwerte, Konsistenzzusagen und Abrechnung.

Netzwerk

5 Artikel

Adressen, private Netze, Lastverteilung, DDoS-Filter und was der Backbone zusichert.

API-Referenz

6 Artikel

REST über HTTPS, JSON, Bearer-Token. Versioniert unter /v2, Abkündigungen mit zwölf Monaten Vorlauf.

CLI

4 Artikel

Das Kommandozeilenwerkzeug entronyx. Ein statisch gelinktes Binary für Linux, macOS und Windows.

Terraform

4 Artikel

Offizieller Provider in der Registry. Zustandsverwaltung, Importe und Besonderheiten je Ressource.

Abrechnung

5 Artikel

Rechnungsläufe, Kostenstellen, Kontingente und die Frage, wie ein Preis auf der Rechnung zustande kommt.

Hinweis zu diesem Demonstrationsprojekt: Dieser Index bildet die Struktur des Dokumentationsportals ab. Die einzelnen Artikelseiten unter den angegebenen Pfaden sind nicht Teil dieses Aufbaus — die Pfade stehen hier als Kennung, nicht als Verweis. Deshalb öffnet ein Eintrag seine Angaben an Ort und Stelle, statt auf eine Seite zu führen, die es nicht gibt.

Wenn die Dokumentation nicht weiterhilft

Drei Anlaufstellen, in dieser Reihenfolge: erst der Systemstatus, dann die zugesagten Fristen, dann das Ticket.

  1. Schritt 1SystemstatusBevor Sie ein Ticket schreiben: Ein Blick auf die Statusseite klärt, ob die Ursache bei uns liegt und ob wir sie bereits kennen.
  2. Schritt 2Service Level AgreementZugesagte Verfügbarkeit je Klasse, Messverfahren, Reaktionszeiten und die Gutschriftenstaffel im Wortlaut.
  3. Schritt 3Technischer SupportErstreaktion je nach Supportstufe zwischen 15 Minuten und 8 Stunden. Bei Störungen bitte Ressourcen-ID und Zeitstempel mit Zeitzone angeben.

Erst lesen, dann automatisieren

Was im Panel geht, geht auch über die API

Der Terraform-Provider und die Kommandozeile sprechen dieselbe Schnittstelle wie das Kundenpanel — es gibt keine Funktion, die nur klickbar ist. Für den Einstieg genügen ein Token, eine Projekt-ID und fünf Minuten.

Ressource konfigurierenFrage an den Support
Abdeckung Panel/API
vollständig
Beschreibung
OpenAPI 3.1
Provider
entronyx/entronyx
Idempotenz-Schlüssel
24 h gültig