Core
API v1.x
1

You are currently looking at the documentation of a previous version of Kuzzle. We strongly recommend that you use the latest version. You can also use the version selector in the top menu.

scrollProfiles #

Moves a result set cursor forward, created by a searchProfiles query with the scroll argument provided.

Results returned by a scrollProfiles request reflect the state of the index at the time of the initial search request, like a fixed snapshot. Subsequent changes to documents do not affect the scroll results.


Query Syntax #

HTTP #

Copied to clipboard!
URL: http://kuzzle:7512/profiles/_scroll/<scrollId>[?scroll=<time to live>]
Method: GET

Other protocols #

Copied to clipboard!
{
  "controller": "security",
  "action": "scrollProfiles",
  "scrollId": "<scrollId>",
  "scroll": "<time to live>"
}

Arguments #

  • scrollId: cursor unique identifier, obtained by either a searchProfiles or a scrollProfiles query

Optional: #

  • scroll: refresh the cursor duration, using the time to live syntax.

Response #

Returns a paginated search result set, with the following properties:

  • hits: array of found profiles. Each document has the following properties:
    • _id: profile unique identifier
    • _source: profile definition
  • scrollId: identifier to the next page of result. Can be different than the previous one(s)
  • total: total number of found profiles. Usually greater than the number of profiles in a result page
Copied to clipboard!
{
  "status": 200,
  "error": null,
  "action": "scrollProfiles",
  "controller": "security",
  "requestId": "<unique request identifier>",
  "result": {
    "scrollId": "<new scroll id>",
    "hits": [
      {
        "_id": "profile1",
        "_source": {
          "policies": [
            // list of policies
          ]
        }
      },
      {
        "_id": "profile2",
        "_source": {
          "policies": [
            // list of policies
          ]
        }
      }
    ],
    "total": 42
  }
}