The create command is used to provision a new instance.

JSON Input Data Format
{
    "cloudid": string,
    "name": string,
    "password": string,
    "network": string,
    "cpu": integer,
    "cputime": integer,
    "ram": integer,
    "disk": integer,
    "net": integer,
    "vlan": integer,
    "gpu": string,
    "spark": string
}
cloudid * Specifies the cloud ID where the instance will be provisioned.
name * Specifies a 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 150.
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.
spark * Specifies the Data Spark-house cluster ID from which the S3 access policies are inherited.
* 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 ..."
}