A.19. NFS Ganesha
方法引用，使用 Ceph RESTful API nfs-ganesha 端点管理 Ceph NFS 网关。
GET /api/nfs-ganesha/daemon- 描述
- 查看 NFS Ganesha 守护进程的相关信息。
- 示例
GET /api/nfs-ganesha/daemon HTTP/1.1 Host: example.com
- 状态代码
- 200 OK - 确定。
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问。请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
GET /api/nfs-ganesha/export- 描述
- 查看所有 NFS Ganesha 导出。
- 示例
GET /api/nfs-ganesha/export HTTP/1.1 Host: example.com
- 状态代码
- 200 OK - 确定。
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问。请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
POST /api/nfs-ganesha/export- 描述
- 创建新的 NFS Ganesha 导出。
- 示例
POST /api/nfs-ganesha/export HTTP/1.1 Host: example.com Content-Type: application/json { "access_type": "STRING", "clients": [ { "access_type": "STRING", "addresses": [ "STRING" ], "squash": "STRING" } ], "cluster_id": "STRING", "daemons": [ "STRING" ], "fsal": { "filesystem": "STRING", "name": "STRING", "rgw_user_id": "STRING", "sec_label_xattr": "STRING", "user_id": "STRING" }, "path": "STRING", "protocols": [ 1 ], "pseudo": "STRING", "reload_daemons": true, "security_label": "STRING", "squash": "STRING", "tag": "STRING", "transports": [ "STRING" ] }- 状态代码
- 201 created - 资源已创建。
- 202 accepted - 操作仍在执行。请检查任务队列。
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问。请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
DELETE /api/nfs-ganesha/export/CLUSTER_ID/EXPORT_ID- 描述
- 删除 NFS Ganesha 导出。
- 参数
-
使用存储集群标识符字符串替换
CLUSTER_ID。 -
将
EXPORT_ID替换为一个整数的导出标识符。 查询：
-
reload_daemons- 一个布尔值，用于触发 NFS Ganesha 守护进程配置的重新加载。
-
-
使用存储集群标识符字符串替换
- 状态代码
- 202 accepted - 操作仍在执行。请检查任务队列。
- 204 No Content – Resource deleted.
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问。请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
GET /api/nfs-ganesha/export/CLUSTER_ID/EXPORT_ID- 描述
- 查看 NFS Ganesha 导出信息。
- 参数
-
使用存储集群标识符字符串替换
CLUSTER_ID。 -
将
EXPORT_ID替换为一个整数的导出标识符。
-
使用存储集群标识符字符串替换
- 示例
GET /api/nfs-ganesha/export/CLUSTER_ID/EXPORT_ID HTTP/1.1 Host: example.com
- 状态代码
- 200 OK - 确定。
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问。请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
PUT /api/nfs-ganesha/export/CLUSTER_ID/EXPORT_ID- 描述
- 更新 NFS Ganesha 导出信息。
- 参数
-
使用存储集群标识符字符串替换
CLUSTER_ID。 -
将
EXPORT_ID替换为一个整数的导出标识符。
-
使用存储集群标识符字符串替换
- 示例
PUT /api/nfs-ganesha/export/CLUSTER_ID/EXPORT_ID HTTP/1.1 Host: example.com Content-Type: application/json { "access_type": "STRING", "clients": [ { "access_type": "STRING", "addresses": [ "STRING" ], "squash": "STRING" } ], "daemons": [ "STRING" ], "fsal": { "filesystem": "STRING", "name": "STRING", "rgw_user_id": "STRING", "sec_label_xattr": "STRING", "user_id": "STRING" }, "path": "STRING", "protocols": [ 1 ], "pseudo": "STRING", "reload_daemons": true, "security_label": "STRING", "squash": "STRING", "tag": "STRING", "transports": [ "STRING" ] }
- 状态代码
- 200 OK - 确定。
- 202 accepted - 操作仍在执行。请检查任务队列。
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问。请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
GET /api/nfs-ganesha/status- 描述
- 查看 NFS Ganesha 管理功能的状态信息。
- 示例
GET /api/nfs-ganesha/status HTTP/1.1 Host: example.com
- 状态代码
- 200 OK - 确定。
- 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 Ceph Storage Object Gateway 指南中的将命名空间导出到 NFS-Ganesha 部分。
