Subscription resources

Applies To

  • Partner Center
  • Partner Center operated by 21Vianet
  • Partner Center for Microsoft Cloud Germany
  • Partner Center for Microsoft Cloud for US Government

A subscription lets a customer use a service for a certain period of time. Not all fields will apply to all subscriptions, and many only apply at certain points in the life cycle, such as if a subscription is suspended or cancelled.

Note

The Subscription resource has a rate limit of 500 requests per minute per tenant identifier.

Subscription

Represents the life cycle of a subscription and includes properties that define the states throughout the subscription life cycle.

Property Type Description
id string The subscription identifier.
offerId string The offer identifier.
entitlementId string The entitlement identifier (an Azure subscription ID).
offerName string The offer name.
friendlyName string The friendly name for the subscription defined by the partner to help disambiguate.
quantity number Read-only. The quantity. For example, in case of license-based billing, this property is set to the license count.
unitType string The units defining quantity for the subscription.
parentSubscriptionId string Gets or sets the parent subscription identifier.
creationDate string Gets or sets the creation date, in date-time format.
effectiveStartDate string in UTC date time format Gets or sets the effective start date for this subscription, in date-time format. It is used to back date a migrated subscription or to align it with another.
commitmentEndDate string in UTC date time format The commitment end date for this subscription, in date-time format. For subscriptions which are not auto-renewable, this represents a date far, far away in the future.
status string The subscription status: "none", "active", "suspended", or "deleted".
autoRenewEnabled boolean Gets a value indicating whether the subscription is renewed automatically.
billingType string Specifies how the subscription is billed: "none", "usage", or "license".
billingCycle string Indicates the frequency with which the partner is billed for this order. Supported values are the member names found in BillingCycleType.
hasPurchasableAddons boolean Gets or sets a value indicating whether the subscription has purchasable add-ons.
isTrial boolean A value indicating whether this is a trial subscription.
actions array of strings Gets or sets the actions that are allowed. Possible values: "edit", "cancel"
partnerId string The MPN ID of the reseller of record, used in the indirect partner model.
suspensionReasons array of strings Read-only. If the subscription was suspended, indicates why.
contractType string Read-only. The type of contract: "subscription", "productKey", or "redemptionCode".
links SubscriptionLinks Gets or sets the subscription links.
orderId string The ID of the order that was placed to begin the subscription.
attributes ResourceAttributes The metadata attributes corresponding to the subscription.

Describes the collection of links attached to a subscription resource.

Property Type Description
offer Link Gets or sets the offer.
parentSubscription Link Gets or sets the parent subscription.
self Link The self URI.
next Link The next page of items.
previous Link The previous page of items.

SubscriptionProvisioningStatus

Provides information about the provisioning status of a subscription.

Property Type Description
skuId string A GUID formatted string that identifies the product SKU.
status string Indicates the provisioning status: "success", "pending" or "failed".
quantity number Provides the subscription quantity after provisioning.
endDate string in UTC date time format The end date of the subscription.
attributes ResourceAttributes The metadata attributes.

SubscriptionRegistrationStatus

Describes the collection of links attached to a subscription resource.

Property Type Description
subscriptionId string The subscription identifier.
status string Indicates the registration status: "registered", "registering" or "notregistered".

SupportContact

Represents a support contact for a customer's subscription.

Property Type Description
supportTenantId string A GUID formatted string that indicates the support contact's tenant identifier.
supportMpnId string The contact's Microsoft Partner Network (MPN) identifier.
name string The name of the support contact.
links ResourceLinks The support contact related links.
attributes ResourceAttributes The metadata attributes. Contains "objectType": " SupportContact".

RegisterSubscription

Returns a link that can be used to query the registration status of a subscription. The registration status is returned in the response body of a successfully accepted request to register an Azure subscription.

Property Type Description
httpResponseMessage object Returns HTTP Status Code 202 "Accepted", with a Location header containing a link to query the registration status. Example, "/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus"