Skip to main content
GET
List instance flavors

Authorizations

Authorization
string
header
required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234_abcdef

Path Parameters

project_id
integer
required

Project ID.

Example:

1

Query Parameters

architectures
enum<string>[]

Filter by flavor architecture type(s).

Available options:
aarch64,
unknown,
x86_64
available
boolean

Set to true to return only the available flavors. Set to false to return only the flavors that are disabled in their region or out of stock there. Omit it to return all flavors.

compatible_with_boot_volume_id
string<uuid4>

Return only the flavors that can boot from this volume, from its image metadata. An unknown volume matches no flavor. A non-bootable volume or one without image metadata is a 400. At most one compatible_with_* parameter per request.

compatible_with_image_id
string<uuid4>

Return only the flavors that can boot this image: its region, OS type and CPU architecture. An unknown image matches no flavor. At most one compatible_with_* parameter per request.

compatible_with_snapshot_id
string<uuid4>

Return only the flavors that can boot from this snapshot, resolved through its parent volume's image metadata. An unknown snapshot matches no flavor. A parent volume with no image metadata is a 400. At most one compatible_with_* parameter per request.

limit
integer
default:100

Max items to return.

Required range: x <= 1000
name
StringFilter · object

Operator flavor name filter, e.g. name[prefix]=g2-.

offset
integer
default:0

Items to skip.

Required range: x >= 0
order_by
enum<string>
default:name.asc

Sort field and direction.

Available options:
name.asc,
name.desc,
ram_mib.asc,
ram_mib.desc,
region_id.asc,
region_id.desc,
vcpus.asc,
vcpus.desc
os_types
enum<string>[]

Filter by flavor operating system(s).

Available options:
linux,
unknown,
windows
ram_mib
IntRangeFilter · object

Range filter on RAM size in MiB.

region_ids
integer[]

Filter by region ID(s). Omit = all regions.

vcpus
IntRangeFilter · object

Range filter on virtual CPU count.

Response

Instance flavors

count
integer
required

Number of objects

Required range: x >= 0
Example:

1

results
GlobalInstanceFlavorSerializer · object[]
required

Objects