searchGroups #

Searches for group models.

Query Syntax #

HTTP #

URL: http://kuzzle:7512/_/device-manager/models/groups/_search
Method: POST

Other protocols #

{
  "controller": "device-manager/models",
  "action": "searchGroups",
  "engineGroup": "<engineGroup>",
  "body": {
    "query": {
      // ...
    },
    "sort": [
      // ...
    ]
  },

  // optional:
  "from": "<starting offset>",
  "size": "<page size>"
}

Arguments #

engineGroup: name of the engine group
from: paginates search results by defining the offset from the first result you want to fetch. Usually used with the size argument
size: set the maximum number of documents returned per result page

Body properties #

query: the search query itself, using the ElasticSearch Query DSL.
sort: contains a list of fields, used to sort search results, in order of importance.

Response #

{
  "status": 200,
  "error": null,
  "controller": "device-manager/models",
  "action": "searchGroups",
  "requestId": "<unique request identifier>",
  "result": {
    "hits": [
      {
        "_id": "<GroupModelId>",
        "_source": {
          // Group model content
        },
      },
    ],
    "total": 42
  }
}