---
title: "List of available configurations for virtual machine resize"
method: GET
path: "/v1/vms-resize-configs"
tags: ["Compute instances configurations"]
---

# List of available configurations for virtual machine resize

`GET /v1/vms-resize-configs`

## Request

- Base URL: `https://api.emma.ms/external`
- URL: `https://api.emma.ms/external/v1/vms-resize-configs`
- Auth: HTTP bearer

Virtual machines configurations are limited by provider-specific options, which differ across data centers. To resize or modify a compute instance, verify the list of supported configurations for your VM to avoid incompatible changes.

Use this endpoint as a reference for available configurations for a virtual machine resize. 
You can search the available configurations by different parameters (virtual machine id, CPU, CPU type, RAM, and price).

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

**Note:** To retrieve available configurations for DigitalOcean virtual machines, use the `GET v1/vms-configs` method

## Query parameters

- `vmId` integer
- `vCpuType` 'shared' | 'standard' | 'hpc'
- `vCpu` integer
- `vCpuMin` integer
- `vCpuMax` integer
- `ramGb` integer
- `ramGbMin` integer
- `ramGbMax` integer
- `priceMin` number
- `priceMax` number
- `page` integer
- `size` integer
- `projectId` integer

## Response `200`

Successful operation

- object
  - `totalPages` integer: Total number of pages available
  - `totalElements` integer: Total number of elements across all pages
  - `size` integer: Number of elements per page
  - `content` VmResizeConfiguration[]: List of elements on the current page
    - `vCpuType` string: Type of virtual Central Processing Units (vCPUs)
    - `vCpu` integer: Number of virtual Central Processing Units (vCPUs)
    - `ramGb` integer: Capacity of the RAM in gigabytes
    - `providerComputeType` string: Provider-specific compute type identifier
    - `accelerator` object: GPU accelerator
      - `acceleratorTypeId` string: Accelerator type ID
      - `acceleratorType` string: GPU accelerator type
      - `accelerators` number: Quantity of GPU accelerators
      - `totalGpuMemoryGb` integer: Total GPU memory (GB)
    - `cost` object: Cost of the configuration
      - `unit` string: Cost period
      - `currency` string: Currency of the cost
      - `pricePerUnit` number: Cost for the period
  - `number` integer: Current page number (0-based index)
  - `sort` SortObject: Sorting criteria for the elements
    - `empty` boolean: Indicates if the sorting criteria is empty
    - `unsorted` boolean: Indicates if the elements are unsorted
    - `sorted` boolean: Indicates if the elements are sorted
  - `last` boolean: Indicates if this is the last page
  - `first` boolean: Indicates if this is the first page
  - `numberOfElements` integer: Number of elements on the current page
  - `pageable` PageableObject: Pageable object containing pagination information
    - `offset` integer: Offset of the first element on the page
    - `sort` SortObject: Sorting criteria for the elements
      - `empty` boolean: Indicates if the sorting criteria is empty
      - `unsorted` boolean: Indicates if the elements are unsorted
      - `sorted` boolean: Indicates if the elements are sorted
    - `pageSize` integer: Number of elements per page
    - `pageNumber` integer: Current page number (0-based index)
    - `paged` boolean: Indicates if pagination is applied
    - `unpaged` boolean: Indicates if pagination is not applied
  - `empty` boolean: Indicates if the page is empty

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden - Access is denied
- `500`: Internal server error

---

[API](https://skmtc.dev/emma/apis/public-emma-api.md) - [All operations](https://skmtc.dev/emma/apis/public-emma-api/llms.txt) - [OpenAPI document](https://skmtc.dev/emma/apis/public-emma-api/revisions/9e55f0920078?raw)