Skip to main content
GET
/
v1
/
vms
/
data-centers
/
{dataCenterId}
/
machine_types
/
{machineTypeId}
Get a virtual machine type
curl --request GET \
  --url https://rest.compute.cudo.org/v1/vms/data-centers/{dataCenterId}/machine_types/{machineTypeId} \
  --header 'Authorization: <api-key>'
{
  "cpuModel": "<string>",
  "dataCenterId": "<string>",
  "gpuModel": "<string>",
  "gpuModelId": "<string>",
  "gpuPriceHr": {
    "value": "<string>"
  },
  "ipv4PriceHr": {
    "value": "<string>"
  },
  "machineType": "<string>",
  "maxGpuFree": 123,
  "maxMemoryGibFree": 123,
  "maxStorageGibFree": 123,
  "maxVcpuFree": 123,
  "maxVcpuPerGpu": 123,
  "maxVcpuPerMemoryGib": 123,
  "memoryGibPriceHr": {
    "value": "<string>"
  },
  "minMemoryGib": 123,
  "minStorageGibPriceHr": {
    "value": "<string>"
  },
  "minVcpu": 123,
  "minVcpuPerGpu": 123,
  "minVcpuPerMemoryGib": 123,
  "prices": [
    {
      "commitmentTerm": "COMMITMENT_TERM_NONE",
      "gpuPriceHr": {
        "value": "<string>"
      },
      "memoryGibPriceHr": {
        "value": "<string>"
      },
      "vcpuPriceHr": {
        "value": "<string>"
      }
    }
  ],
  "renewableEnergy": true,
  "totalGpuFree": 123,
  "totalMemoryGibFree": 123,
  "totalStorageGibFree": 123,
  "totalVcpuFree": 123,
  "vcpuPriceHr": {
    "value": "<string>"
  }
}

Authorizations

Authorization
string
header
required

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

Path Parameters

dataCenterId
string
required
machineTypeId
string
required

Query Parameters

projectId
string

Return custom prices for a specific project.

Response

A successful response.

cpuModel
string
required
dataCenterId
string
required
gpuModel
string
required
gpuModelId
string
required
gpuPriceHr
object
required

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.

ipv4PriceHr
object
required

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.

machineType
string
required
maxGpuFree
integer
required
maxMemoryGibFree
integer
required
maxStorageGibFree
integer
required
maxVcpuFree
integer
required
maxVcpuPerGpu
number
required
maxVcpuPerMemoryGib
number
required
memoryGibPriceHr
object
required

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.

minMemoryGib
number
required
minStorageGibPriceHr
object
required

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.

minVcpu
number
required
minVcpuPerGpu
number
required
minVcpuPerMemoryGib
number
required
prices
object[]
required
renewableEnergy
boolean
required
totalGpuFree
integer
required
totalMemoryGibFree
integer
required
totalStorageGibFree
integer
required
totalVcpuFree
integer
required
vcpuPriceHr
object
required

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.