關於 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.