List device registrations

Edit online

List the details of each of the devices that are not yet approved into the Manager, including the ID that can be used in the (Handle Device Registration) API method.

Request

Edit online

Security

Edit online
Table 1. Roles capable of executing the List Device Registrations API method
Any Super User System Admin Security Admin Operator
  superUser systemAdmin

(readOnly and read/write)

    

HTTP method

Edit online

GET /manager/api/{apiResponseType}/1.0/listDeviceRegistrations.adm HTTP/1.1 Host:{manager.dsnet}

Curl method

Edit online

curl -u {admin}:{password} -k “https://{manager.dsnet}/manager/api/{apiResponseType}/1.0/listDeviceRegistrations.adm”

Response

Edit online

Device information for each device that is not approved or denied is returned.

JSON response example

Edit online
{
  “responseStatus”:“ok”,
  “responseHeader”:{
    “status”:“ok”,
    “now”:{milliseconds from the UNIX epoch},
    “requestId”:“UzCdzcCoDkMAABiqBsEAAABJ”
  },
  “responseData”:{
  “deviceRegistrations”:[
    {
      “ip”:“192.168.14.22”,
      “hostname”:“dc-s2000-1322.cleversafelabs.com”,
      “type”:“slicestor”,
      “id”:25,
      “keyFingerprint”:“b5:fd:8c:b0:9f:c3:30:85:48:e7:b0:9a:4d:79:0e:43:64:b0:04:6e”
    }
  ]
}

Parameters

Edit online
Table 2. Response parameters for List Device Registrations (listDeviceRegistrations) API method
Parameter Type Description
deviceRegistrations array

List of pending device registrations.
id Long

ID of pending device registration, approved or denied by using the handleDeviceRegistration API.

Note: It is different than the device ID that is generated after the device is approved.
hostname String

Hostname of pending device.
ip String

IP of pending device.
type String

Device type of pending device.
keyFingerprint String

Value of the public key fingerprint for the device.