The create command is used to provision a new instance.

JSON Input Data Format
{
    "cloudid": string,
    "name": string,
    "os": string,
    "password": string,
    "network": string,
    "cpu": integer,
    "cputime": integer,
    "ram": integer,
    "disk": integer,
    "net": integer,
    "vlan": integer,
    "gpu": string
}
cloudid * Specifies the cloud ID where the instance will be provisioned.
name * Specifies a name for the instance.
os * Specifies the image name for the instance.
password * Specifies the root user password for the instance. This field allows the use of Secret Key Tags to obfuscate the password, ensuring enhanced security.
network Specifies the network for the instance, which defaults to xcNET.
cpu Specifies the number of CPU cores allocated to the instance, which defaults to 1.
cputime Specifies how much time of the assigned CPU cores can be allocated. For example: If you have 1 CPU core and utilize 50% of CPU Time, that would be like assigning 1/2 (half) a CPU to the instance.
ram Specifies the amount of RAM allocated in gigabytes to the instance, which defaults to 1.
disk Specifies the amount of disk space allocated in gigabytes to the instance, which defaults to 10.
net Specifies the network bandwidth, measured in megabits per second, that will be allocated to the instance, which defaults to MAX.
vlan Specifies the VLAN tag ID for the instance, which defaults to 0.
gpu Specifies whether the instance can access the GPU of the Sky Node. You can find more information about how to enable GPU here: GPU for Instances.
* Indicates a mandatory field.

Code Snippets
Here are several code snippets provided for your direct use. Simply select your preferred tool/language by clicking on it.


Successful Response
{
    "result": "OK",
    "payload": "The process was successfully completed",
    "id": "V7cs-6ad2e304-xxxx-xxxx-xxxx-7f43xxxx5b7f"

 }

Failed Response
{
    "result": "ERR",
    "message": "Error message ..."
}