APIs pour les développeurs

Déployez et gérer votre cloud depuis votre code.

Affiche les informations de votre compte:

GET /account
Requête
curl -s --header 'Content-Type: application/json' --request GET -H 'Authorization: Basic API_KEY' 'https://api.virtua.cloud/account'
Réponse
{
"balance":"93.6425",
"currency":"EUR",
"monthly_cloud_usage":"6.4590",
"monthly_cloud_usage_estimate":"37.5633",
"timezone":"Europe\/Paris",
"today_cloud_usage":"1.0714",
"cloud_servers_limit":"8"
}

Retourne votre utilisation et limitations de ressources cloud:

GET /cloud/limits
Requête
curl -s --header 'Content-Type: application/json' --request GET -H 'Authorization: Basic API_KEY' 'https://api.virtua.cloud/cloud/limits'
Réponse
{
"success":true,
"usage":
{
"cloud_servers":5,
"vcpus":"10",
"memory_size":"18944",
"root_space":"120",
"ip_address_v4":"5",
"ip_address_v6":"3"
},
"limits":
{
"cloud_servers":"8",
"smtp_enabled":"1"
}
}

Liste l'ensemble de vos serveurs cloud:

GET /cloud-server
Requête
curl -s --header 'Content-Type: application/json' --request GET -H 'Authorization: Basic API_KEY' 'https://api.virtua.cloud/cloud-server'
Réponse
{
"success":true,
"cloud_servers":[
{
"uuid":"4768103d-7e0b-46c8-8f65-360bcd7b3322",
"name":"vs4023.par01fr.vsys.cloud",
"label":null,
"offer":
{
"uuid":"vcs-2-win-ryzen",
"category":"vcs-win",
"name":"vCS-2-WIN",
"price_month":"12.00",
"price_hour":"0.0164"
},
"start_time":"2020-02-10 13:53:53",
"end_time":"2020-02-10 22:05:01",
"monthly_usage":"0.134243111111080000000000000000",
"short_description":null,
"is_suspended":"0",
"suspension_reason":null,
"cloud_zone":
{
"country_code":"FR",
"country_name":"France",
"city_name":"Paris",
"datacenter_name":"Iliad DC2",
"timezone":"Europe\/Paris"
},
"vcpus":"2",
"vcpus_used":"1",
"memory_size":"4096",
"memory_size_used":"3597",
"root_space":"40",
"root_disk_type":"nvme",
"status":"running",
"is_error":"0",
"is_setup":"1",
"system":
{
"uuid":"win2k19-std-fr-64",
"name":"Windows Server 2019 Standard (64 bits)"
},
"uptime":"14624",
"vm_type":"qemu",
"setup_step":null,
"netboot_on":null,
"netboot_is_setup":"1",
"is_smtp_allowed":"1",
"hostname":null,
"is_setup_at":"2020-02-10 13:53:53",
"is_ipv6_enabled":"1",
"is_processing":"0",
"ssh_keys":null,
"keyboard":"fr"
}
]
}

Affiche les informations d'un serveur cloud en particulier:

GET /cloud-server/UUID
Requête
curl -s --header 'Content-Type: application/json' --request GET -H 'Authorization: Basic API_KEY' 'https://api.virtua.cloud/cloud-server/UUID'
Réponse
{
"success":true,
"uuid":"4768103d-7e0b-46c8-8f65-360bcd7b3322",
"name":"vs4023.par01fr.vsys.cloud",
"label":null,
"offer":
{
"uuid":"vcs-2-win-ryzen",
"category":"vcs-win",
"name":"vCS-2-WIN",
"price_month":"12.00",
"price_hour":"0.0164"
},
"start_time":"2020-02-10 13:53:53",
"end_time":"2020-02-10 22:05:01",
"monthly_usage":"0.134243111111080000000000000000",
"short_description":null,
"is_suspended":"0",
"suspension_reason":null,
"cloud_zone":
{
"country_code":"FR",
"country_name":"France",
"city_name":"Paris",
"datacenter_name":"Iliad DC2",
"timezone":"Europe\/Paris"
},
"vcpus":"2",
"vcpus_used":"1",
"memory_size":"4096",
"memory_size_used":"3597",
"root_space":"40",
"root_disk_type":"nvme",
"status":"running",
"is_error":"0",
"is_setup":"1",
"system":
{
"uuid":"win2k19-std-fr-64",
"name":"Windows Server 2019 Standard (64 bits)"
},
"uptime":"14624",
"vm_type":"qemu",
"setup_step":null,
"netboot_on":null,
"netboot_is_setup":"1",
"is_smtp_allowed":"1",
"hostname":null,
"is_setup_at":"2020-02-10 13:53:53",
"is_ipv6_enabled":"1",
"is_processing":"0",
"ssh_keys":null,
"keyboard":"fr"
}

Démarre un serveur cloud:

POST /cloud-server/UUID/start
Requête
curl -s --header 'Content-Type: application/json' --request POST -H 'Authorization: Basic API_KEY' 'https://api.virtua.cloud/cloud-server/UUID/start'
Réponse
{
"success":true,
"uuid":"UUID",
"messages":[
{
"content":"Start in progress...",
"type":"notice"
}
]
}

Arrête un serveur cloud:

POST /cloud-server/UUID/stop
Requête
curl -s --header 'Content-Type: application/json' --request POST -H 'Authorization: Basic API_KEY' 'https://api.virtua.cloud/cloud-server/UUID/stop'
Réponse
{
"success":true,
"uuid":"UUID",
"messages":[
{
"content":"Stop in progress...",
"type":"notice"
}
]
}

Redémarre un serveur cloud:

POST /cloud-server/UUID/restart
Requête
curl -s --header 'Content-Type: application/json' --request POST -H 'Authorization: Basic API_KEY' 'https://api.virtua.cloud/cloud-server/UUID/restart'
Réponse
{
"success":true,
"uuid":"UUID",
"messages":[
{
"content":"Start in progress...",
"type":"notice"
}
]
}

Redimentionne un serveur cloud:

POST /cloud-server/UUID/resize
Paramètres
  • offer: The new Offer UUID
  • resize_disk: Boolean, 1 upgrade the disk size, 0 keep the disk size unchanged
  • Requête
    curl -s --header 'Content-Type: application/json' --request POST -H 'Authorization: Basic API_KEY' 'https://api.virtua.cloud/cloud-server/UUID/resize' --data 'offer=NEW_OFFER_UUID' -d 'resize_disk=1'
    Réponse
    {
    "success":true,
    "uuid":"UUID",
    "messages":[
    {
    "content":"Update in progress...",
    "type":"notice"
    }
    ]
    }

    Supprime un serveur cloud:

    DELETE /cloud-server/UUID
    Requête
    curl -s --header 'Content-Type: application/json' --request DELETE -H 'Authorization: Basic API_KEY' 'https://api.virtua.cloud/cloud-server/UUID'
    Réponse
    {
    "success":true,
    "uuid":"UUID",
    "messages":[
    {
    "content":"Server destroyed.",
    "type":"notice"
    }
    ]
    }

    Installe un nouveau serveur cloud:

    POST /cloud/order
    Paramètres
  • offer: The Offer UUID
  • system: The System UUID
  • ipv6_enabled: Boolean, 1 enable and addign a IPv6, 0 disable IPv6 and no IPv6 assignation
  • hostname: Custom hostname
  • project: The Project UUID
  • Requête
    curl -s --header 'Content-Type: application/json' --request POST -H 'Authorization: Basic API_KEY' 'https://api.virtua.cloud/cloud/order' --data 'offer=OFFER_UUID' -d 'system=SYSTEM_UUID' -d 'ipv6_enable=0' -d 'hostname=my.server.cloud' -d 'project=PROJECT_UUID'
    Réponse
    {
    "success":true,
    "uuid":"UUID",
    }

    Vous avez des questions sur nos services ou avez besoin de conseils ?

    Envoyez-nous un e-mail, nous sommes là pour vous aider.

    Nous contacter

    VISA Mastercard Maestro AMEX Apple Pay Google Pay PayPal Bitcoin Bancontact/MisterCash iDEAL SOFORT AliPay AliPay WeChat