Sign in

v1

latestOpenAPI 3.1.02026-07-2676123203.9 KB
Catalog

Get a CPU type

Returns a single CPU type with pricing. Availability details are included only when requested with include=AVAILABILITY.

get/v2/catalog/cpus/{id}

Query parameters

includeCatalogInclude[]

Comma-separated optional expansions. Supported value today: AVAILABILITY. This may expand with more include values in the future.

productCpuProduct[]

Comma-separated availability product context. Valid only with include=AVAILABILITY. Supported values for CPUs: POD, SERVERLESS. Defaults to POD when omitted.

[
  "POD",
  "SERVERLESS"
]
vcpuCountinteger

Availability vCPU count. Valid only with include=AVAILABILITY. Must be a power of two.

Response

OK

idstring required

CPU flavor identifier (use in cpu.id for pod creation)

namestring required

Human-readable flavor name

groupstring required

CPU generation group

ramGbPerVcpunumber float required

GB of RAM allocated per vCPU. Multiply by the chosen vCPU count (within vcpu.min..vcpu.max) to get the total RAM for an instance of this flavor. May be fractional.

availability'NONE' | 'LOW' | 'MEDIUM' | 'HIGH'

Catalog stock availability level.

Example response

{
  "id": "cpu5c",
  "name": "Compute-Optimized",
  "group": "Gen 5",
  "vcpu": {
    "min": 2,
    "max": 32
  },
  "ramGbPerVcpu": 2.5,
  "price": {
    "securePerVcpu": 0.04,
    "serverlessPerVcpu": 0.03
  },
  "dataCenters": [
    {
      "id": "US-CA-2",
      "name": "US California 2"
    }
  ]
}