cephfs

CephFS file management.

put /cephfs/copy

Copy a file or directory recursively.

Parameters

path string query
dstPath string query

Responses

default response
default response
object
A long-running task that goes on in the background after this task is completed. See tasks endpoints for details

Examples

No request body required
put /cephfs/move

Rename a file or directory.

Parameters

path string query
dstPath string query

Examples

No request body required
get /cephfs/files

List files in a directory.

Parameters

dir string query

Responses

default response
default response
object

Examples

No request body required
patch /cephfs/files

Update or rename a file/directory.

Parameters

path string query
body object

Examples

Request Body

{
  "gid": 42,
  "uid": 42,
  "mode": 42,
  "absolutePath": "string"
}
get /cephfs/quota

Get the quota of a directory.

Parameters

dir string query

Responses

default response
default response
object

Examples

No request body required
put /cephfs/quota

Set the quota of a directory.

Parameters

dir string query
body object

Examples

Request Body

{
  "maxBytes": 42,
  "maxFiles": 42
}
post /cephfs/stats

Get stats for a list of files.

Parameters

body array
Absolute paths of the requested files. (Array of string items)

Responses

default response
default response
array
Array of CephFsResponse objects

Examples

Request Body

[
  "string"
]
delete /cephfs/delete

Delete files or directories recursively.

Parameters

path array query
Array of string items
deleteSnapshots boolean query

Responses

default response
default response
object
A long-running task that goes on in the background after this task is completed. See tasks endpoints for details

Examples

No request body required
get /cephfs/layout

Get the pool a file or directory is stored in.

Parameters

path string query

Responses

default response
default response
object

Examples

No request body required
put /cephfs/layout

Change the pool a file or directory is stored in.

Files can only be changed if they are empty. Changing a directory only affects new files and subdirectories.

Parameters

path string query
body object

Examples

Request Body

{
  "pool": "string",
  "namespace": "string"
}
put /cephfs/upload

Upload a file.

Parameters

body object

Examples

Request Body

{
  "file": {},
  "path": "string"
}
get /cephfs/clients

List all currently connected CephFS clients.

Parameters

pagination object query
Pagination request. When supplied, the result will be filtered, sorted and limited according to this request object.

Responses

default response
default response
oneOf A response that can be either paginated or a raw list (depending on the presence of the pagination query parameter).
object
A paginated result.

Examples

No request body required
get /cephfs/download

Download a file.

Parameters

path string query

Responses

default response
default response
object

Examples

No request body required
get /cephfs/layout/pools

Get pools that are eligible as data storage location in the layout API.

Responses

default response
default response
array
Array of string items

Examples

No request body required
post /cephfs/clients/evict

Evict (kick) a connected client, the client can reconnect but must do so explicitly.

Parameters

id array query
ID of the client to evict (Array of integer items)

Examples

No request body required
get /cephfs/files-paginated

List files with all stats in a directory.

Avoid calling this too often or on directories with > 10k files.

Parameters

dir string query
pagination object query
Pagination request. When supplied, the result will be filtered, sorted and limited according to this request object.

Responses

default response
default response
object
A paginated result.

Examples

No request body required
post /cephfs/create-directory

Create a new directory recursively.

Parameters

body object

Examples

Request Body

{
  "dir": "string",
  "pool": "string",
  "namespace": "string"
}
get /cephfs/files-with-stats

List files with all stats in a directory.

Avoid calling this too often or on directories with > 10k files.

Parameters

dir string query

Responses

default response
default response
object

Examples

No request body required