Update Azure Subscription (Entitlement)

Returns single Azure Subscription (Entitlement) under the specific 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/

  • Azure Subscription (Entitlement) identifier

Request

Request Syntax:

Method

Request URI

PUT

https://api.crayon.com/api/v1/azureplans/{azurePlanId}/azuresubscriptions/{id}

Request Body:

Name

Type

Description

azure subscription (entitlement)

AzurePlanEntitlementForUpdate

The entitlement to update

Request Example:

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

Response

If successful, this method returns a AzurePlanEntitlement resource in the response body.

Response Body:

{
    "InvoiceProfile": null,
    "Id": 1,
    "AzurePlanId": 2222,
    "PublisherSubscriptionId": "00000000-0000-0000-0000-000000000000",
    "FriendlyName": "FriendlyName",
    "Status": "active",
    "Tags": null
}

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.

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.

404 Not Found

Azure subscription not found.

500 Internal Server Error

Azure Subscription update failed. Indicates that a generic error has occurred on the server.