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.
https://console.omc.cloud/serviceErstellen 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:
curl https://console.omc.cloud/service/servers
-H "Content-Type: application/json"
-H "clientId: YOUR_CLIENT_ID"
-H "secret: YOUR_SECRET"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"/serversGibt ein Array aller Server in Ihrem Konto mit ID, Rechenzentrum, Name und Betriebszustand zurück.
curl https://console.omc.cloud/service/servers
-H "clientId: YOUR_CLIENT_ID"
-H "secret: YOUR_SECRET"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())/serverGibt 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 https://console.omc.cloud/service/server
-H "clientId: YOUR_CLIENT_ID"
-H "secret: YOUR_SECRET"/serverStellt einen neuen virtuellen Server mit der angegebenen Konfiguration bereit. Gibt eine Task-ID zurück, die Sie bis zum Abschluss abfragen können.
disk_src_0 – ID des Betriebssystem-Imagesdatacenter – Standortcodename – Servername (4-40 Zeichen, alphanumerisch + ./-/_)cpu – CPU-Typ und Anzahl (z. B. 1B, 2D)ram – Arbeitsspeicher in MBpassword – 9-32 Zeichen, Groß- und Kleinbuchstaben + Ziffernbilling – monthly oder hourlytraffic – ID des Traffic-Pakets (z. B. t5000)disk_size_0 – Festplattengröße in GBnetwork_name_0 – Netzwerkname (wan für automatische IP verwenden)managed – Managed Services aktivierenbackup – Tägliche Backups aktivierenpower – Nach Abschluss automatisch startenselectedSSHKeyValue – Öffentlicher SSH-Schlüsselnetwork_ip_0 – Bestimmte IP (optional bei WAN)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"
}'/server/cloneDupliziert einen bestehenden Server einschließlich Betriebssystem, Software, Konfiguration und Daten. Gibt eine Task-ID zurück.
Erforderlich: source (UUID), name, password, billing
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"
}'/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 https://console.omc.cloud/service/server/SERVER_UUID
-H "clientId: YOUR_CLIENT_ID"
-H "secret: YOUR_SECRET"/server/{serverid}/terminateEntfernt 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 -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'/server/{serverid}/powerSchalten 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 -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'/server/{serverid}/cpuGibt die CPU-Konfigurationen zurück, auf die der Server skaliert werden kann (Typen A, B, T, D mit bis zu 104 vCPUs).
/server/{serverid}/cpuÄndern Sie die CPU-Größe des Servers. Senden Sie cpu=2B als Formulardaten.
/server/{serverid}/ramGibt die für jeden CPU-Typ verfügbaren RAM-Größen in MB zurück.
/server/{serverid}/ramÄndern Sie den RAM des Servers. Senden Sie ram=4096 als Formulardaten (Größe in MB).
/server/{serverid}/diskGibt das Array der Festplattengrößen in GB zurück, auf die Sie skalieren können.
/server/{serverid}/diskÄndern Sie die Größe einer bestehenden Festplatte. Senden Sie JSON: {"size":"40","index":"0","provision":"1"}
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"}'/server/{serverid}/diskFügen Sie dem Server eine zusätzliche Festplatte hinzu. Senden Sie size=20&provision=1 als Formulardaten.
/server/{serverid}/disk/removeLöscht eine Festplatte dauerhaft. Senden Sie index=1&confirm=1 als Formulardaten. Der Datenverlust ist endgültig.
/server/{serverid}/snapshotsGibt ein Array aller Snapshots des Servers mit ID, Name, Datum, Aktivstatus und Tiefe zurück.
/server/{serverid}/snapshotErstellen Sie einen Snapshot des Servers zu einem bestimmten Zeitpunkt. Senden Sie name=my-snapshot.
/server/{serverid}/snapshotStellen Sie den Server auf einen früheren Snapshot zurück. Senden Sie snapshotId=1745411375.
/server/{serverid}/snapshotEntfernen Sie einen Snapshot. Senden Sie snapshotId=1745411375.
/server/{serverid}/renameÄndern Sie den Namen des Servers. Senden Sie name=new-server-name. Vorgaben: 4-40 Zeichen, Buchstaben/Ziffern/Punkte/Bindestriche/Unterstriche.
/server/{serverid}/passwordAktualisieren Sie das Root-Passwort des Servers. Senden Sie password=NewSecurePass123. Vorgaben: 9-32 Zeichen, Groß- und Kleinbuchstaben + Ziffern.
/server/{serverid}/billingGibt den aktuellen und künftigen Abrechnungsmodus des Servers zurück.
/server/{serverid}/billingWechseln Sie zwischen monatlicher und stündlicher Abrechnung. Senden Sie type=monthly&traffic=t5000.
/server/{serverid}/hdlibGibt ein Array von Festplattenobjekten mit UUID und Größe in GB zurück, die zum Klonen verfügbar sind.
/server/{serverid}/hdlibErstellen Sie eine neue Festplatte aus einer Bibliotheksquelle. Senden Sie disk_name_0=cloned-disk&disk_src_0=DISK_UUID.
Die OMC Cloud API basiert auf REST und funktioniert mit jedem HTTP-Client. Komfortabel nutzen können Sie auch:
requestsfetch, axios oder node-fetchcURL oder GuzzleDie API verwendet Standard-HTTP-Statuscodes:
200 OK – Erfolgreiche Anfrage400 Bad Request – Ungültige Parameter oder fehlerhafte Anfrage401 Unauthorized – Fehlende oder ungültige Zugangsdaten403 Forbidden – Authentifizierung erfolgreich, aber Zugriff verweigert404 Not Found – Ressource existiert nicht500 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.
Erstellen Sie Ihre API-Zugangsdaten im OMC Cloud Dashboard und automatisieren Sie in wenigen Minuten.
API-Zugangsdaten anfordern →Schließen Sie sich Zehntausenden Kunden an, die sich jeden Tag auf OMC verlassen
Mit der Registrierung akzeptieren Sie die Nutzungsbedingungen
Erhalten Sie innerhalb einer halben Stunde ein individuelles Angebot
Mit der Registrierung akzeptieren Sie die Nutzungsbedingungen