POST /v1/cloud_storage/cache/trim

Invoke trimming on the local cache of tiered storage objects. If no parameters are included, this endpoint by default trims the cache to the maximum cache size given by the cluster config. Use the bytes and objects parameters to specify the number of bytes and objects to retain in the cache.

Query parameters

  • objects integer

    Target number of objects to retain in the cache

  • bytes integer

    Target number of bytes to retain in the cache

Responses

  • 200

    Success

POST /v1/cloud_storage/cache/trim 
curl \
 --request POST 'http://localhost:9644/v1/cloud_storage/cache/trim'

Documentation preview

will expire on January 19 at 23:13

This is a preview of your version @2026-01-12.

View current documentation