Ceph OSD

使用 Ceph RESTful API osd 端点来管理 Ceph OSD 的方法参考。

GET /api/osd

示例

GET /api/osd HTTP/1.1
Host: example.com
状态码
  • 200 好-好的。

  • 400 错误请求-操作异常。 请检查响应主体以获取详细信息。

  • 401 未经授权-未经认证的访问。 请先登录。

  • 403 禁止-未经授权的访问。 请检查您的许可权。

  • 500 内部服务器错误-意外错误。 请检查响应主体以获取堆栈跟踪。

POST /api/osd

示例

POST /api/osd HTTP/1.1
Host: example.com
Content-Type: application/json

{
    "data": "STRING",
    "method": "STRING",
    "tracking_id": "STRING"
}
状态码
  • 201 已创建-已创建资源。

  • 202 已接受-操作仍在执行。 请检查任务队列。

  • 400 错误请求-操作异常。 请检查响应主体以获取详细信息。

  • 401 未经授权-未经认证的访问。 请先登录。

  • 403 禁止-未经授权的访问。 请检查您的许可权。

  • 500 内部服务器错误-意外错误。 请检查响应主体以获取堆栈跟踪。

GET /api/osd/flags

描述

查看 Ceph OSD 标志。

示例

GET /api/osd/flags HTTP/1.1
Host: example.com
状态码
  • 200 好-好的。

  • 400 错误请求-操作异常。 请检查响应主体以获取详细信息。

  • 401 未经授权-未经认证的访问。 请先登录。

  • 403 禁止-未经授权的访问。 请检查您的许可权。

  • 500 内部服务器错误-意外错误。 请检查响应主体以获取堆栈跟踪。

PUT /api/osd/flags

描述

设置整个存储集群的 Ceph OSD 标志。

参数
  • 无法取消设置 recovery_deletessortbitwisepglog_hardlimit 标志。

  • 无法设置 purged_snapshots 标志。

重要信息: 必须包含这四个标志才能成功执行操作。

示例

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

{
    "flags": [
        "STRING"
    ]
}
状态码
  • 200 好-好的。

  • 202 已接受-操作仍在执行。 请检查任务队列。

  • 400 错误请求-操作异常。 请检查响应主体以获取详细信息。

  • 401 未经授权-未经认证的访问。 请先登录。

  • 403 禁止-未经授权的访问。 请检查您的许可权。

  • 500 内部服务器错误-意外错误。 请检查响应主体以获取堆栈跟踪。

GET /api/osd/flags/individual

描述

查看个别 Ceph OSD 标志。

示例

GET /api/osd/flags/individual HTTP/1.1
Host: example.com
状态码
  • 200 好-好的。

  • 400 错误请求-操作异常。 请检查响应主体以获取详细信息。

  • 401 未经授权-未经认证的访问。 请先登录。

  • 403 禁止-未经授权的访问。 请检查您的许可权。

  • 500 内部服务器错误-意外错误。 请检查响应主体以获取堆栈跟踪。

PUT /api/osd/flags/individual

描述

更新 Ceph OSD 的个别子集的 nooutnoinnodownnoup 标志。

示例

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 好-好的。

  • 202 已接受-操作仍在执行。 请检查任务队列。

  • 400 错误请求-操作异常。 请检查响应主体以获取详细信息。

  • 401 未经授权-未经认证的访问。 请先登录。

  • 403 禁止-未经授权的访问。 请检查您的许可权。

  • 500 内部服务器错误-意外错误。 请检查响应主体以获取堆栈跟踪。

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 好-好的。

  • 400 错误请求-操作异常。 请检查响应主体以获取详细信息。

  • 401 未经授权-未经认证的访问。 请先登录。

  • 403 禁止-未经授权的访问。 请检查您的许可权。

  • 500 内部服务器错误-意外错误。 请检查响应主体以获取堆栈跟踪。

GET /api/osd/safe_to_destroy

描述

检查 Ceph OSD 是否安全销毁。

参数
  • 查询:

    • ids: Ceph OSD 服务标识的必需字符串。

示例

GET /api/osd/safe_to_destroy?ids=STRING HTTP/1.1
Host: example.com
状态码
  • 200 好-好的。

  • 400 错误请求-操作异常。 请检查响应主体以获取详细信息。

  • 401 未经授权-未经认证的访问。 请先登录。

  • 403 禁止-未经授权的访问。 请检查您的许可权。

  • 500 内部服务器错误-意外错误。 请检查响应主体以获取堆栈跟踪。

DELETE /api/osd/_SVC_ID

参数
  • SVC_ID 替换为 Ceph OSD 服务标识的字符串值。

  • 查询:

    • preserve_id -字符串值。

    • force -字符串值。

状态码
  • 202 已接受-操作仍在执行。 请检查任务队列。

  • 204 未删除任何内容-资源。

  • 400 错误请求-操作异常。 请检查响应主体以获取详细信息。

  • 401 未经授权-未经认证的访问。 请先登录。

  • 403 禁止-未经授权的访问。 请检查您的许可权。

  • 500 内部服务器错误-意外错误。 请检查响应主体以获取堆栈跟踪。

GET /api/osd/_SVC_ID

描述

返回有关 Ceph OSD 的收集数据。

参数
  • SVC_ID 替换为 Ceph OSD 服务标识的字符串值。

示例

GET /api/osd/SVC_ID HTTP/1.1
Host: example.com
状态码
  • 200 好-好的。

  • 400 错误请求-操作异常。 请检查响应主体以获取详细信息。

  • 401 未经授权-未经认证的访问。 请先登录。

  • 403 禁止-未经授权的访问。 请检查您的许可权。

  • 500 内部服务器错误-意外错误。 请检查响应主体以获取堆栈跟踪。

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 好-好的。

  • 202 已接受-操作仍在执行。 请检查任务队列。

  • 400 错误请求-操作异常。 请检查响应主体以获取详细信息。

  • 401 未经授权-未经认证的访问。 请先登录。

  • 403 禁止-未经授权的访问。 请检查您的许可权。

  • 500 内部服务器错误-意外错误。 请检查响应主体以获取堆栈跟踪。

POST /api/osd/_SVCID/destroy

描述

将 Ceph OSD 标记为已销毁。 在销毁之前,必须将 Ceph OSD 标记下来。 此操作使 Ceph OSD 标识保持不变,但会除去 Cephx 密钥,配置密钥数据和锁箱密钥。

警告: 此操作将使数据永久不可读。

参数
  • SVC_ID 替换为 Ceph OSD 服务标识的字符串值。

状态码
  • 201 已创建-已创建资源。

  • 202 已接受-操作仍在执行。 请检查任务队列。

  • 400 错误请求-操作异常。 请检查响应主体以获取详细信息。

  • 401 未经授权-未经认证的访问。 请先登录。

  • 403 禁止-未经授权的访问。 请检查您的许可权。

  • 500 内部服务器错误-意外错误。 请检查响应主体以获取堆栈跟踪。

GET /api/osd/_SVCID/devices

参数
  • SVC_ID 替换为 Ceph OSD 服务标识的字符串值。

示例

GET /api/osd/SVC_ID/devices HTTP/1.1
Host: example.com
状态码
  • 200 好-好的。

  • 400 错误请求-操作异常。 请检查响应主体以获取详细信息。

  • 401 未经授权-未经认证的访问。 请先登录。

  • 403 禁止-未经授权的访问。 请检查您的许可权。

  • 500 内部服务器错误-意外错误。 请检查响应主体以获取堆栈跟踪。

GET /api/osd/_SVCID/histogram

描述

返回 Ceph OSD 直方图数据。

参数
  • SVC_ID 替换为 Ceph OSD 服务标识的字符串值。

示例

GET /api/osd/SVC_ID/histogram HTTP/1.1
Host: example.com
状态码
  • 200 好-好的。

  • 400 错误请求-操作异常。 请检查响应主体以获取详细信息。

  • 401 未经授权-未经认证的访问。 请先登录。

  • 403 禁止-未经授权的访问。 请检查您的许可权。

  • 500 内部服务器错误-意外错误。 请检查响应主体以获取堆栈跟踪。

PUT /api/osd/_SVCID/mark

描述

标记 Ceph OSD outindownlost

注: 在将 Ceph OSD 标记为 lost down 之前,必须将其标记为 Ceph OSD。

参数
  • SVC_ID 替换为 Ceph OSD 服务标识的字符串值。

示例

PUT /api/osd/SVC_ID/mark HTTP/1.1
Host: example.com
Content-Type: application/json

{
    "action": "STRING"
}
状态码
  • 200 好-好的。

  • 202 已接受-操作仍在执行。 请检查任务队列。

  • 400 错误请求-操作异常。 请检查响应主体以获取详细信息。

  • 401 未经授权-未经认证的访问。 请先登录。

  • 403 禁止-未经授权的访问。 请检查您的许可权。

  • 500 内部服务器错误-意外错误。 请检查响应主体以获取堆栈跟踪。

POST /api/osd/_SVCID/purge

描述

从 CRUSH 映射中除去 Ceph OSD。

注: 在除去之前,必须将 Ceph OSD 标记为 down

参数
  • SVC_ID 替换为 Ceph OSD 服务标识的字符串值。

状态码
  • 201 已创建-已创建资源。

  • 202 已接受-操作仍在执行。 请检查任务队列。

  • 400 错误请求-操作异常。 请检查响应主体以获取详细信息。

  • 401 未经授权-未经认证的访问。 请先登录。

  • 403 禁止-未经授权的访问。 请检查您的许可权。

  • 500 内部服务器错误-意外错误。 请检查响应主体以获取堆栈跟踪。

POST /api/osd/_SVCID/reweight

描述

暂时重新调整 Ceph OSD 的权重。 当 Ceph OSD 标记为 out时, OSD 的权重将设置为 0。 当 Ceph OSD 标记回 in时, 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 已创建-已创建资源。

  • 202 已接受-操作仍在执行。 请检查任务队列。

  • 400 错误请求-操作异常。 请检查响应主体以获取详细信息。

  • 401 未经授权-未经认证的访问。 请先登录。

  • 403 禁止-未经授权的访问。 请检查您的许可权。

  • 500 内部服务器错误-意外错误。 请检查响应主体以获取堆栈跟踪。

POST /api/osd/_SVCID/scrub

参数
  • SVC_ID 替换为 Ceph OSD 服务标识的字符串值。

  • 查询:

    • deep -布尔值 truefalse

示例

POST /api/osd/SVC_ID/scrub HTTP/1.1
Host: example.com
Content-Type: application/json

{
    "deep": true
}
状态码
  • 201 已创建-已创建资源。

  • 202 已接受-操作仍在执行。 请检查任务队列。

  • 400 错误请求-操作异常。 请检查响应主体以获取详细信息。

  • 401 未经授权-未经认证的访问。 请先登录。

  • 403 禁止-未经授权的访问。 请检查您的许可权。

  • 500 内部服务器错误-意外错误。 请检查响应主体以获取堆栈跟踪。

GET /api/osd/_SVCID/smart

参数
  • SVC_ID 替换为 Ceph OSD 服务标识的字符串值。

示例

GET /api/osd/SVC_ID/smart HTTP/1.1
Host: example.com
状态码
  • 200 好-好的。

  • 400 错误请求-操作异常。 请检查响应主体以获取详细信息。

  • 401 未经授权-未经认证的访问。 请先登录。

  • 403 禁止-未经授权的访问。 请检查您的许可权。

  • 500 内部服务器错误-意外错误。 请检查响应主体以获取堆栈跟踪。