Get sizing recommendation for machine for Azure environment

get

https://api.controlup.com/historical/v1/machines/sizing_recommendation/azure

Returns sizing recommendations to optimize resource allocation for machines based on historical information. Visit the Sizing Recommendations Report documentation for more details.

Required permission: Sizing Recommendations

❗️
The built-in Try It! console can return incorrect values. This endpoint returns IDs that are automatically rounded and displayed incorrectly in the response body due to a Javascript limitation.

Use the console to build requests and test connectivity only.

To get accurate data, copy the request and run it in another tool.

Query Params

license

string

enum

required

Your license type for Microsoft Windows Virtual Machines. If you have Azure Hybrid Benefit, enter ‘Azure Hybrid Benefit’. If you purchase a new license for each machine, enter ‘OS (Windows)’.

Allowed:

azureRegion

string

required

The Azure region where you want to see representative costs. You must provide the name of the region as it appears in the report creation UI.

currency

string

enum

Defaults to USD

The currency used for all cost information in the report.

Allowed:

msEaDiscountRatePct

int32

0 to 100

Defaults to 0

The discount rate percentage due to a Microsoft Enterprise Agreement. If you don’t have a discount rate, enter 0.

acceleratedNetworking

string

enum

Defaults to Any

Select whether you require VMs with or without Accelerated Networking. Enter any if you have no preference.

Allowed:

memoryPreservingMaintenance

string

enum

Defaults to Any

Select whether you require VMs with or without Memory Preserving Maintenance. Enter any if you have no preference.

Allowed:

hyperVGeneration

string

enum

Defaults to Any

Select the required Hyper-V generation for VMs. Enter any if you have no preference.

Allowed:

cpuArchitectureType

string

enum

Defaults to Any

Select the required CPU architecture for VMs. Enter any if you have no preference.

Allowed:

vCPUsPerCore

string

enum

Select the required vCPUs per core for VMs. Enter any if you have no preference.

Allowed:

rdmaEnabled

string

enum

Defaults to Any

Select whether you require RDMA-capable VMs. Enter any if you have no preference.

Allowed:

premiumIO

string

enum

Defaults to Any

Select whether you require VMs with premium IO. Enter any if you have no preference.

Allowed:

encryptionAtHostSupport

string

enum

Defaults to Any

Select whether you require VMs with encryption at host. Enter any if you have no preference.

Allowed:

diskTier

string

enum

Defaults to Any

Select your required disk tier. Enter any if you have no preference.

Allowed:

redundancy

string

enum

Defaults to Any

Select your required disk redundancy option. Enter any if you have no preference.

Allowed:

minimumDiskSize

string

enum

Select your required minimum disk size in GB. Enter any if you have no preference.

costOption

string

enum

Defaults to PAYG

Your Azure cost option. Select from pay as you go (PAYG), spot machines (Spot), reserved instance for one a one-year term (RESERVED_ONE_YEAR), or reserved instance for a three-year term (`RESERVED_THREE_YEAR).

Allowed:

_page

int32

≥ 1

The page number returned. The first page is 1.

_limit

int32

1 to 100000

The number of items returned per page. Minimum is 1.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Successfully retrieved

400Bad Request - one of the inputs isn't correct

401User is not authorized to access the resource

403Authorization details are not provided

500Internal Server Error

501Internal Server Error

504Internal Server Error