Subscription - Create Csp Subscription

The operation to create a new CSP subscription.

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}/providers/Microsoft.Subscription/createSubscription?api-version=2020-01-01

URI Parameters

Name In Required Type Description
billingAccountName
path True

string

The name of the Microsoft Customer Agreement billing account for which you want to create the subscription.

customerName
path True

string

The name of the customer.

api-version
query True

string

Version of the API to be used with the client request. Current version is 2020-01-01

Request Body

Name Required Type Description
displayName True

string

The friendly name of the subscription.

skuId True

string

The SKU ID of the Azure plan. Azure plan determines the pricing and service-level agreement of the subscription. Use 001 for Microsoft Azure Plan and 002 for Microsoft Azure Plan for DevTest.

resellerId

string

Reseller ID, basically MPN Id.

Responses

Name Type Description
200 OK

SubscriptionCreationResult

Normal response for a successful query. The response body will contain the data that matches the filters specified in the query parameters.

202 Accepted

Accepted. Subscription creation is in progress.

Headers

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Error response describing why the operation failed.

Security

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation impersonate your user account

Examples

createSubscription

Sample Request

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/2bc54a6f-8d8a-5be1-5bff-bb4f285f512b:11a72812-d9a4-446e-9a1e-70c8bcadf5c0_2019-05-31/customers/e33ba30d-3718-4b15-bfaa-5627a57cda6f/providers/Microsoft.Subscription/createSubscription?api-version=2020-01-01

{
  "displayName": "Contoso MCA subscription",
  "skuId": "0001"
}

Sample Response

Location: https://management.azure.com/providers/Microsoft.Subscription/subscriptionOperations/MzcwYzI3MDItNjA1MC00NTZkLTgyMTgtZjM0NDcyMjkwMTY0?api-version=2019-10-01-preview
Retry-After: 8
{
  "subscriptionLink": "/subscriptions/d0d6ee57-6530-4fca-93a6-b755a070be35"
}

Definitions

Name Description
ErrorResponse

Describes the format of Error response.

ModernCspSubscriptionCreationParameters

The parameters required to create a new CSP subscription.

SubscriptionCreationResult

The created subscription object.

ErrorResponse

Describes the format of Error response.

Name Type Description
code

string

Error code

message

string

Error message indicating why the operation failed.

ModernCspSubscriptionCreationParameters

The parameters required to create a new CSP subscription.

Name Type Description
displayName

string

The friendly name of the subscription.

resellerId

string

Reseller ID, basically MPN Id.

skuId

string

The SKU ID of the Azure plan. Azure plan determines the pricing and service-level agreement of the subscription. Use 001 for Microsoft Azure Plan and 002 for Microsoft Azure Plan for DevTest.

SubscriptionCreationResult

The created subscription object.

Name Type Description
subscriptionLink

string

The link to the new subscription. Use this link to check the status of subscription creation operation.