Skip to main content
POST
/
v1
/
projects
/
{projectId}
/
machines
Create a machine
curl --request POST \
  --url https://rest.compute.cudo.org/v1/projects/{projectId}/machines \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "commitmentTerm": "COMMITMENT_TERM_NONE",
  "customSshKeys": [
    "<string>"
  ],
  "dataCenterId": "<string>",
  "id": "<string>",
  "machineTypeId": "<string>",
  "os": "<string>",
  "powerState": "MACHINE_POWER_STATE_UNSPECIFIED",
  "priceHr": {
    "value": "<string>"
  },
  "sshKeySource": "SSH_KEY_SOURCE_UNKNOWN",
  "startScript": "<string>",
  "state": "STATE_UNSPECIFIED",
  "userData": "<string>"
}'
{
  "architecture": "<string>",
  "commitmentTerm": "COMMITMENT_TERM_NONE",
  "cpuCores": 123,
  "cpuModel": "<string>",
  "cpuSpeedMhz": 123,
  "createBy": "<string>",
  "createTime": "2023-11-07T05:31:56Z",
  "customSshKeys": [
    "<string>"
  ],
  "dataCenterId": "<string>",
  "diskSizeGib": 123,
  "disks": 123,
  "externalIpAddresses": [
    "<string>"
  ],
  "gpuModelId": "<string>",
  "gpus": 123,
  "hostname": "<string>",
  "id": "<string>",
  "machineTypeId": "<string>",
  "memoryGib": 123,
  "os": "<string>",
  "powerState": "MACHINE_POWER_STATE_UNSPECIFIED",
  "priceHr": {
    "value": "<string>"
  },
  "projectId": "<string>",
  "sshKeySource": "SSH_KEY_SOURCE_UNKNOWN",
  "startScript": "<string>",
  "state": "STATE_UNSPECIFIED",
  "userData": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer HTTP authentication. Allowed headers-- Authorization: Bearer <api_key>

Path Parameters

​
projectId
string
required

Body

application/json

Create machine params

​
dataCenterId
string
required
​
id
string
required
​
machineTypeId
string
required
​
os
string
required
​
commitmentTerm
enum<string>
default:COMMITMENT_TERM_NONE
Available options:
COMMITMENT_TERM_NONE,
COMMITMENT_TERM_1_MONTH,
COMMITMENT_TERM_3_MONTHS,
COMMITMENT_TERM_6_MONTHS,
COMMITMENT_TERM_12_MONTHS,
COMMITMENT_TERM_24_MONTHS,
COMMITMENT_TERM_36_MONTHS,
COMMITMENT_TERM_60_MONTHS
​
customSshKeys
string[]
​
powerState
enum<string>
default:MACHINE_POWER_STATE_UNSPECIFIED
Available options:
MACHINE_POWER_STATE_UNSPECIFIED,
ON,
OFF,
POWERING_ON,
POWERING_OFF,
REBOOTING
​
priceHr
object

A representation of a decimal value, such as 2.5. Clients may convert values into language-native decimal formats, such as Java's BigDecimal or Python's decimal.Decimal.

​
sshKeySource
enum<string>
default:SSH_KEY_SOURCE_UNKNOWN
Available options:
SSH_KEY_SOURCE_UNKNOWN,
SSH_KEY_SOURCE_PROJECT,
SSH_KEY_SOURCE_USER,
SSH_KEY_SOURCE_NONE
​
startScript
string
​
state
enum<string>
default:STATE_UNSPECIFIED
Available options:
STATE_UNSPECIFIED,
CREATING,
ACTIVE,
DEPLOYING,
DELETING,
FAILED
​
userData
string

Response

A successful response.

​
dataCenterId
string
required
​
id
string
required
​
machineTypeId
string
required
​
os
string
required
​
projectId
string
required
​
architecture
string
​
commitmentTerm
enum<string>
default:COMMITMENT_TERM_NONE
Available options:
COMMITMENT_TERM_NONE,
COMMITMENT_TERM_1_MONTH,
COMMITMENT_TERM_3_MONTHS,
COMMITMENT_TERM_6_MONTHS,
COMMITMENT_TERM_12_MONTHS,
COMMITMENT_TERM_24_MONTHS,
COMMITMENT_TERM_36_MONTHS,
COMMITMENT_TERM_60_MONTHS
​
cpuCores
integer
​
cpuModel
string
​
cpuSpeedMhz
integer
​
createBy
string
​
createTime
string<date-time>
​
customSshKeys
string[]
​
diskSizeGib
integer
​
disks
integer
​
externalIpAddresses
string[]
​
gpuModelId
string
​
gpus
integer
​
hostname
string
​
memoryGib
integer
​
powerState
enum<string>
default:MACHINE_POWER_STATE_UNSPECIFIED
Available options:
MACHINE_POWER_STATE_UNSPECIFIED,
ON,
OFF,
POWERING_ON,
POWERING_OFF,
REBOOTING
​
priceHr
object

A representation of a decimal value, such as 2.5. Clients may convert values into language-native decimal formats, such as Java's BigDecimal or Python's decimal.Decimal.

​
sshKeySource
enum<string>
default:SSH_KEY_SOURCE_UNKNOWN
Available options:
SSH_KEY_SOURCE_UNKNOWN,
SSH_KEY_SOURCE_PROJECT,
SSH_KEY_SOURCE_USER,
SSH_KEY_SOURCE_NONE
​
startScript
string
​
state
enum<string>
default:STATE_UNSPECIFIED
Available options:
STATE_UNSPECIFIED,
CREATING,
ACTIVE,
DEPLOYING,
DELETING,
FAILED
​
userData
string