| ISubscriptionManagerTransferSubscriptions Method |
[This is preliminary documentation and is subject to change.]
Executes a subscription transfer from customers to another customer for one or more subscriptions.
Namespace: Netadmin.Management.Provisioning
Assembly: Netadmin.Management.Interfaces (in Netadmin.Management.Interfaces.dll) Version: release/9.0@131b654fe7332b0776120c2b44d96c6cac5ac9a2
Syntaxvoid TransferSubscriptions( IReadOnlyDictionary<long, IReadOnlyCollection<long>> customersAndSubscriptionIds )
Parameters
- customersAndSubscriptionIds
- Type: System.Collections.GenericIReadOnlyDictionaryInt64, IReadOnlyCollectionInt64
A dictionary with the target customer as key and all subscriptions to transfer as value
Exceptions| Exception | Condition |
|---|---|
| ArgumentNullException | Thrown if subscriptionIds is null |
| ArgumentException | Thrown if a subscriptionId is present for multiple customers |
| InvalidIdentifierException | Thrown if any subscriptionId or customerId is zero or less |
| ObjectNotFoundException | Thrown if any subscription or the customer does not exist |
| InvalidOperationException | Thrown if subscriptions does not all belong to the same address |
| InvalidOperationException | Thrown if any subscription already belongs to the customer |
| InvalidOperationException | Thrown if a subscription does not have a customer |
| InvalidOperationException | Thrown if the service of a subscription is an address service |
| InvalidOperationException | Thrown if the customer does not belong to the address |
| SubscriptionHasUnfinishedJobsException | Thrown if a subscription has unfinished jobs |
| SubscriptionHasInvalidStatusException | Thrown if a subscription has invalid status |
| SubscriptionReferenceException | Thrown if a subscription is an add-on to subscription that is not being transferred |
| SubscriptionAddonException | Thrown if a subscription is has add-on subscriptions that is not being transferred |
Remarks
All subscriptions must belong to a customer
No subscriptions may be address services
All subscriptions must be on the same address
Customer must have the address as installation address
Subscriptions must have no unfinished jobs
Subscriptions must have all good statuses
If a subscription has addons, all addons must also be transferred
If a subscription is an addon, the base subscription must be transferred as well
See Also