EMemma
Compute instances configurations

List of available configurations for virtual machine creation

When creating virtual machines you need to provide the desired hardware configurations. These configurations include CPU, CPU type, RAM, volume size, and volume type. Different cloud providers offer various configurations in different data centers. Therefore, before creating any compute instance, you need to verify the available configurations.

Use this endpoint as a reference for available configurations for virtual machines. You can search the available configurations by different parameters (provider, location, data center, cloud network type, CPU, CPU type, RAM, volume size, volume type, and price).

When you find an appropriate configuration, provide the hardware parameters in the endpoint for creating or editing a virtual machine.

get/v1/vms-configs

Request

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

Query parameters

acceleratorTypeIdstring

GPU accelerator type ID

acceleratorsMinnumber

Minimum quantity of GPU accelerators

acceleratorsMaxnumber

Maximum quantity of GPU accelerators

cloudNetworkType'isolated' | 'multi-cloud'
Example:multi-cloud

Type of cloud network

dataCenterIdstring
Example:aws-us-west-1

ID of the cloud provider's data center

locationIdinteger
Example:6

ID of the geographic location

priceMaxnumber

Maximum price of the compute instance

priceMinnumber

Minimum price of the compute instance

providerIdinteger
Example:5

ID of the cloud provider

ramGbinteger
Example:16

RAM of the compute instance in gigabytes

ramGbMaxinteger
Example:32

Maximum RAM of the compute instance in gigabytes

ramGbMininteger
Example:4

Minimum RAM of the compute instance in gigabytes

vCpuinteger
Example:4

virtual Central Processing Units (vCPUs) for the compute instance

vCpuMaxinteger
Example:8

Maximum number of vCPUs for the compute instance

vCpuMininteger
Example:2

Minimum number of vCPUs for the compute instance

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

Type of vCPUs for the compute instance

volumeGbinteger
Example:500

Volume size of the compute instance in gigabytes

volumeGbMaxinteger
Example:1000

Maximum volume size of the compute instance in gigabytes

volumeGbMininteger
Example:16

Minimum volume size of the compute instance in gigabytes

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

Volume type 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": 5,
      "providerName": "GCP",
      "locationId": 6,
      "locationName": "London",
      "dataCenterId": "aws-us-west-1",
      "dataCenterName": "europe-west2",
      "osId": 35,
      "osType": "Ubuntu",
      "osVersion": "18.04",
      "cloudNetworkTypes": [
        "default",
        "multi-cloud",
        "isolated"
      ],
      "vCpuType": "Standard",
      "vCpu": 4,
      "ramGb": 16,
      "volumeGb": 500,
      "volumeType": "ssd",
      "accelerator": {
        "acceleratorTypeId": "b3f5a4cb-4e3c-4c63-8c68-e1bd96b7ae1a",
        "acceleratorType": "NVIDIA A100",
        "accelerators": 4,
        "totalGpuMemoryGb": 320
      },
      "localDisks": {
        "disks": 2,
        "sizeTb": 25,
        "totalSizeTb": 50,
        "type": "ssd-plus"
      },
      "cost": {
        "unit": "MONTHS",
        "currency": "EUR",
        "pricePerUnit": 5.479952
      }
    }
  ]
}

Changes

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