A.3. Ceph 文件系统
方法引用，使用 Ceph RESTful API cephfs 端点管理 Ceph 文件系统(CephFS)。
GET /api/cephfs- 示例
GET /api/cephfs HTTP/1.1 Host: example.com
- 状态代码
- 200 OK - 确定。
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问.请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
GET /api/cephfs/FS_ID- 参数
-
使用 Ceph 文件系统标识符字符串替换
FS_ID。
-
使用 Ceph 文件系统标识符字符串替换
- 示例
GET /api/cephfs/FS_ID HTTP/1.1 Host: example.com- 状态代码
- 200 OK - 确定。
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问.请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
DELETE /api/cephfs/FS_ID/client/CLIENT_ID- 参数
-
使用 Ceph 文件系统标识符字符串替换
FS_ID。 -
将
CLIENT_ID替换为 Ceph 客户端标识符字符串。
-
使用 Ceph 文件系统标识符字符串替换
- 状态代码
- 202 accepted - 操作仍在执行。请检查任务队列。
- 204 No Content – Resource deleted.
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问.请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
GET /api/cephfs/FS_ID/clients- 参数
-
使用 Ceph 文件系统标识符字符串替换
FS_ID。
-
使用 Ceph 文件系统标识符字符串替换
- 示例
GET /api/cephfs/FS_ID/clients HTTP/1.1 Host: example.com- 状态代码
- 200 OK - 确定。
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问.请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
GET /api/cephfs/FS_ID/get_root_directory- 描述
-
使用
ls_dirAPI 调用无法获取的根目录。 - 参数
-
使用 Ceph 文件系统标识符字符串替换
FS_ID。
-
使用 Ceph 文件系统标识符字符串替换
- 示例
GET /api/cephfs/FS_ID/get_root_directory HTTP/1.1 Host: example.com- 状态代码
- 200 OK - 确定。
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问.请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
GET /api/cephfs/FS_ID/ls_dir- 描述
- 列出指定路径的目录。
- 参数
-
使用 Ceph 文件系统标识符字符串替换
FS_ID。 queries:
-
path- 要开始列表的字符串值。默认路径为/，如果没有指定。 -
depth- 整数值指定要减少目录树的步骤数。
-
-
使用 Ceph 文件系统标识符字符串替换
- 示例
GET /api/cephfs/FS_ID/ls_dir HTTP/1.1 Host: example.com- 状态代码
- 200 OK - 确定。
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问.请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
GET /api/cephfs/FS_ID/mds_counters- 参数
-
使用 Ceph 文件系统标识符字符串替换
FS_ID。 queries:
-
计数器- 整数值。
-
-
使用 Ceph 文件系统标识符字符串替换
- 示例
GET /api/cephfs/FS_ID/mds_counters HTTP/1.1 Host: example.com- 状态代码
- 200 OK - 确定。
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问.请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
GET /api/cephfs/FS_ID/quota- 描述
- 显示给定路径的 CephFS 配额。
- 参数
-
使用 Ceph 文件系统标识符字符串替换
FS_ID。 queries:
-
path- 指定目录路径所需的字符串值。
-
-
使用 Ceph 文件系统标识符字符串替换
- 示例
GET /api/cephfs/FS_ID/quota?path=STRING HTTP/1.1 Host: example.com
- 状态代码
- 200 OK - 确定。
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问.请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
PUT /api/cephfs/FS_ID/quota- 描述
- 为给定路径设置配额。
- 参数
-
使用 Ceph 文件系统标识符字符串替换
FS_ID。 -
max_bytes- 定义字节限制的字符串值。 -
max_files- 定义文件限制的字符串值。 -
path- 定义到目录或文件的路径的字符串值。
-
使用 Ceph 文件系统标识符字符串替换
- 示例
PUT /api/cephfs/FS_ID/quota HTTP/1.1 Host: example.com Content-Type: application/json { "max_bytes": "STRING", "max_files": "STRING", "path": "STRING" }
- 状态代码
- 200 OK - 确定。
- 202 accepted - Operation 仍在执行，检查任务队列。
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问.请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
DELETE /api/cephfs/FS_ID/snapshot- 描述
- 删除一个快照。
- 参数
-
使用 Ceph 文件系统标识符字符串替换
FS_ID。 queries:
-
name- 指定快照名称所需的字符串值。 -
path- 定义到目录的路径所需的字符串值。
-
-
使用 Ceph 文件系统标识符字符串替换
- 状态代码
- 202 accepted - Operation 仍在执行，检查任务队列。
- 204 No Content – Resource deleted.
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问.请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
POST /api/cephfs/FS_ID/snapshot- 描述
- 创建快照。
- 参数
-
使用 Ceph 文件系统标识符字符串替换
FS_ID。 -
name- 指定快照名称的字符串值。如果没有指定名称，则会生成使用 RFC3339 UTC 格式的当前时间的名称。 -
path- 定义到目录的路径的字符串值。
-
使用 Ceph 文件系统标识符字符串替换
- 示例
POST /api/cephfs/FS_ID/snapshot HTTP/1.1 Host: example.com Content-Type: application/json { "name": "STRING", "path": "STRING" }
- 状态代码
- 201 created - 资源已创建。
- 202 accepted - Operation 仍在执行，检查任务队列。
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问.请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
DELETE /api/cephfs/FS_ID/tree- 描述
- 删除目录。
- 参数
-
使用 Ceph 文件系统标识符字符串替换
FS_ID。 queries:
-
path- 定义到目录的路径所需的字符串值。
-
-
使用 Ceph 文件系统标识符字符串替换
- 状态代码
- 202 accepted - Operation 仍在执行，检查任务队列。
- 204 No Content – Resource deleted.
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问.请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
POST /api/cephfs/FS_ID/tree- 描述
- 创建一个目录。
- 参数
-
使用 Ceph 文件系统标识符字符串替换
FS_ID。 -
path- 定义到目录的路径的字符串值。
-
使用 Ceph 文件系统标识符字符串替换
- 示例
POST /api/cephfs/FS_ID/tree HTTP/1.1 Host: example.com Content-Type: application/json { "path": "STRING" }
- 状态代码
- 201 created - 资源已创建。
- 202 accepted - Operation 仍在执行，检查任务队列。
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问.请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
其它资源
- 如需了解更多详细信息，请参阅 Red Hat Ceph Storage Developer Guide 中的 Ceph RESTful API 章节。
