Provisions (creates, registers, and bills) one or more third-party devices — including OEM devices — to a customer account in a single call.
Note: This method cannot be called in the sandbox environment and will throw an exception.
Parameters
apiKey
The active API Key.
erpNo
The account ERP number to activate devices against. Must be non-empty and resolve to a valid account.
hardwareId
Optional hardware ID (HWID) for CVAAS device creation. When supplied, the device is created with this HWID rather than a freshly allocated serial number.
productId
The product ID the devices are registered under. Determines the device type and whether OEM billing applies (see subPlan).
promoCode
Promotional or rate-plan code applied to device billing. Pass an empty string for no promo. When non-empty, must be valid for the account or an ancestor account.
quantity
Number of devices to provision. Must be between 1 and 1000 (default: 1).
sessionId
The active session ID.
subPlan
Subscription plan name for OEM devices. Ignored for non-OEM products. Required and must match a valid plan description for the productId when the product is OEM.
Return value
An array of ProvisionResult, one entry per provisioned device (each containing the assigned serial number), returned only when all slots succeed. If any slot fails, the call throws; devices that already completed are not rolled back but are not observable via this return value.
Remarks
Note: This method cannot be called in the sandbox environment and will throw an exception.