Get all Device Groups

This call returns device groups information for device groups existing in the system and includes system-defined, statically or manually managed, and dynamically managed device group information. Device groups correspond to rule IDs.

HTTP Method

GET

Request URI

/msa/v1/cps/rule?offset=<Offset>&limit=<Limit>

Request parameters

 

Parameter

Description

Sample Value

offset

Parameter Type: Query

Data Type: String

Default: 0

Breaks results into chunks. The syntax is offset=value.

5

limit

Parameter Type: Query

Data Type: String

Default: 50

Limits the return to the specified number of rows.

25

Response fields

A list of device groups.

See Rules.

Example response

{
  "searchResults": [
    {
      "id": 38089,
      "name": "rule1",
      "description": "Rule 1 Description",
      "definition": "PLATFORMTYPE EQ 'IOS'"
    },
    {
      "id": 38090,
      "name": "rule2",
      "description": "Rule 2 Description",
      "definition": "PLATFORMTYPE EQ 'IOS'"
    }
  ],
  "results": 2,
  "offset": 0,
  "limit": 10
}