A.10. 主机
使用 Ceph RESTful API host 端点来显示主机（也称为节点）的方法参考。
GET /api/host- 描述
- 列出主机规格。
- 参数
queries:
-
sources- 主机源的字符串值。
-
- 示例
GET /api/host HTTP/1.1 Host: example.com
- 状态代码
- 200 OK - 确定。
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问.请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
POST /api/host- 示例
POST /api/host HTTP/1.1 Host: example.com Content-Type: application/json { "hostname": "STRING", "status": "STRING" }- 状态代码
- 201 created - 资源已创建。
- 202 accepted - 操作仍在执行。请检查任务队列。
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问.请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
DELETE /api/host/HOST_NAME- 参数
-
将
HOST_NAME替换为节点的名称。
-
将
- 状态代码
- 202 accepted - 操作仍在执行。请检查任务队列。
- 204 No Content – Resource deleted.
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问.请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
GET /api/host/HOST_NAME- 描述
- 显示给定主机的信息。
- 参数
-
将
HOST_NAME替换为节点的名称。
-
将
- 示例
GET /api/host/HOST_NAME HTTP/1.1 Host: example.com- 状态代码
- 200 OK - 确定。
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问.请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
PUT /api/host/HOST_NAME- 描述
- 更新给定主机的信息。只有在启用 Ceph Orchestrator 时，才支持此方法。
- 参数
-
将
HOST_NAME替换为节点的名称。 -
force- 强制主机进入维护模式。 -
Labels -
标签列表。 -
Maintenance- 输入或退出维护模式。 -
update_labels- 更新标签。
-
将
- 示例
PUT /api/host/HOST_NAME HTTP/1.1 Host: example.com Content-Type: application/json { "force": true, "labels": [ "STRING" ], "maintenance": true, "update_labels": true }
- 状态代码
- 200 OK - 确定。
- 202 accepted - 操作仍在执行。请检查任务队列。
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问.请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
GET /api/host/HOST_NAME/daemons- 参数
-
将
HOST_NAME替换为节点的名称。
-
将
- 示例
GET /api/host/HOST_NAME/daemons HTTP/1.1 Host: example.com- 状态代码
- 200 OK - 确定。
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问.请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
GET /api/host/HOST_NAME/devices- 参数
-
将
HOST_NAME替换为节点的名称。
-
将
- 示例
GET /api/host/HOST_NAME/devices HTTP/1.1 Host: example.com- 状态代码
- 200 OK - 确定。
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问.请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
POST /api/host/HOST_NAME/identify_device- 描述
- 通过打开设备的 light 达到指定秒数来识别设备。
- 参数
-
将
HOST_NAME替换为节点的名称。 -
Device- 设备 ID，如/dev/dm-0或ABC1234DEF567-1R1234_ABC8DE0Q。 -
duration- 设备的 LED 应该闪存的秒数。
-
将
- 示例
POST /api/host/HOST_NAME/identify_device HTTP/1.1 Host: example.com Content-Type: application/json { "device": "STRING", "duration": "STRING" }
- 状态代码
- 201 created - 资源已创建。
- 202 accepted - 操作仍在执行。请检查任务队列。
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问.请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
GET /api/host/HOST_NAME/inventory- 描述
- 显示主机的清单。
- 参数
-
将
HOST_NAME替换为节点的名称。 queries:
-
refresh- 触发异步刷新的字符串值。
-
-
将
- 示例
GET /api/host/HOST_NAME/inventory HTTP/1.1 Host: example.com- 状态代码
- 200 OK - 确定。
- 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
- 401 未授权 - 未验证的访问.请首先登录。
- 403 Forbidden – Unauthorized access.请检查您的权限。
- 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
GET /api/host/HOST_NAME/smart- 参数
-
将
HOST_NAME替换为节点的名称。
-
将
- 示例
GET /api/host/HOST_NAME/smart 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 章节。
