EMemma
Compute instances configurations

List of available configurations for Kubernetes cluster node

Returns the list of available hardware configurations that can be used for Kubernetes cluster worker nodes.

Each configuration defines the compute resources available for a node, including:

  • CPU count
  • CPU type
  • RAM size
  • system disk size
  • system disk type
  • optional GPU configuration

Available configurations depend on the cloud provider and data center. Therefore, they must be retrieved before creating or updating a Kubernetes cluster.

This endpoint allows searching and filtering configurations using parameters listed in the Parameters section.

The selected configuration should be used when calling the Kubernetes cluster creation or cluster update endpoints, where these parameters define the specification of worker nodes.

get/v1/kubernetes-configs

Request

  • Base URL
    https://api.emma.ms/external
  • Auth
    HTTP bearer

Query parameters

providerIdinteger
Example:5

ID of the cloud provider

locationIdinteger
Example:6

ID of the geographic location

acceleratorTypeIdstring

GPU accelerator type ID

acceleratorsMinnumber

Minimum quantity of GPU accelerators

acceleratorsMaxnumber

Maximum quantity of GPU accelerators

k8sConnectionType'direct_connect' | 'internet_connect' required
Example:internet_connect

Type of Kubernetes cluster network connectivity

dataCenterIdstring
Example:aws-us-west-1

ID of the cloud provider's data center

vCpuType'shared' | 'standard' | 'hpc'
Example:standard

Type of vCPUs for the compute instance

vCpuinteger
Example:4

virtual Central Processing Units (vCPUs) for the compute instance

vCpuMininteger
Example:2

Minimum number of vCPUs for the compute instance

vCpuMaxinteger
Example:8

Maximum number of vCPUs for the compute instance

ramGbinteger
Example:16

RAM of the compute instance in gigabytes

ramGbMininteger
Example:4

Minimum RAM of the compute instance in gigabytes

ramGbMaxinteger
Example:32

Maximum RAM of the compute instance in gigabytes

volumeGbinteger
Example:500

Volume size of the compute instance in gigabytes

volumeGbMininteger
Example:16

Minimum volume size of the compute instance in gigabytes

volumeGbMaxinteger
Example:1000

Maximum volume size of the compute instance in gigabytes

volumeType'ssd' | 'ssd-plus'
Example:ssd

Volume type of the compute instance

priceMinnumber

Minimum price of the compute instance

priceMaxnumber

Maximum price of the compute instance

pageinteger

Page number

sizeinteger
Example:100

Query size

projectIdinteger

Unused, created for future API extention. Will be ignored if used.

Response

Successful operation

totalPagesinteger

Total number of pages available

totalElementsinteger

Total number of elements across all pages

sizeinteger

Number of elements per page

numberinteger

Current page number (0-based index)

lastboolean

Indicates if this is the last page

firstboolean

Indicates if this is the first page

numberOfElementsinteger

Number of elements on the current page

emptyboolean

Indicates if the page is empty

Example response

{
  "content": [
    {
      "id": "0935c792-a45b-46bb-b42d-4d47956ea1ae",
      "providerId": 79,
      "providerName": "AWS",
      "locationId": 6,
      "locationName": "EU (London)",
      "dataCenterId": "aws-eu-west-2",
      "dataCenterName": "EU (London)",
      "osId": 48,
      "osType": "Ubuntu",
      "osVersion": "24.04",
      "cloudNetworkTypes": [
        "default"
      ],
      "vCpuType": "hpc",
      "vCpu": 4,
      "ramGb": 16,
      "volumeGb": 128,
      "volumeType": "ssd",
      "accelerator": {
        "acceleratorTypeId": "53b7db26-4a1b-42f7-97a5-592edd685c5a",
        "acceleratorType": "NVIDIA T4",
        "accelerators": 1,
        "totalGpuMemoryGb": 16
      },
      "localDisks": {
        "disks": 1,
        "sizeTb": 0.125,
        "totalSizeTb": 0.125,
        "type": "ssd-plus"
      },
      "cost": {
        "unit": "MONTHS",
        "currency": "EUR",
        "pricePerUnit": 399.089287
      }
    }
  ]
}

Changes

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