支持控制台（Console）开发人员开始试用联系人

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。
示例
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 客户端标识符字符串。
状态代码
  • 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。
示例
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_dir API 调用无法获取的根目录。
参数
  • 使用 Ceph 文件系统标识符字符串替换 FS_ID。
示例
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 - 整数值指定要减少目录树的步骤数。
示例
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:

    • 计数器 - 整数值。
示例
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 - 指定目录路径所需的字符串值。
示例
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 - 定义到目录或文件的路径的字符串值。
示例
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 - 定义到目录的路径所需的字符串值。
状态代码
  • 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 - 定义到目录的路径的字符串值。
示例
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 - 定义到目录的路径所需的字符串值。
状态代码
  • 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 - 定义到目录的路径的字符串值。
示例
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 章节。
Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

© 2024 Red Hat, Inc.