OMC Cloud REST API

Beheer je cloudinfrastructuur programmatisch met de OMC Cloud REST API. Maak servers aan, beheer snapshots, configureer netwerken en automatiseer alles wat je in het dashboard kunt doen.

Snelstart

De OMC Cloud API is RESTful en werkt met elke HTTP-client in elke taal. Authenticeer met je client-ID en secret en roep daarna elk endpoint aan.

Basis-URL
https://console.omc.cloud/service
Formaat
JSON
Authenticatie
Client-ID + secret
HTTPS
Verplicht

Authenticatie

Genereer je API-gegevens in je OMC Cloud-dashboard onder Settings → API Keys. Je ontvangt een clientId en secret.

Je kunt verzoeken op twee manieren authenticeren:

Optie 1 – Gegevens rechtstreeks in de headers

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

Optie 2 – Op basis van een token (aanbevolen voor herhaalde aanroepen)

Wissel eerst je gegevens in voor een token van 1 uur:

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

Antwoord:

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

Gebruik het token daarna in volgende verzoeken:

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

Serverbeheer

GETAlle servers weergeven+
/servers

Geeft een array terug van alle servers in je account met hun ID, datacenter, naam en energiestatus.

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())
GETBeschikbare opties voor het aanmaken van servers opvragen+
/server

Geeft de volledige lijst terug van beschikbare datacenters, CPU-typen, RAM-groottes, schijfopties, OS-templates, verkeerspakketten, netwerken en factureringstypen die je kunt gebruiken bij het aanmaken van een nieuwe server.

cURL
curl https://console.omc.cloud/service/server 
  -H "clientId: YOUR_CLIENT_ID" 
  -H "secret: YOUR_SECRET"
POSTEen nieuwe server aanmaken+
/server

Richt een nieuwe virtuele server in met de opgegeven configuratie. Geeft een taak-ID terug dat je kunt pollen tot de taak voltooid is.

Verplichte velden

  • disk_src_0 – ID van de OS-image
  • datacenter – Locatiecode
  • name – Servernaam (4-40 tekens, alfanumeriek + ./-/_)
  • cpu – CPU-type en aantal (bijv. 1B, 2D)
  • ram – Geheugen in MB
  • password – 9-32 tekens, hoofd- en kleine letters + cijfers
  • billing – monthly of hourly
  • traffic – ID van het verkeerspakket (bijv. t5000)
  • disk_size_0 – Schijfgrootte in GB
  • network_name_0 – Netwerknaam (gebruik wan voor een automatisch IP)

Optionele velden

  • managed – Managed services inschakelen
  • backup – Dagelijkse back-ups inschakelen
  • power – Automatisch opstarten na voltooiing
  • selectedSSHKeyValue – Publieke SSH-sleutel
  • network_ip_0 – Specifiek IP (optioneel met 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"
  }'
POSTEen bestaande server klonen+
/server/clone

Dupliceert een bestaande server inclusief OS, software, configuratie en data. Geeft een taak-ID terug.

Verplicht: 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 opvragen+
/server/{serverid}

Geeft volledige informatie over een specifieke server: ID, datacenter, CPU, RAM, energiestatus, schijven, netwerken (met IP’s), factureringstype, verkeerspakket, managed-status en back-upstatus.

cURL
curl https://console.omc.cloud/service/server/SERVER_UUID 
  -H "clientId: YOUR_CLIENT_ID" 
  -H "secret: YOUR_SECRET"
DELETEEen server beëindigen+
/server/{serverid}/terminate

Verwijdert een server permanent. Deze actie kan niet ongedaan worden gemaakt. Verplichte body: confirm=1. Als de server aan staat, geef dan ook force=1 mee.

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'

Energiebeheer

PUTDe energiestatus van de server regelen+
/server/{serverid}/power

Zet een server aan of uit, of herstart hem. Stuur power=on, power=off of power=restart als form data. Geeft een taak-ID terug.

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'

Resourcebeheer (CPU, RAM, schijf)

GETBeschikbare CPU-opties weergeven+
/server/{serverid}/cpu

Geeft de CPU-configuraties terug waarnaar de server kan worden geschaald (typen A, B, T, D met tot 104 vCPU’s).

PUTCPU-configuratie wijzigen+
/server/{serverid}/cpu

Wijzig de CPU van de server. Stuur cpu=2B als form data.

GETBeschikbare RAM-groottes weergeven+
/server/{serverid}/ram

Geeft de beschikbare RAM-groottes in MB per CPU-type terug.

PUTRAM-toewijzing wijzigen+
/server/{serverid}/ram

Wijzig het RAM van de server. Stuur ram=4096 als form data (grootte in MB).

GETBeschikbare schijfgroottes weergeven+
/server/{serverid}/disk

Geeft de array terug van schijfgroottes in GB waarnaar je kunt schalen.

PUTEen bestaande schijf vergroten+
/server/{serverid}/disk

Wijzig de grootte van een bestaande harde schijf. Stuur 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"}'
POSTEen nieuwe schijf toevoegen+
/server/{serverid}/disk

Voeg een extra harde schijf toe aan de server. Stuur size=20&provision=1 als form data.

DELETEEen schijf verwijderen+
/server/{serverid}/disk/remove

Verwijder een schijf permanent. Stuur index=1&confirm=1 als form data. Gegevensverlies is permanent.

Snapshots

GETAlle snapshots weergeven+
/server/{serverid}/snapshots

Geeft een array terug van alle snapshots van de server met ID, naam, datum, actieve status en diepte.

POSTEen snapshot maken+
/server/{serverid}/snapshot

Maak een snapshot van de server op een bepaald moment. Stuur name=my-snapshot.

PUTTerugzetten naar een snapshot+
/server/{serverid}/snapshot

Zet de server terug naar een eerdere snapshot. Stuur snapshotId=1745411375.

DELETEEen snapshot verwijderen+
/server/{serverid}/snapshot

Verwijder een snapshot. Stuur snapshotId=1745411375.

Configuratie & facturering

PUTEen server hernoemen+
/server/{serverid}/rename

Wijzig de naam van de server. Stuur name=new-server-name. Beperkingen: 4-40 tekens, letters/cijfers/punten/streepjes/underscores.

PUTRootwachtwoord wijzigen+
/server/{serverid}/password

Werk het rootwachtwoord van de server bij. Stuur password=NewSecurePass123. Beperkingen: 9-32 tekens, hoofd- en kleine letters + cijfers.

GETFactureringsmodus opvragen+
/server/{serverid}/billing

Geeft de actieve en toekomstige factureringsmodus van de server terug.

PUTFactureringsmodus wijzigen+
/server/{serverid}/billing

Schakel tussen facturering per maand en per uur. Stuur type=monthly&traffic=t5000.

Bibliotheek met harde schijven

GETDe bibliotheek met harde schijven weergeven+
/server/{serverid}/hdlib

Geeft een array terug van schijfobjecten met UUID en grootte in GB die beschikbaar zijn om te klonen.

POSTEen schijf uit de bibliotheek klonen+
/server/{serverid}/hdlib

Maak een nieuwe schijf aan vanuit een bron in de bibliotheek. Stuur disk_name_0=cloned-disk&disk_src_0=DISK_UUID.

SDK’s & tools

De OMC Cloud API is gebaseerd op REST en werkt met elke HTTP-client. Voor het gemak kun je ook het volgende gebruiken:

cURL
Standaard HTTP vanuit elke shell
Python
Gebruik de requests-bibliotheek
Node.js
Gebruik fetch, axios of node-fetch
PHP
Gebruik cURL of Guzzle

Foutafhandeling

De API gebruikt standaard HTTP-statuscodes:

  • 200 OK – Geslaagd verzoek
  • 400 Bad Request – Ongeldige parameters of onjuist opgebouwd verzoek
  • 401 Unauthorized – Ontbrekende of ongeldige gegevens
  • 403 Forbidden – Authenticatie geslaagd maar toestemming geweigerd
  • 404 Not Found – Resource bestaat niet
  • 500 Internal Server Error – Probleem aan de serverkant (neem contact op met support)

De meeste geslaagde bewerkingen geven een taak-ID terug waarmee je de asynchrone voortgang kunt volgen. Alle verzoeken moeten via HTTPS worden verzonden.

Klaar om te gaan bouwen?

Genereer je API-gegevens in het OMC Cloud-dashboard en begin binnen enkele minuten met automatiseren.

API-gegevens aanvragen →