Creates licenses for multiple devices
Starts a batch job to create licenses for either physical devices or virtual devices. Virtual devices are meant for cloud-to-cloud use case.
A physical device license is a deviceId and deviceSecret credential pair. The batch job creates a number of physical device licenses specified by the count parameter in the request body. The response contains an array of deviceId and deviceSecret pairs.
Virtual devices are identified with an external device ID and the requestor's project appId. The virtual device external ID is application-specific and the user is free to allocate it as user finds suitable. The external IDs for the virtual devices to be created are specified in the devices array in request body. For virtual devices the response contains only an array of deviceIds, but no deviceSecrets.
The autoclaim parameter can only be used when creating virtual devices. If autoclaim=true, the created virtual devices are immediately claimed by the requesting user account. In this case the response contains also tracking IDs for the claimed devices.
Path parameters
Project appId of the user's project
Query parameters
If set to true, the licenses are created and devices are immediately claimed by the same user. Supported only with deviceId array in body, and not with the count parameter.
Headers
ID used for correlating requests within HERE Tracking. Used for logging and error reporting.
Must be a valid UUIDv4.
Request body
Example request
{
"count": 10
}Response
Accepted
The batch job started successfully. Use the /registry/v2/{jobId}/status endpoint to check the job progess. After the job completes, use the /registry/v2/{jobId}/results endpoint to get the device licenses.
Example response
{
"jobId": "344a17a4-1b19-4420-bb6f-8400b87071fd"
}