A newer version of this documentation is available.

Setting Metadata Ejection

Bucket ejection from memory is set with POST /pools/default/buckets/default HTTP method and URI.

HTTP method and URI

To set the metadata ejection policy, use the evictionPolicy parameter. Default: valueOnly

POST /pools/default/buckets/default

Value-only ejection (the default) removes the data from cache but keeps all keys and metadata fields for non-resident items. When the value bucket ejection occurs, the item’s value is reset. Full metadata ejection removes all data including keys, metadata, and key-values from cache for non-resident items. Full metadata ejection reduces RAM requirement for large buckets.

Syntax

Curl request syntax:

curl -u [admin]:[password] -X POST
  http://[localhost]/pools/default/buckets/default
  -d evictionPolicy=[valueOnly | fullEviction]

Example

Curl request example:

curl -u Administrator:password -X POST \
  http://10.5.2.54/pools/default/buckets/default \
  -d 'evictionPolicy=fullEviction'

Response codes

"errors": {
      "evictionPolicy": "Eviction policy must be either 'valueOnly' or 'fullEviction'"