Subscription Statuses and Associated Plans
The get operation applied to subscriptions returns their lock and sync statuses if the operation packet contains the subscriptions node. In addition, such requests will return plans and add-ons associated with each subscription. The subscriptions node that stores all these details is specified by complex type SubscriptionsList (
plesk_domain.xsd). This type is structured as follows:
- The subscription node is optional. It nests the data about statuses and the plans. Data type: none.
- The locked node is required. It holds the subscription lock status. In other words, it tells whether a subscription is not updated on associated service plan updates. Data type: string.
- The synchronized node is required. It specified whether a subscription is synced with the Panel components (for example, Business Manager). Data type: string.
- The plan-guid node is optional. It specifies the GUID of an add-on plan that will be added to the subscription. Data type: string.
- The plan-external-id node is optional. It specifies the ID of a service plan in the Panel components (for example, Business Manager). Data type: string.
The following snippet illustrates how this structure appears in packets:
<subscriptions> <subscription> <locked>false</locked> <synchronized>true</synchronized> <plan> <plan-guid>b9808ead-875a-c30f-d9bf-eb03ad12c89c</plan-guid> </plan> <plan> <plan-guid>f42428e7-9078-5ed8-50de-fd5ecfb5ecc6</plan-guid> </plan> </subscription> </subscriptions>