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

A.16. Ceph OSD

方法引用，使用 Ceph RESTful API osd 端点管理 Ceph OSD。

GET /api/osd
示例
GET /api/osd HTTP/1.1
Host: example.com
状态代码
  • 200 OK - 确定。
  • 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
  • 401 未授权 - 未验证的访问。请首先登录。
  • 403 Forbidden – Unauthorized access.请检查您的权限。
  • 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
POST /api/osd
示例
POST /api/osd HTTP/1.1
Host: example.com
Content-Type: application/json

{
    "data": "STRING",
    "method": "STRING",
    "tracking_id": "STRING"
}
状态代码
  • 201 created - 资源已创建。
  • 202 accepted - 操作仍在执行。请检查任务队列。
  • 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
  • 401 未授权 - 未验证的访问。请首先登录。
  • 403 Forbidden – Unauthorized access.请检查您的权限。
  • 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
GET /api/osd/flags
描述
查看 Ceph OSD 标记。
示例
GET /api/osd/flags HTTP/1.1
Host: example.com
状态代码
  • 200 OK - 确定。
  • 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
  • 401 未授权 - 未验证的访问。请首先登录。
  • 403 Forbidden – Unauthorized access.请检查您的权限。
  • 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
PUT /api/osd/flags
描述
为整个存储集群设置 Ceph OSD 标志。
参数
  • recovery_deletes, sortbitwise, 和 pglog_hardlimit 标志不能取消设置。

  • 无法设置 purged_snapshots 标志。

    重要

    您必须包含这四个标记才能成功操作。

示例
PUT /api/osd/flags HTTP/1.1
Host: example.com
Content-Type: application/json

{
    "flags": [
        "STRING"
    ]
}
状态代码
  • 200 OK - 确定。
  • 202 accepted - 操作仍在执行。请检查任务队列。
  • 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
  • 401 未授权 - 未验证的访问。请首先登录。
  • 403 Forbidden – Unauthorized access.请检查您的权限。
  • 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
GET /api/osd/flags/individual
描述
查看各个 Ceph OSD 标志。
示例
GET /api/osd/flags/individual HTTP/1.1
Host: example.com
状态代码
  • 200 OK - 确定。
  • 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
  • 401 未授权 - 未验证的访问。请首先登录。
  • 403 Forbidden – Unauthorized access.请检查您的权限。
  • 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
PUT /api/osd/flags/individual
描述
更新 noout，noin、nodown 和 noup 标志用于独立 Ceph OSD 子集。
示例
PUT /api/osd/flags/individual HTTP/1.1
Host: example.com
Content-Type: application/json

{
    "flags": {
        "nodown": true,
        "noin": true,
        "noout": true,
        "noup": true
    },
    "ids": [
        1
    ]
}
状态代码
  • 200 OK - 确定。
  • 202 accepted - 操作仍在执行。请检查任务队列。
  • 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
  • 401 未授权 - 未验证的访问。请首先登录。
  • 403 Forbidden – Unauthorized access.请检查您的权限。
  • 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
GET /api/osd/safe_to_delete
参数

  • 查询：

    • svc_ids - Ceph OSD 服务标识符的必要字符串。
示例
GET /api/osd/safe_to_delete?svc_ids=STRING HTTP/1.1
Host: example.com
状态代码
  • 200 OK - 确定。
  • 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
  • 401 未授权 - 未验证的访问。请首先登录。
  • 403 Forbidden – Unauthorized access.请检查您的权限。
  • 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
GET /api/osd/safe_to_destroy
描述
检查 Ceph OSD 是否安全被销毁。
参数

  • 查询：

    • id - Ceph OSD 服务标识符的必要字符串。
示例
GET /api/osd/safe_to_destroy?ids=STRING HTTP/1.1
Host: example.com
状态代码
  • 200 OK - 确定。
  • 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
  • 401 未授权 - 未验证的访问。请首先登录。
  • 403 Forbidden – Unauthorized access.请检查您的权限。
  • 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
DELETE /api/osd/SVC_ID
参数
  • 将 SVC_ID 替换为 Ceph OSD 服务标识符的字符串值。

  • 查询：

    • preserve_id - 字符串值。
    • force - 字符串值。
状态代码
  • 202 accepted - 操作仍在执行。请检查任务队列。
  • 204 No Content – Resource deleted.
  • 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
  • 401 未授权 - 未验证的访问。请首先登录。
  • 403 Forbidden – Unauthorized access.请检查您的权限。
  • 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
GET /api/osd/SVC_ID
描述
返回有关 Ceph OSD 收集的数据。
参数
  • 将 SVC_ID 替换为 Ceph OSD 服务标识符的字符串值。
示例
GET /api/osd/SVC_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/osd/SVC_ID
参数
  • 将 SVC_ID 替换为 Ceph OSD 服务标识符的字符串值。
示例
PUT /api/osd/SVC_ID HTTP/1.1
Host: example.com
Content-Type: application/json

{
    "device_class": "STRING"
}
状态代码
  • 200 OK - 确定。
  • 202 accepted - 操作仍在执行。请检查任务队列。
  • 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
  • 401 未授权 - 未验证的访问。请首先登录。
  • 403 Forbidden – Unauthorized access.请检查您的权限。
  • 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
POST /api/osd/SVC_ID/destroy
描述

将 Ceph OSD 标记为被销毁。Ceph OSD 在被销毁前必须标记为 down。此操作会使 Ceph OSD 标识符保持不变，但会删除 Cephx 密钥、配置密钥数据和锁定键。

警告

此操作会使数据永久可读。

参数
  • 将 SVC_ID 替换为 Ceph OSD 服务标识符的字符串值。
状态代码
  • 201 created - 资源已创建。
  • 202 accepted - 操作仍在执行。请检查任务队列。
  • 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
  • 401 未授权 - 未验证的访问。请首先登录。
  • 403 Forbidden – Unauthorized access.请检查您的权限。
  • 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
GET /api/osd/SVC_ID/devices
参数
  • 将 SVC_ID 替换为 Ceph OSD 服务标识符的字符串值。
示例
GET /api/osd/SVC_ID/devices HTTP/1.1
Host: example.com
状态代码
  • 200 OK - 确定。
  • 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
  • 401 未授权 - 未验证的访问。请首先登录。
  • 403 Forbidden – Unauthorized access.请检查您的权限。
  • 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
GET /api/osd/SVC_ID/histogram
描述
返回 Ceph OSD 直方图数据。
参数
  • 将 SVC_ID 替换为 Ceph OSD 服务标识符的字符串值。
示例
GET /api/osd/SVC_ID/histogram HTTP/1.1
Host: example.com
状态代码
  • 200 OK - 确定。
  • 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
  • 401 未授权 - 未验证的访问。请首先登录。
  • 403 Forbidden – Unauthorized access.请检查您的权限。
  • 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
PUT /api/osd/SVC_ID/mark
描述

将 Ceph OSD 标记为 out, in, down, 和 lost。

注意

Ceph OSD 在标记为 lost 前，需要先将它标记为 down。

参数
  • 将 SVC_ID 替换为 Ceph OSD 服务标识符的字符串值。
示例
PUT /api/osd/SVC_ID/mark HTTP/1.1
Host: example.com
Content-Type: application/json

{
    "action": "STRING"
}
状态代码
  • 200 OK - 确定。
  • 202 accepted - 操作仍在执行。请检查任务队列。
  • 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
  • 401 未授权 - 未验证的访问。请首先登录。
  • 403 Forbidden – Unauthorized access.请检查您的权限。
  • 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
POST /api/osd/SVC_ID/purge
描述

从 CRUSH map 移除 Ceph OSD。

注意

在移除前，Ceph OSD 必须标记为 down。

参数
  • 将 SVC_ID 替换为 Ceph OSD 服务标识符的字符串值。
状态代码
  • 201 created - 资源已创建。
  • 202 accepted - 操作仍在执行。请检查任务队列。
  • 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
  • 401 未授权 - 未验证的访问。请首先登录。
  • 403 Forbidden – Unauthorized access.请检查您的权限。
  • 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
POST /api/osd/SVC_ID/reweight
描述
临时重新加权 Ceph OSD。当 Ceph OSD 标记为 out 时，OSD 的权重设为 0。当 Ceph OSD 被标记为 在 中时，OSD 的权重设置为 1。
参数
  • 将 SVC_ID 替换为 Ceph OSD 服务标识符的字符串值。
示例
POST /api/osd/SVC_ID/reweight HTTP/1.1
Host: example.com
Content-Type: application/json

{
    "weight": "STRING"
}
状态代码
  • 201 created - 资源已创建。
  • 202 accepted - 操作仍在执行。请检查任务队列。
  • 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
  • 401 未授权 - 未验证的访问。请首先登录。
  • 403 Forbidden – Unauthorized access.请检查您的权限。
  • 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
POST /api/osd/SVC_ID/scrub
参数
  • 将 SVC_ID 替换为 Ceph OSD 服务标识符的字符串值。

  • 查询：

    • deep - 布尔值，可以是 true 或 false。
示例
POST /api/osd/SVC_ID/scrub HTTP/1.1
Host: example.com
Content-Type: application/json

{
    "deep": true
}
状态代码
  • 201 created - 资源已创建。
  • 202 accepted - 操作仍在执行。请检查任务队列。
  • 400 Bad Request – Operation exception.请检查响应正文以了解详细信息。
  • 401 未授权 - 未验证的访问。请首先登录。
  • 403 Forbidden – Unauthorized access.请检查您的权限。
  • 500 Internal Server Error – 意外错误。请检查堆栈追踪的响应正文。
GET /api/osd/SVC_ID/smart
参数
  • 将 SVC_ID 替换为 Ceph OSD 服务标识符的字符串值。
示例
GET /api/osd/SVC_ID/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 章节。
Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

© 2024 Red Hat, Inc.