Endpoint

/v1/portal/files/{file_id}/evict

POST

Reclaim all cluster capacity used by the targeted file or directory. This does not affect children of a targeted directory.

Parameters

Name Description Required
file_id File or Directory ID Yes

Response

Codes

Code Description
200 Return value on success

Schema

{
  "description": "api_portal_eviction_result",
  "type": "object",
  "properties": {
    "evicted_blocks": {
      "description": "Number of 4096 byte blocks that have been freed. It can be less than requested and even 0 if no eviction was possible. The cluster's reported free capacity may take time to reflect the eviction.",
      "type": "string"
    }
  }
}