關於 IBM Storage Ceph as a Service API

IBM Storage Ceph as a Service 為您提供兩個 API 來設定和管理儲存資源。

這些 IBM Storage Ceph as a Service API 使用 IBM Cloud® Identity and Access Management 來授權和驗證請求。

由於 Cloud Identity and Access Management 代幣的使用相對簡單,curl 對於基礎測試以及與您的儲存空間進行互動而言,是個不錯的選擇。 如需相關資訊,請參閱 curl 參考資料

以下各節將說明 IBM Storage Ceph as a Service API 的完整操作集。

區塊儲存管理 API

使用區塊儲存管理 api,以程式化方式在 IBM Storage Ceph as a Service 部署中佈建和管理區塊儲存資源,包括磁碟區、主機和磁碟區至主機對應。

區塊作業

這些操作可建立、刪除區塊儲存,取得相關資訊,並控制其行為。

區塊儲存作業
區塊操作 動作
GET /volumes 用於擷取所有區塊磁碟區的清單。
DELETE /volumes/{id} 刪除磁碟區。
POST /volumes 在部署中建立磁碟區。
GET /volumes/{id} 擷取單一卷。
PATCH /volumes/{id} 更新磁碟區的名稱或容量。
GET /hosts 擷取部署中所有主機的清單
POST /hosts 建立新主機。
DELETE /host/{id} 刪除特定主機。
GET /hosts/{id} 擷取特定主機。
PATCH /hosts/{id} 更新主機資訊。
POST /hosts/{id}/volume_mappings 為主機建立磁碟區對應。
GET /hosts/{id}/volume_mappings/{volume_mapping_id} 擷取單一磁碟區的映射。
GET /hosts/{id}/volume_mappings 擷取主機的清單磁碟區對應。
DELETE /hosts/{id}/volume_mappings/{volume_mapping_id} 刪除特定磁碟區對應。
DELETE /hosts/{id}/volume_mappings 刪除主機的所有磁碟區對應。

物件儲存管理 API

管理作業

這些操作可建立、刪除、取得管理物件的相關資訊,並控制其行為。

物件管理操作
行政運作 附註
POST /certificates/{cert_type} 建立一個「S3」憑證。
PUT /certificates/{cert_type} 更換或更新 S3 憑證
GET /certificates/{cert_type} 擷取憑證狀態。
DELETE /certificates/{cert_type} 刪除 S3 憑證。
GET /certificates 擷取已設定的憑證清單
POST /s3_credentials/{access_key} 為物件建立 S3 認證。
GET /s3_credentials 擷取一個或多個 S3 認證。
DELETE /s3_credentials/{access_key} 刪除 S3 認證。

物件儲存 S3 API

IBM® Storage Ceph® as a Service Object Storage S3 API 是一個基於 REST 的 API,用於讀取和寫入物件。

此 IBM Storage Ceph as a Service API 使用 IBM Cloud® Identity and Access Management 進行身份驗證與授權,並支援 S3 API 的子集,以便將應用程式輕鬆遷移至 IBM Cloud。

物件作業

這些操作可建立、刪除、取得資訊,以及控制 S3 物件的行為。

物件作業
物件作業 附註
DELETE 物件 刪除儲存區中的物件。
DELETE 批次 使用一個作業刪除儲存區中的數個物件。
GET 物件 擷取儲存區中的物件。
HEAD 物件 擷取物件的標頭。
PUT 物件 將物件新增至儲存區。
PUT 物件(副本) 建立物件的副本。
開始多部分上傳 建立要上傳的一組組件的上傳 ID。
上傳組件 上傳與上傳 ID 相關聯之物件的組件。
上傳組件(副本) 上傳與上傳 ID 相關聯之現有物件的組件。
完成多部分上傳 組合來自與上傳 ID 相關聯之組件的物件。
取消多部分上傳 取消上傳及刪除與上傳 ID 相關聯的未完成組件。
列出組件 回傳與某個上傳 ID 相關聯的零件清單。

儲存區作業

這些操作可建立、刪除、取得相關資訊,並控制儲存桶的行為。

儲存區作業
儲存區作業 附註
GET 儲存區 用來擷取屬於帳戶的所有儲存區清單。
DELETE 儲存區 刪除空的儲存區。
GET 儲存區 列出儲存區中的物件。 限制為一次列出 1,000 個物件。
HEAD 儲存區 擷取儲存區的標頭。
GET 多部分上傳 列出未完成或已取消的多部分上傳。
PUT 儲存區 儲存區具有命名限制。 帳戶限制為 100 個儲存區。

有關 IBM Storage Ceph as a Service 功能和用例的詳細資訊,請參閱以下網址 ibm.com.