Create an Azure plan

You can purchase, create, and manage an Azure plan using the Partner Center APIs. The process is similar to creating a Microsoft Azure (MS-AZR-0145P) subscription. You must get the catalog item for the Azure plan, then create and submit an order.

Prerequisites

• Partner Center authentication credentials. This scenario supports authentication with both standalone App and App+User credentials.
• The customer identifier. If you don't have a customer's identifier, follow the steps in Get a list of customers. Alternatively, sign in to Partner Center, choose the customer from the list of customers, select Account, then save their Microsoft ID.
• Confirmation of the customer's acceptance of the Microsoft Customer Agreement.

Get the catalog item for Azure plan

Before you can create an Azure plan for a customer, you need to retrieve the corresponding catalog item. You can retrieve the catalog item using the existing Partner Center catalog APIs with the following resource models.

• Product: A grouping construct for purchasable goods or services. A product itself isn't a purchasable item.
• SKU: A purchasable Stock Keeping Unit (SKU) under a product. SKUs represent the different shapes of the product.
• Availability: A configuration in which a SKU is available for purchase (such as country/region, currency, or industry segment).

To obtain the catalog item for an Azure plan, complete the following steps:

1. Identify and retrieve the product identifier for the Azure plan. Follow the steps in Get a list of products and specify the targetView as MicrosoftAzure. (If you already know the product identifier for the Azure plan, you can follow the steps in Get a product using the product ID instead.)

2. Retrieve the SKU from the product for the Azure plan. Follow the steps in Get a list of SKUs for a product. If you already know the SKU identifier for the Azure plan, you can follow the steps in Get a SKU using the SKU ID instead.

3. Retrieve the availability from the SKU for the Azure plan. Follow the steps in Get a list of availabilities for a SKU. If you already know the identifier for the availability you need, you can follow the steps in Get an availability using the availability ID instead. Be sure to note the value of the CatalogItemId property of the availability for the Azure plan. You will need this value to create an order.

Create and submit an order

To submit your order for an Azure plan, follow these steps:

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. (You can also update a cart.)

2. Check out the cart, which results in the creation of an order.

Get order details

You can retrieve the details of an individual order using the order ID. You can also retrieve a list of all orders for a specific customer.

Note

After an order is submitted, there is a delay of up to 15 minutes before the order appears in that customer's order list.

Manage Azure plans

After the order is successfully processed, a Partner Center Subscription resource will be created for the Azure plan. You can use the following methods for managing Partner Center Subscription resources to manage the Azure plan:

• Get a customer's subscriptions
• Get a list of subscriptions by order

When an Azure plan is created in Partner Center, a corresponding Azure usage subscription is also created in Azure. You can also create additional Azure usage subscriptions under the same Azure plan using Azure portal and Azure APIs. You can obtain the identifiers of all the Azure usage subscriptions associated with an Azure plan by following the steps in Get a list of Azure entitlements for Partner Center subscription

Lifecycle management

You can suspend an existing Azure plan by following the steps in Suspend a subscription.

You can only suspend an existing Azure plan if it no longer has any active usage assets associated with it, including Azure usage subscriptions and Azure reservations.

For details on how to disable Azure usage subscriptions, see Azure API on subscription lifecycle management.

To remove existing Azure reservations, you must cancel the reservations. After you suspend an Azure plan, you can reactivate it.

For details on how to reactivate an Azure plan, see Reactivate a suspended subscription

Transition existing CSP offers to Azure plan

You can't create an Azure plan for an existing customer with a Microsoft Azure (MS-AZR-0145P) subscription. However, you can transition a customer from their existing CSP Azure offers to Azure services under the Azure plan in the new commerce experience in the CSP program from within Partner Center. To transition an existing customer, use the product upgrade APIs to follow these steps:

• Check whether the customer is eligible for a transition to Azure plan
• Initiate a product upgrade for the customer
• Check the status of a product upgrade

Azure spending

You can track Azure spending by querying for usage summary and detailed usage records using the following methods:

• Get partner usage summary
• Get all customer usage records for a partner
• Get customer usage summary
• Get all subscription usage records for a customer
• Get subscription usage summary
• Get usage data for subscription by resource
• Get usage data for subscription by meter
• Get meter usage record resources
• Get resource usage record resources

You can also set and manage customer usage budget using the following methods:

• Get customer usage budget
• Update customer usage budget

Invoice and reconciliation

You can manage invoices and reconciliation data using the following methods:

• Get a collection of invoices
• Get invoice estimate links
• Get invoice by ID
• Get invoice statement
• Get invoice summaries
• Get invoice billed consumption line items
• Get invoice unbilled consumption line items
• Get invoice billed recon line items
• Get invoice unbilled recon line items