主機

線上編輯

使用 Ceph RESTful API host 端點來顯示主機 (也稱為節點) 資訊的方法參照。

GET /api/host

說明

列出主機規格。

參數

  • 查詢:

    • sources -主機來源的字串值。

範例

GET /api/host HTTP/1.1
Host: example.com
狀態碼數

  • 200 好吧

  • 400 不當的要求-作業異常狀況。 如需詳細資料，請檢查回應內文。

  • 401 未獲授權-未經鑑別存取。 請先登入。

  • 403 禁止-未獲授權存取。 請檢查您的許可權。

  • 500 內部伺服器錯誤-非預期的錯誤。 請檢查堆疊追蹤的回應主體。

POST /api/host

範例

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

{
    "hostname": "STRING",
    "status": "STRING"
}
狀態碼數

  • 201 已建立-已建立資源。

  • 202 已接受-作業仍在執行中。 請檢查作業佇列。

  • 400 不當的要求-作業異常狀況。 如需詳細資料，請檢查回應內文。

  • 401 未獲授權-未經鑑別存取。 請先登入。

  • 403 禁止-未獲授權存取。 請檢查您的許可權。

  • 500 內部伺服器錯誤-非預期的錯誤。 請檢查堆疊追蹤的回應主體。

DELETE /api/host/_HOST_NAME

參數

  • 將 HOST_NAME 取代為節點名稱。

狀態碼數

  • 202 已接受-作業仍在執行中。 請檢查作業佇列。

  • 204 未刪除內容-資源。

  • 400 不當的要求-作業異常狀況。 如需詳細資料，請檢查回應內文。

  • 401 未獲授權-未經鑑別存取。 請先登入。

  • 403 禁止-未獲授權存取。 請檢查您的許可權。

  • 500 內部伺服器錯誤-非預期的錯誤。 請檢查堆疊追蹤的回應主體。

GET /api/host/_HOST_NAME

說明

顯示給定主機的相關資訊。

參數

  • 將 HOST_NAME 取代為節點名稱。

範例

GET /api/host/HOST_NAME HTTP/1.1
Host: example.com
狀態碼數

  • 200 好吧

  • 400 不當的要求-作業異常狀況。 如需詳細資料，請檢查回應內文。

  • 401 未獲授權-未經鑑別存取。 請先登入。

  • 403 禁止-未獲授權存取。 請檢查您的許可權。

  • 500 內部伺服器錯誤-非預期的錯誤。 請檢查堆疊追蹤的回應主體。

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 好吧

  • 202 已接受-作業仍在執行中。 請檢查作業佇列。

  • 400 不當的要求-作業異常狀況。 如需詳細資料，請檢查回應內文。

  • 401 未獲授權-未經鑑別存取。 請先登入。

  • 403 禁止-未獲授權存取。 請檢查您的許可權。

  • 500 內部伺服器錯誤-非預期的錯誤。 請檢查堆疊追蹤的回應主體。

GET /api/host/HOST_NAME/daemons

參數

  • 將 HOST_NAME 取代為節點名稱。

範例

GET /api/host/HOST_NAME/daemons HTTP/1.1
Host: example.com
狀態碼數

  • 200 好吧

  • 400 不當的要求-作業異常狀況。 如需詳細資料，請檢查回應內文。

  • 401 未獲授權-未經鑑別存取。 請先登入。

  • 403 禁止-未獲授權存取。 請檢查您的許可權。

  • 500 內部伺服器錯誤-非預期的錯誤。 請檢查堆疊追蹤的回應主體。

GET /api/host/HOST_NAME/devices

參數

  • 將 HOST_NAME 取代為節點名稱。

範例

GET /api/host/HOST_NAME/devices HTTP/1.1
Host: example.com
狀態碼數

  • 200 好吧

  • 400 不當的要求-作業異常狀況。 如需詳細資料，請檢查回應內文。

  • 401 未獲授權-未經鑑別存取。 請先登入。

  • 403 禁止-未獲授權存取。 請檢查您的許可權。

  • 500 內部伺服器錯誤-非預期的錯誤。 請檢查堆疊追蹤的回應主體。

POST /api/host/HOST_NAME/identify_device

說明

透過開啟裝置的燈亮達指定的秒數來識別裝置。

參數

  • 將 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 已建立-已建立資源。

  • 202 已接受-作業仍在執行中。 請檢查作業佇列。

  • 400 不當的要求-作業異常狀況。 如需詳細資料，請檢查回應內文。

  • 401 未獲授權-未經鑑別存取。 請先登入。

  • 403 禁止-未獲授權存取。 請檢查您的許可權。

  • 500 內部伺服器錯誤-非預期的錯誤。 請檢查堆疊追蹤的回應主體。

GET /api/host/HOST_NAME/inventory

說明

顯示主機的庫存。

參數

  • 將 HOST_NAME 取代為節點名稱。

  • 查詢:

    • refresh -用來觸發非同步重新整理的字串值。

範例

GET /api/host/HOST_NAME/inventory HTTP/1.1
Host: example.com
狀態碼數

  • 200 好吧

  • 400 不當的要求-作業異常狀況。 如需詳細資料，請檢查回應內文。

  • 401 未獲授權-未經鑑別存取。 請先登入。

  • 403 禁止-未獲授權存取。 請檢查您的許可權。

  • 500 內部伺服器錯誤-非預期的錯誤。 請檢查堆疊追蹤的回應主體。

GET /api/host/HOST_NAME/smart

參數

  • 將 HOST_NAME 取代為節點名稱。

範例

GET /api/host/HOST_NAME/smart HTTP/1.1
Host: example.com
狀態碼數

  • 200 好吧

  • 400 不當的要求-作業異常狀況。 如需詳細資料，請檢查回應內文。

  • 401 未獲授權-未經鑑別存取。 請先登入。

  • 403 禁止-未獲授權存取。 請檢查您的許可權。

  • 500 內部伺服器錯誤-非預期的錯誤。 請檢查堆疊追蹤的回應主體。