Virtual Machine Types

API reference for Virtual Machine Types on CUDO Compute.

Reference
GET
/v1/data-centers/{dataCenterId}/virtual-machine-types

List virtual machine types for a data center

Path attributes

  • Name
    dataCenterId
    Type
    string
    Description
Request
GET
/v1/data-centers/{dataCenterId}/virtual-machine-types
    
    curl 'https://rest.compute.cudo.org/v1/data-centers/{dataCenterId}/virtual-machine-types' \
-H 'Authorization: bearer <YOUR-API-KEY>'\
-H 'Accept: application/json'
Response
    
    {
  "virtualMachineTypes": [
    {
      "virtualMachineType": "string",
      "countClusters": "integer",
      "countHosts": "integer",
      "countHostsActive": "integer",
      "countHostsInactive": "integer"
    }
  ]
}
GET
/v1/data-centers/{dataCenterId}/virtual-machine-types/{virtualMachineType}

Get a virtual machine type in a data center

Path attributes

  • Name
    dataCenterId
    Type
    string
    Description
  • Name
    virtualMachineType
    Type
    string
    Description
Request
GET
/v1/data-centers/{dataCenterId}/virtual-machine-types/{virtualMachineType}
    
    curl 'https://rest.compute.cudo.org/v1/data-centers/{dataCenterId}/virtual-machine-types/{virtualMachineType}' \
-H 'Authorization: bearer <YOUR-API-KEY>'\
-H 'Accept: application/json'
Response
    
    {
  "dataCenterId": "string",
  "virtualMachineType": "string",
  "cpuModels": [
    "string"
  ],
  "gpuModels": [
    "string"
  ],
  "minVcpuPriceHr": {
    "value": "string"
  },
  "maxVcpuPriceHr": {
    "value": "string"
  },
  "minMemoryGibPriceHr": {
    "value": "string"
  },
  "maxMemoryGibPriceHr": {
    "value": "string"
  },
  "minGpuPriceHr": {
    "value": "string"
  },
  "maxGpuPriceHr": {
    "value": "string"
  },
  "minVcpuPerMemoryGib": "number",
  "maxVcpuPerMemoryGib": "number",
  "minVcpuPerGpu": "number",
  "maxVcpuPerGpu": "number",
  "countClusters": "integer",
  "countHosts": "integer",
  "countHostsActive": "integer",
  "countHostsInactive": "integer",
  "minVcpu": "number",
  "minMemoryGib": "number"
}
GET
/v1/data-centers/{dataCenterId}/virtual-machine-types/{virtualMachineType}/live-utilization

Get the utilization for a virtual machine type in a data center

Path attributes

  • Name
    dataCenterId
    Type
    string
    Description
  • Name
    virtualMachineType
    Type
    string
    Description
Request
GET
/v1/data-centers/{dataCenterId}/virtual-machine-types/{virtualMachineType}/live-utilization
    
    curl 'https://rest.compute.cudo.org/v1/data-centers/{dataCenterId}/virtual-machine-types/{virtualMachineType}/live-utilization' \
-H 'Authorization: bearer <YOUR-API-KEY>'\
-H 'Accept: application/json'
Response
    
    {
  "utilization": "number",
  "vcpuUsed": "integer",
  "vcpuFree": "integer",
  "vcpuTotal": "integer",
  "cpuUtilization": "number",
  "memoryGibUsed": "integer",
  "memoryGibFree": "integer",
  "memoryGibTotal": "integer",
  "memoryUtilization": "number",
  "gpuUsed": "integer",
  "gpuFree": "integer",
  "gpuTotal": "integer",
  "gpuUtilization": "number"
}
API referenceUser
API referenceVirtual Machines