Get a virtual machine type

Retrieves the details of a virtual machine type.

GET /v1/vms/data-centers/{dataCenterId}/machine_types/{machineTypeId}

Get a virtual machine type

cURL

curl --request GET \
  --url https://rest.compute.cudo.org/v1/vms/data-centers/{dataCenterId}/machine_types/{machineTypeId} \
  --header 'Authorization: <api-key>'

200

{
  "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

API key authentication. API keys should be passed using the format Bearer API_KEY.

Path Parameters

dataCenterId · string · required

machineTypeId · string · required

Query Parameters

projectId · string

Return custom prices for a specific project.

Response

200

application/json

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.

Show child attributes

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.

Show child attributes

machineType · string · required

maxGpuFree · integer<int32> · required

maxMemoryGibFree · integer<int32> · required

maxStorageGibFree · integer<int32> · required

maxVcpuFree · integer<int32> · required

maxVcpuPerGpu · number<double> · required

maxVcpuPerMemoryGib · number<double> · 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.

Show child attributes

minMemoryGib · number<double> · 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.

Show child attributes

minVcpu · number<double> · required

minVcpuPerGpu · number<double> · required

minVcpuPerMemoryGib · number<double> · required

prices · object[] · required

Show child attributes

renewableEnergy · boolean · required

totalGpuFree · integer<int32> · required

totalMemoryGibFree · integer<int32> · required

totalStorageGibFree · integer<int32> · required

totalVcpuFree · integer<int32> · 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.

Show child attributes