Get zone devices

Request a page with a list of console device resources belonging to a zone, sorted by registration (created) date, in descending order (most recent registered listed first). The page number and page size parameters are optional. When the values are not specified, these default to 1 and 10 respectively. The maximum page size that can be specified is 200 entries per page.

Service endpoint

/devices/v2/{unique_zone_id}/devices?page=m&page_size=n

Optional query string parameters
  • page: The page number to request.
  • page_size: The number of device records to retrieve per page.

Example

https://protectapi.cylance.com/devices/v2/d27ff5c4-5c0d-4f56-a00d-a1fb297e440e/devices?page=1&page_size=100

Method

HTTP/1.1 GET

Request headers
  • Accept: application/json
  • Authorization: Bearer JWT Token returned by Auth API with the device:list scope encoded

Request

None

Response

For more information, see Response status codes.

Response JSON schema

Field Name Description

id

The unique identifier for the device.

name

The name of the device.

page_number

The page number requested.

page_size

The page size requested.

policy_id

The unique identifier for the policy that the device is currently assigned to. This value can be null.

total_number_of_items

The total number of resources.

total_pages

The total number of pages that can be retrieved, based on the page size specified.