Purchase Azure reservations

Applies To

  • Partner Center
  • Partner Center for Microsoft Cloud for US Government

To purchase an Azure reservation using the Partner Center API, you must have one or more deployed Cloud Solution Provider (CSP) Azure subscriptions. If you do not have a CSP Azure subscription, use these basic steps to purchase one:

  • Get a list of offers for a market.
  • Create an order for an CSP Azure subscription.
  • Submit your order.
  • Make sure your order is fulfilled.

Note

Azure reservations are not available in the following markets:

Unavailable Markets    
Åland Islands Greenland Palau
American Samoa Grenada Papua New Guinea
Andorra Guadeloupe Pitcairn Islands
Anguilla Guam Reunion
Antarctica Guernsey Russian Federation
Antigua and Barbuda Guinea Saba
Aruba Guinea-Bissau Saint Barthélemy
Azerbaijan Guyana Saint Lucia
Belarus Haiti Saint Martin
Benin Heard Island and McDonald Islands Saint Pierre and Miquelon
Bhutan India Saint Vincent and the Grenadines
Bonaire Isle of Man Samoa
Bouvet Island Jan Mayen San Marino
Brazil Jersey São Tomé and Príncipe
British Indian Ocean Territory Kazakhstan Seychelles
British Virgin Islands Kiribati Sierra Leone
Burkina Faso Korea, Republic of Sint Eustatius
Burundi Kosovo Sint Maarten
Cambodia Laos Solomon Islands
Central African Republic Lesotho Somalia
Chad Liberia South Georgia and South Sandwich Islands
China Madagascar South Sudan
Christmas Island Malawi St Helena, Ascension, Tristan da Cunha
Cocos (Keeling) Islands Maldives Suriname
Comoros Mali Svalbard
Congo Marshall Islands Swaziland
Congo (DRC) Martinique Taiwan
Cook Islands Mauritania Timor-Leste
Djibouti Mayotte Togo
Dominica Micronesia Tokelau
Equatorial Guinea Montserrat Tonga
Eritrea Mozambique Turks and Caicos Islands
Falkland Islands Myanmar Tuvalu
French Guiana Nauru U.S. Outlying Islands
French Polynesia New Caledonia Ukraine
French Southern Territories Niger Vanuatu
Gabon Niue Vatican City
Gambia Norfolk Island Wallis and Futuna
Gibraltar Northern Mariana Islands Yemen

Prerequisites

  • Credentials as described in Partner Center authentication. This scenario supports authentication with both standalone App and App+User credentials.
  • A customer identifier. If you do not have a customer's ID, you can look up the ID in Partner Center by choosing the customer from the customers list, selecting Account, then saving their Microsoft ID.
  • A subscription ID for an active CSP Azure subscription.

How to purchase Microsoft Azure reservations

Once you have identified the active CSP Azure subscription that you want to add an Azure reservation to, use the following steps to purchase it:

  1. Enablement - Register an active CSP Azure subscription to enable it for purchasing Azure reservations.
  2. Discovery - Find and select the Azure reservation products and SKUs you want to purchase and check their availability.
  3. Order submission - Create a shopping cart with the items in your order and submit it.
  4. Get order details - Review the details of an order, all the orders for a customer, or view orders by billing cycle type.

After you have purchased Azure reservations, the following scenarios show you how to manage their lifecycle by getting information about your Azure reservation entitlements, and how to retrieve balance statements, invoices, and invoice summaries.

Enablement

Once you have identified the active subscription that you want to add the Azure reservation to, you must register the subscription so that it is enabled for Azure reservations. To register an existing Subscription resource so that it is enabled for ordering Azure reservations, see Register a subscription.

After registering your subscription, you should confirm that the registration process is completed by checking the registration status. To do this, see Get subscription registration status.

Discovery

Once the subscription is enabled for purchasing Azure reservations, you're ready to select products and SKUs and check their availability using the following Partner Center API models:

  • Product - A grouping construct for purchasable goods or services. A product by itself is not a purchasable item.​​
  • SKU - A purchasable Stock Keeping Unit (SKU) under a product. These represent the different shapes of the product.​​
  • Availability - A configuration in which a SKU is available for purchase (such as country, currency and industry segment).

Before purchasing an Azure reservation, complete the following steps:

  1. Identify and retrieve the Product and SKU that you want to purchase. You can do this by listing the products and SKUs first, or If you already know the IDs of the product and SKU, selecting them.

  2. Check the inventory for a SKU​. This step is only needed for SKUs that are tagged with an InventoryCheck prerequisite​.

  3. Retrieve the availability for the SKU. You will need the CatalogItemId of the availability when placing the order​. To get this value, use one of the following APIs:

Order submission

To submit your Azure reservation order, do the following:

  1. Create a cart to hold the collection of catalog items that you intend to buy. When you create a Cart, the cart line items are automatically grouped based on what can be purchased together in the same Order.

  2. Check out the cart. Checking out a cart results in the creation of an Order.

Get order details

Once you have created your Azure reservation order, you can retrieve the details of an individual order using the order ID, or get a list of orders for a customer. Note that there is a delay of up to 15 minutes between the time an order is submitted and when it will appear in a list of a customer's orders.​

Lifecycle management

As part of managing the lifecycle of your Azure reservations in Partner Center, you can retrieve information about your Azure reservation Entitlements, and get reservation details using the reservation order ID. For examples of how to do this, see Get entitlements. ​

Invoice and reconciliation

The following scenarios show you how to programmatically view your customer's invoices, and get your account balances and summaries that include one-time charges for Azure reservations.

Balance and payment​
To get current account balance in your default currency type that is a balance of ​both recurring and one-time (Azure reservation) charges, see Get your current account balance

Multi-currency balance and payment
To get your current account balance and a collection of invoice summaries containing an invoice summary with both recurring and one-time charges for each of your customer's currency types, see Get invoice summaries.

Invoices​
To get a collection of invoices that show both recurring and one time charges, see Get a collection of invoices. ​

Single Invoice​
To retrieve a specific invoice using the invoice ID, see Get an invoice by ID. ​

Reconciliation
To get a collection of invoice line item details (Reconciliation line items) for a specific invoice ID, see Get invoice line items. ​

Download an invoice as a PDF
To retrieve an invoice statement in PDF form using an invoice ID, see Get an invoice statement.