REST API di OMC Cloud

Restituisce un array di tutti i server del tuo account con ID, data center, nome e stato di alimentazione.

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())

Restituisce l’elenco completo di data center, tipi di CPU, dimensioni di RAM, opzioni disco, template di sistema operativo, pacchetti di traffico, reti e tipi di fatturazione disponibili per creare un nuovo server.

curl https://console.omc.cloud/service/server 
  -H "clientId: YOUR_CLIENT_ID" 
  -H "secret: YOUR_SECRET"

Attiva un nuovo server virtuale con la configurazione specificata. Restituisce un task ID che puoi interrogare per verificarne il completamento.

Campi obbligatori

• disk_src_0 – ID dell’immagine del sistema operativo
• datacenter – Codice della località
• name – Nome del server (4-40 caratteri, alfanumerici + ./-/_)
• cpu – Tipo e numero di CPU (es. 1B, 2D)
• ram – Memoria in MB
• password – 9-32 caratteri, maiuscole e minuscole + numeri
• billing – monthly o hourly
• traffic – ID del pacchetto di traffico (es. t5000)
• disk_size_0 – Dimensione del disco in GB
• network_name_0 – Nome della rete (usa wan per l’IP automatico)

Campi facoltativi

• managed – Attiva i servizi gestiti
• backup – Attiva i backup giornalieri
• power – Avvio automatico al completamento
• selectedSSHKeyValue – Chiave SSH pubblica
• network_ip_0 – IP specifico (facoltativo con 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"
  }'

Duplica un server esistente con sistema operativo, software, configurazione e dati. Restituisce un task ID.

Obbligatori: 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"
  }'

Restituisce tutte le informazioni su un server specifico: ID, data center, CPU, RAM, stato di alimentazione, dischi, reti (con IP), tipo di fatturazione, pacchetto di traffico, stato dei servizi gestiti, stato del backup.

curl https://console.omc.cloud/service/server/SERVER_UUID 
  -H "clientId: YOUR_CLIENT_ID" 
  -H "secret: YOUR_SECRET"

Rimuove definitivamente un server. Questa azione è irreversibile. Body obbligatorio: confirm=1. Se il server è acceso, passa anche 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'

Accendi, spegni o riavvia un server. Invia power=on, power=off o power=restart come form data. Restituisce un task ID.

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'

Restituisce le configurazioni CPU a cui il server può essere ridimensionato (tipi A, B, T, D con un numero di vCPU fino a 104).

Ridimensiona la CPU del server. Invia cpu=2B come form data.

Restituisce le dimensioni di RAM in MB disponibili per ogni tipo di CPU.

Ridimensiona la RAM del server. Invia ram=4096 come form data (dimensione in MB).

Restituisce l’array delle dimensioni disco in GB a cui puoi ridimensionare.

Ridimensiona un disco rigido esistente. Invia 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"}'

Aggiungi un disco rigido aggiuntivo al server. Invia size=20&provision=1 come form data.

Elimina definitivamente un disco. Invia index=1&confirm=1 come form data. La perdita dei dati è definitiva.

Restituisce un array di tutti gli snapshot del server con ID, nome, data, stato attivo e profondità.

Crea uno snapshot del server in un preciso momento. Invia name=my-snapshot.

Riporta il server a uno snapshot precedente. Invia snapshotId=1745411375.

Rimuovi uno snapshot. Invia snapshotId=1745411375.

Modifica il nome del server. Invia name=new-server-name. Vincoli: 4-40 caratteri, lettere/numeri/punti/trattini/underscore.

Aggiorna la password di root del server. Invia password=NewSecurePass123. Vincoli: 9-32 caratteri, maiuscole e minuscole + numeri.

Restituisce la modalità di fatturazione attiva e futura del server.

Passa dalla fatturazione mensile a quella oraria e viceversa. Invia type=monthly&traffic=t5000.

Restituisce un array di oggetti disco con UUID e dimensione in GB, disponibili per la clonazione.

Crea un nuovo disco da una sorgente della libreria. Invia disk_name_0=cloned-disk&disk_src_0=DISK_UUID.