Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

A.10. 主机

使用 Ceph RESTful API host 端点来显示主机（也称为节点）的方法参考。

GET /api/host
描述
列出主机规格。
参数

  • queries:

    • sources - 主机源的字符串值。
示例
GET /api/host HTTP/1.1
Host: example.com
Copy to Clipboard Toggle word wrap
状态代码
  • 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"
}
Copy to Clipboard Toggle word wrap
状态代码
  • 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
Copy to Clipboard Toggle word wrap
状态代码
  • 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
}
Copy to Clipboard Toggle word wrap
状态代码
  • 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
Copy to Clipboard Toggle word wrap
状态代码
  • 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
Copy to Clipboard Toggle word wrap
状态代码
  • 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"
}
Copy to Clipboard Toggle word wrap
状态代码
  • 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
Copy to Clipboard Toggle word wrap
状态代码
  • 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
Copy to Clipboard Toggle word wrap
状态代码
  • 200 OK - 确定。
  • 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
  • 401 未授权 - 未经验证的访问.请先登录。
  • 403 Forbidden – Unauthorized access.请检查您的权限。
  • 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat