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: This is the page number to request.
  • page_size: This is 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

Please see the Response status codes for more information.

Response JSON schema

Field Name Description

id

This is the unique identifier for the device.

name

This is the name of the device.

page_number

This is the page number requested.

page_size

This is the page size requested.

policy_id

This is the unique identifier for the policy that the policy is currently assigned to (can be assigned as null).

total_number_of_items

This is the total number of resources.

total_pages

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