Skip to main content

List Master Flavors

GET https://infrahub-api.nexgencloud.com/v1/core/clusters/master-flavors​

Retrieves the list of available CPU-only flavors supported for use as the master node in Kubernetes clusters. Master nodes host the Kubernetes control plane and must use CPU-only configurations. For guidance on selecting a master flavor for cluster deployment, see Select Master Node Flavor in the Kubernetes UI Deployment Guide.


Parameters​

No parameters required.


Attributes​

status boolean​

Indicates the status of the request to retrieve master node flavors. true indicates success, while false indicates error.

message string​

A message confirming the result of the request.

flavors array of objects​

An array of CPU-only flavor objects available for use as master nodes.

Show child attributes
id integer​

The unique identifier for the master node flavor.

name string​

The name of the flavor.

display_name string​

The display name of the flavor as shown in the Hyperstack UI.

region_name string​

The region where the flavor is available.

cpu integer​

The number of virtual CPU cores in the flavor.

ram number​

The amount of RAM (in gigabytes) in the flavor.

disk integer​

The root disk size (in gigabytes) for the flavor.

ephemeral null​

Ephemeral disk storage (not applicable for master flavors).

gpu string​

The GPU type. Empty string for CPU-only flavors.

gpu_count integer​

The number of GPUs. This is always 0 for master node flavors.

stock_available boolean​

Indicates whether the flavor is currently in stock. true means the flavor is available.

created_at date-time​

The timestamp when the flavor was added to the platform.

labels array​

A list of labels indicating flavor restrictions or traits.

Show child attributes
id integer​

The unique identifier of the label.

label string​

The label string (e.g., "no-snapshot", "no-hibernation").

features object​

An object describing technical capabilities and restrictions of the flavor.

Show child attributes
network_optimised boolean​

Indicates whether the flavor supports SR-IOV networking.

no_hibernation boolean​

Indicates whether the flavor supports hibernation. true means hibernation is not supported.

no_snapshot boolean​

Indicates whether the flavor supports snapshots. true means snapshotting is not supported.

local_storage_only boolean​

Indicates whether the flavor supports only local (non-networked) storage.


Example request
curl -X GET "https://infrahub-api.nexgencloud.com/v1/core/clusters/master-flavors" \
  -H "accept: application/json" \
  -H "api_key: YOUR API KEY"
Response
{
  "status": true,
  "message": "Flavors retrieved successfully",
  "flavors": [
    {
        "id": 1,
        "name": "n1-cpu-large",
        "display_name": null,
        "region_name": "NORWAY-1",
        "cpu": 16,
        "ram": 16.0,
        "disk": 200,
        "ephemeral": 0,
        "gpu": "",
        "gpu_count": 0,
        "created_at": "2023-05-08T06:22:40",
        "labels": [],
        "features": {
            "network_optimised": false,
            "no_hibernation": false,
            "no_snapshot": false,
            "local_storage_only": false
        }
    },
    {...}
  ]
}

Returns​

Returns a list of supported CPU-only flavors for Kubernetes master nodes, including all technical attributes, regional availability, and configuration restrictions. These can be used when deploying a cluster through the Hyperstack UI or API.


Back to top​