Reserved instance purchase recommendation APIs for enterprise customers

The Reserved Instance recommendations API looks at Customer's 7, 30 or 60 days virtual machine usage and offers Single and Shared Purchase recommendations.

Request for shared reserved instance recommendations

Common header properties that need to be added are specified here.

Method Request URI
GET https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/SharedReservationRecommendations?lookBackPeriod=7

Response

[{
	"lookBackPeriod": "Last7Days",
	"meterId": "2e3c2132-1398-43d2-ad45-1d77f6574933",
	"skuName": "Standard_DS1_v2",
	"term": "P1Y",
	"region": "westus",
	"costWithNoRI": 186.27634908960002,
	"recommendedQuantity": 9,
	"totalCostWithRI": 143.12931642978083,
	"netSavings": 43.147032659819189,
	"firstUsageDate": "2018-02-19T00:00:00"
}
]

Response property definitions

Property Name Type Description
lookBackPeriod string String representing number of past usage days. It can either last7days, last30days or last60days
meterId string The Meterid of the resource that should be purchased
skuName string This is the Azure Resource Manager SKU that needs to be purchased
term string P1Y for 1 year and P3Y for 3 years
region string Region where Reserved instance should be purchased
costWithNoRI string Total current cost
recommendedQuantity decimal Total Reserved Instance Quantity that should be purchased
totalCostWithRI decimal Total Cost if Recommended Quantity was purchased
netSavings decimal Net Savings within 7, 30 or 60 days
firstUsageDate decimal First time the Recommended VM was run.

Request for single reserved instance recommendations

Common header properties that need to be added are specified here.

Method Request URI
GET https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/SingleReservationRecommendations?lookBackPeriod=7

Response

[{
	"subscriptionId": "d143f4db-5a12-46b9-ba15-9bff298b8f45",
	"lookBackPeriod": "Last7Days",
	"meterId": "2e3c2132-1398-43d2-ad45-1d77f6574933",
	"skuName": "Standard_DS1_v2",
	"term": "P1Y",
	"region": "westus",
	"costWithNoRI": 186.27634908960002,
	"recommendedQuantity": 9,
	"totalCostWithRI": 143.12931642978083,
	"netSavings": 43.147032659819189,
	"firstUsageDate": "2018-02-19T00:00:00"
}
]

Response property definitions

Property Name Type Description
subscriptionId string SubscriptionId for which Reserved Instance should be purchased
lookBackPeriod string String representing number of past usage days. It can either last7days, last30days or last60days
meterId string The Meterid of the resource that should be purchased
skuName string This is the Azure Resource Manager SKU that needs to be purchased
term string P1Y for 1 year and P3Y for 3 years
region string Region where Reserved instance should be purchased
costWithNoRI string Total current cost
recommendedQuantity decimal Total Reserved Instance Quantity that should be purchased
totalCostWithRI decimal Total Cost if Recommended Quantity was purchased
netSavings decimal Net Savings within 7, 30 or 60 days
firstUsageDate decimal First time the Recommended VM was run.

See also