spop #

Removes and returns one or more elements at random from a set of unique values. If multiple elements are removed, the result set will be an array of removed elements, instead of a string.

[Redis documentation]

Query Syntax #

HTTP #

URL: http://kuzzle:7512/ms/_spop/<_id>
Method: POST
Body:

{
  // optional
  "count": 2
}

Other protocols #

{
  "controller": "ms",
  "action": "spop",
  "_id": "<key>",
  "body": {
    // optional
    "count": 2
  }
}

Argument #

_id: key identifier

Body properties #

Optional: #

count: number of elements to remove (default: 1)

Response #

If count is not set or equal to 1, returns the removed element as a string:

{
  "requestId": "<unique request identifier>",
  "status": 200,
  "error": null,
  "controller": "ms",
  "action": "spop",
  "collection": null,
  "index": null,
  "result": "<removed element>"
}

If multiple elements are removed (count > 1), an array of removed elements is returned instead:

{
  "requestId": "<unique request identifier>",
  "status": 200,
  "error": null,
  "controller": "ms",
  "action": "spop",
  "collection": null,
  "index": null,
  "result": [
    "removed element 1",
    "removed element 2",
    "..."
  ]
}

Edit this page on Github