OMC Cloud REST API

Verwalten Sie Ihre Cloud-Infrastruktur programmatisch mit der OMC Cloud REST API. Erstellen Sie Server, verwalten Sie Snapshots, konfigurieren Sie das Netzwerk und automatisieren Sie alles, was Sie auch im Dashboard tun können.

Schnellstart

Die OMC Cloud API ist RESTful und funktioniert mit jedem HTTP-Client in jeder Sprache. Authentifizieren Sie sich mit Ihrer Client-ID und Ihrem Secret und rufen Sie dann beliebige Endpunkte auf.

Basis-URL
https://console.omc.cloud/service
Format
JSON
Authentifizierung
Client-ID + Secret
HTTPS
Erforderlich

Authentifizierung

Erstellen Sie Ihre API-Zugangsdaten in Ihrem OMC Cloud Dashboard unter Einstellungen → API-Schlüssel. Sie erhalten eine clientId und ein secret.

Sie können Anfragen auf zwei Arten authentifizieren:

Option 1 – Zugangsdaten direkt in den Headern

curl https://console.omc.cloud/service/servers 
  -H "Content-Type: application/json" 
  -H "clientId: YOUR_CLIENT_ID" 
  -H "secret: YOUR_SECRET"

Option 2 – Token-basiert (empfohlen für wiederholte Aufrufe)

Tauschen Sie zunächst Ihre Zugangsdaten gegen ein Token mit 1 Stunde Gültigkeit:

curl -X POST https://console.omc.cloud/service/authenticate 
  -H "Content-Type: application/json" 
  -d '{"clientId":"YOUR_CLIENT_ID","secret":"YOUR_SECRET"}'

Antwort:

{
  "authentication": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "expires": 1745393200
}

Verwenden Sie das Token anschließend in den folgenden Anfragen:

curl https://console.omc.cloud/service/servers 
  -H "Content-Type: application/json" 
  -H "authorization: YOUR_TOKEN"

Serververwaltung

GETAlle Server auflisten+
/servers

Gibt ein Array aller Server in Ihrem Konto mit ID, Rechenzentrum, Name und Betriebszustand zurück.

cURL
curl https://console.omc.cloud/service/servers 
  -H "clientId: YOUR_CLIENT_ID" 
  -H "secret: YOUR_SECRET"
Python
import requests

url = "https://console.omc.cloud/service/servers"
headers = {
    'Content-Type': 'application/json',
    'clientId': 'YOUR_CLIENT_ID',
    'secret': 'YOUR_SECRET',
}
response = requests.get(url, headers=headers)
print(response.json())
GETVerfügbare Optionen zur Servererstellung abrufen+
/server

Gibt die vollständige Liste der verfügbaren Rechenzentren, CPU-Typen, RAM-Größen, Festplattenoptionen, Betriebssystem-Vorlagen, Traffic-Pakete, Netzwerke und Abrechnungsarten zurück, die Sie beim Erstellen eines neuen Servers verwenden können.

cURL
curl https://console.omc.cloud/service/server 
  -H "clientId: YOUR_CLIENT_ID" 
  -H "secret: YOUR_SECRET"
POSTNeuen Server erstellen+
/server

Stellt einen neuen virtuellen Server mit der angegebenen Konfiguration bereit. Gibt eine Task-ID zurück, die Sie bis zum Abschluss abfragen können.

Pflichtfelder

  • disk_src_0 – ID des Betriebssystem-Images
  • datacenter – Standortcode
  • name – Servername (4-40 Zeichen, alphanumerisch + ./-/_)
  • cpu – CPU-Typ und Anzahl (z. B. 1B, 2D)
  • ram – Arbeitsspeicher in MB
  • password – 9-32 Zeichen, Groß- und Kleinbuchstaben + Ziffern
  • billing – monthly oder hourly
  • traffic – ID des Traffic-Pakets (z. B. t5000)
  • disk_size_0 – Festplattengröße in GB
  • network_name_0 – Netzwerkname (wan für automatische IP verwenden)

Optionale Felder

  • managed – Managed Services aktivieren
  • backup – Tägliche Backups aktivieren
  • power – Nach Abschluss automatisch starten
  • selectedSSHKeyValue – Öffentlicher SSH-Schlüssel
  • network_ip_0 – Bestimmte IP (optional bei WAN)
cURL
curl -X POST https://console.omc.cloud/service/server 
  -H "Content-Type: application/json" 
  -H "clientId: YOUR_CLIENT_ID" 
  -H "secret: YOUR_SECRET" 
  -d '{
    "disk_src_0": "IL:XXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "datacenter": "IL-TLV",
    "name": "my-production-server",
    "cpu": "2B",
    "ram": "4096",
    "password": "YourSecurePass123",
    "network_name_0": "wan",
    "billing": "monthly",
    "traffic": "t5000",
    "disk_size_0": "40"
  }'
POSTBestehenden Server klonen+
/server/clone

Dupliziert einen bestehenden Server einschließlich Betriebssystem, Software, Konfiguration und Daten. Gibt eine Task-ID zurück.

Erforderlich: source (UUID), name, password, billing

cURL
curl -X POST https://console.omc.cloud/service/server/clone 
  -H "Content-Type: application/json" 
  -H "clientId: YOUR_CLIENT_ID" 
  -H "secret: YOUR_SECRET" 
  -d '{
    "source": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "server-clone",
    "password": "YourSecurePass123",
    "billing": "monthly"
  }'
GETServerdetails abrufen+
/server/{serverid}

Gibt vollständige Informationen zu einem bestimmten Server zurück: ID, Rechenzentrum, CPU, RAM, Betriebszustand, Festplatten, Netzwerke (mit IPs), Abrechnungsart, Traffic-Paket, Managed-Status, Backup-Status.

cURL
curl https://console.omc.cloud/service/server/SERVER_UUID 
  -H "clientId: YOUR_CLIENT_ID" 
  -H "secret: YOUR_SECRET"
DELETEServer kündigen+
/server/{serverid}/terminate

Entfernt einen Server dauerhaft. Diese Aktion kann nicht rückgängig gemacht werden. Erforderlicher Body: confirm=1. Ist der Server eingeschaltet, übergeben Sie zusätzlich force=1.

cURL
curl -X DELETE https://console.omc.cloud/service/server/SERVER_UUID/terminate 
  -H "Content-Type: application/x-www-form-urlencoded" 
  -H "clientId: YOUR_CLIENT_ID" 
  -H "secret: YOUR_SECRET" 
  -d 'confirm=1&force=1'

Energieverwaltung

PUTBetriebszustand des Servers steuern+
/server/{serverid}/power

Schalten Sie einen Server ein, aus oder starten Sie ihn neu. Senden Sie power=on, power=off oder power=restart als Formulardaten. Gibt eine Task-ID zurück.

cURL
curl -X PUT https://console.omc.cloud/service/server/SERVER_UUID/power 
  -H "Content-Type: application/x-www-form-urlencoded" 
  -H "clientId: YOUR_CLIENT_ID" 
  -H "secret: YOUR_SECRET" 
  -d 'power=on'

Ressourcenverwaltung (CPU, RAM, Festplatte)

GETVerfügbare CPU-Optionen auflisten+
/server/{serverid}/cpu

Gibt die CPU-Konfigurationen zurück, auf die der Server skaliert werden kann (Typen A, B, T, D mit bis zu 104 vCPUs).

PUTCPU-Konfiguration ändern+
/server/{serverid}/cpu

Ändern Sie die CPU-Größe des Servers. Senden Sie cpu=2B als Formulardaten.

GETVerfügbare RAM-Größen auflisten+
/server/{serverid}/ram

Gibt die für jeden CPU-Typ verfügbaren RAM-Größen in MB zurück.

PUTRAM-Zuweisung ändern+
/server/{serverid}/ram

Ändern Sie den RAM des Servers. Senden Sie ram=4096 als Formulardaten (Größe in MB).

GETVerfügbare Festplattengrößen auflisten+
/server/{serverid}/disk

Gibt das Array der Festplattengrößen in GB zurück, auf die Sie skalieren können.

PUTBestehende Festplatte vergrößern+
/server/{serverid}/disk

Ändern Sie die Größe einer bestehenden Festplatte. Senden Sie JSON: {"size":"40","index":"0","provision":"1"}

cURL
curl -X PUT https://console.omc.cloud/service/server/SERVER_UUID/disk 
  -H "Content-Type: application/json" 
  -H "clientId: YOUR_CLIENT_ID" 
  -H "secret: YOUR_SECRET" 
  -d '{"size":"40","index":"0","provision":"1"}'
POSTNeue Festplatte hinzufügen+
/server/{serverid}/disk

Fügen Sie dem Server eine zusätzliche Festplatte hinzu. Senden Sie size=20&provision=1 als Formulardaten.

DELETEFestplatte löschen+
/server/{serverid}/disk/remove

Löscht eine Festplatte dauerhaft. Senden Sie index=1&confirm=1 als Formulardaten. Der Datenverlust ist endgültig.

Snapshots

GETAlle Snapshots auflisten+
/server/{serverid}/snapshots

Gibt ein Array aller Snapshots des Servers mit ID, Name, Datum, Aktivstatus und Tiefe zurück.

POSTSnapshot erstellen+
/server/{serverid}/snapshot

Erstellen Sie einen Snapshot des Servers zu einem bestimmten Zeitpunkt. Senden Sie name=my-snapshot.

PUTAuf einen Snapshot zurücksetzen+
/server/{serverid}/snapshot

Stellen Sie den Server auf einen früheren Snapshot zurück. Senden Sie snapshotId=1745411375.

DELETESnapshot löschen+
/server/{serverid}/snapshot

Entfernen Sie einen Snapshot. Senden Sie snapshotId=1745411375.

Konfiguration & Abrechnung

PUTServer umbenennen+
/server/{serverid}/rename

Ändern Sie den Namen des Servers. Senden Sie name=new-server-name. Vorgaben: 4-40 Zeichen, Buchstaben/Ziffern/Punkte/Bindestriche/Unterstriche.

PUTRoot-Passwort ändern+
/server/{serverid}/password

Aktualisieren Sie das Root-Passwort des Servers. Senden Sie password=NewSecurePass123. Vorgaben: 9-32 Zeichen, Groß- und Kleinbuchstaben + Ziffern.

GETAbrechnungsmodus abrufen+
/server/{serverid}/billing

Gibt den aktuellen und künftigen Abrechnungsmodus des Servers zurück.

PUTAbrechnungsmodus ändern+
/server/{serverid}/billing

Wechseln Sie zwischen monatlicher und stündlicher Abrechnung. Senden Sie type=monthly&traffic=t5000.

Festplattenbibliothek

GETFestplattenbibliothek auflisten+
/server/{serverid}/hdlib

Gibt ein Array von Festplattenobjekten mit UUID und Größe in GB zurück, die zum Klonen verfügbar sind.

POSTFestplatte aus der Bibliothek klonen+
/server/{serverid}/hdlib

Erstellen Sie eine neue Festplatte aus einer Bibliotheksquelle. Senden Sie disk_name_0=cloned-disk&disk_src_0=DISK_UUID.

SDKs & Tools

Die OMC Cloud API basiert auf REST und funktioniert mit jedem HTTP-Client. Komfortabel nutzen können Sie auch:

cURL
Standard-HTTP aus jeder Shell
Python
Nutzen Sie die Bibliothek requests
Node.js
Nutzen Sie fetch, axios oder node-fetch
PHP
Nutzen Sie cURL oder Guzzle

Fehlerbehandlung

Die API verwendet Standard-HTTP-Statuscodes:

  • 200 OK – Erfolgreiche Anfrage
  • 400 Bad Request – Ungültige Parameter oder fehlerhafte Anfrage
  • 401 Unauthorized – Fehlende oder ungültige Zugangsdaten
  • 403 Forbidden – Authentifizierung erfolgreich, aber Zugriff verweigert
  • 404 Not Found – Ressource existiert nicht
  • 500 Internal Server Error – Serverseitiges Problem (bitte kontaktieren Sie den Support)

Die meisten erfolgreichen Vorgänge geben eine Task-ID zurück, mit der Sie den asynchronen Fortschritt verfolgen können. Alle Anfragen müssen über HTTPS gesendet werden.

Bereit, loszulegen?

Erstellen Sie Ihre API-Zugangsdaten im OMC Cloud Dashboard und automatisieren Sie in wenigen Minuten.

API-Zugangsdaten anfordern →