Templates

List sizes

The named sizes a computer can be launched at — each is a template plus a CPU/RAM/disk shape. These are the shapes hosts keep pre-booted, so a create that names one is typically answered from the warm pool in about a second; a custom shape boots cold in ten or so. Pass one as size on POST /computers. The catalogue is not a constraint: sending explicit cpu/ram_mb/disk_gb instead remains allowed, and a resize can take a computer anywhere your plan permits afterwards.

Requires the viewer role or higher.

get/sizes

Request

  • Base URL: https://app.mandala.computer/api/v1
  • URL: https://app.mandala.computer/api/v1/sizes
  • Auth: HTTP bearer

Response

The catalogue, with what your plan admits.

idstring

What to pass as size on POST /computers.

labelstring

Human-readable name.

templatestring

The template this row builds — it comes with the size, so do not send template alongside.

cpuinteger
ram_mbinteger
disk_gbinteger
allowedboolean

Whether your plan’s per-computer ceilings admit this size. What the account already holds is not counted here — a create can still be refused against the plan’s pools, with the refusal naming the pool.

cheapest_planstring nullable

The id of the cheapest plan whose ceilings admit this size — the plan to name when allowed is false. Null if no purchasable plan admits it.

Changes

No recorded changes to this operation across all 1 revision of this API.