Create Azure Subscription (Entitlement)
=======================================

Create additional Azure Subscription (Entitlement) under the same Azure Plan.

Prerequisites
^^^^^^^^^^^^^

- An Azure Plan is a container for Azure Subscriptions. 

- When an Azure Plan is created (one per tenant), Microsoft automatically provisions a default Azure Subscription (also referred to as an Entitlement).

- Find a customer tenant that is connected to Azure Plan

   :doc:`/scenarios/customertenants-get`

- Find your azure plan id

*GET https://api.crayon.com/api/v1/customertenants/{customerTenantId}/azureplan/*

Limits
^^^^^^

- You can only have one Azure Plan per Customer Tenant.
- To create additional Azure Subscriptions under the same Azure Plan, clients need to explicitly request new subscriptions.
- This process is not automatic and requires an API call or manual action through the Partner Center.

Request
^^^^^^^

Request Syntax:

+---------+--------------------------------------------------------------------------------------------+
| Method  | Request URI                                                                                |
+=========+============================================================================================+
| POST    | *https://api.crayon.com/api/v1/azureplans/{azurePlanId}/azuresubscriptions/*               |
+---------+--------------------------------------------------------------------------------------------+

Request Example:

::

	POST $"https://api.crayon.com/api/v1/azureplans/{azurePlanId:int}/azuresubscriptions/"
	Accept: application/json
	Content-Type: application/json 
	Authorization: Bearer < Token >


Request Body:

.. literalinclude:: /resources/_static/CreateAzureSubscriptionRequest.json
		:language: json
	

Response
^^^^^^^^
If successful, this endpoint returns 202 Accepted HTTP status code.

Response success and error codes:

Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Use a network trace tool to read this code, error type, and additional parameters.

+--------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Error Codes                    | Description                                                                                                                                                                                                                                                                               |
+================================+===========================================================================================================================================================================================================================================================================================+
| 202 Accepted                   | The request has succeeded.                                                                                                                                                                                                                                                                |
+--------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| 500 Internal Server Error      | Azure Subscription creation failed. Indicates that a generic error has occurred on the server.                                                                                                                                                                                            |
+--------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| 401 Unauthorized               | The request requires user authentication. If the request already included Authorization credentials, then the 401 (Unauthorized) status code means that authorization has been refused for those credentials. It is a non-retryable error condition.                                      |
+--------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+