Device Registration
Instructions for registering a device are described in the following sections:
| • | Register a Device |
| • | Poll for Device Registration Status |
Register the device with FlexNet Operations to enable it to receive information about updates which have entitlement checking enabled.
Note:It is recommended that devices—including anonymous devices—register themselves using this API, to avoid a manual step of registering using the FlexNet Operations Producer Portal.
|
Item |
Description |
|
URI |
|
|
Method |
POST |
|
Query parameters |
registerRequest |
|
Request body |
{ "activationId": "string", "id": "string", "idType": "string", "identityName": "string", "publisherName": "string" } Note:For devices that are assigned to an account, it is recommended to provide the activation ID. For anonymous devices, the field activationId should be left blank. |
|
Response codes |
200: Not used 202: Asynchronous request. Use the URL returned to poll for a response. The response will indicate whether the request succeeded. |
Sample Response
If the request has been accepted (status 202), a URL including a polling ID to poll for completion of the registration is returned:
{
"url": "string"
}
Poll for Device Registration Status
Poll for a response to the registration status request, using the polling ID returned by a POST to the /uai/2.0/devices/registrations API. It can be used repeatedly until a 200 response is received.
|
Item |
Description |
|
URI |
|
|
Method |
GET |
|
Query parameters |
pollingId |
|
Request body |
N/A |
|
Response codes |
200: Processing complete. 202: Submitted request is still being processed. Use the URL returned to continue to poll for the response. 401: The request is unauthorized. This could be because a JWT was not found in the header, the token has expired, the signature is invalid, or a public key could not be identified (most commonly because the public key has not been uploaded to FlexNet Operations). |
Sample Response
This is the data structure for a response when processing the device registration is complete (status 200):
{
"arguments": "string",
"key": "string",
"message": "string"
}
If the request is still being processed (status 202), a URL to poll for completion of the status request is returned:
{
"url": "string"
}