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
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:
{
"Name": "Azure subscirption name"
}
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. |