關於 IBM Cloud Object Storage S3 API
IBM Cloud® Object Storage API 是一個 REST 型 API，用來讀寫物件。
它使用 IBM Cloud® Identity and Access Management 進行鑑別及授權，並支援 S3 API 子集，以輕鬆地將應用程式移轉至 IBM Cloud。
此參考文件正在持續改進中。 如果您有在應用程式中使用 API 的相關技術問題，請將它們張貼在 StackOverflow。 同時新增 ibm-cloud-platform 及 object-storage 標籤，並藉由您的意見來協助改善本文件。
由於 Cloud Identity and Access Management 記號相當容易使用，所以 curl 是基本測試以及與儲存空間互動的良好選擇。 如需相關資訊，請參閱 curl 參考資料。
下列各表說明 IBM Cloud Object Storage API 的完整作業集。 如需相關資訊，請參閱儲存區的 API 參考資料頁面或物件的 API 參考資料頁面。
儲存區作業
這些作業會建立儲存區、刪除儲存區、取得儲存區的相關資訊，以及控制儲存區的行為。
| 儲存區作業 | 附註 |
|---|---|
GET 儲存區 |
用來擷取屬於帳戶的所有儲存區清單。 |
DELETE 儲存區 |
刪除空的儲存區。 |
DELETE 儲存區 CORS |
刪除儲存區上設定的任何 CORS（跨原點資源共用）配置。 |
GET 儲存區 |
列出儲存區中的物件。 限制為一次列出 1,000 個物件。 |
GET 儲存區 CORS |
擷取儲存區上設定的任何 CORS 配置。 |
HEAD 儲存區 |
擷取儲存區的標頭。 |
GET 多部分上傳 |
列出未完成或已取消的多部分上傳。 |
PUT 儲存區 |
儲存區具有命名限制。 帳戶限制為 100 個儲存區。 |
PUT 儲存區 CORS |
建立儲存區的 CORS 配置。 |
物件作業
這些作業會建立物件、刪除物件、取得物件的相關資訊，以及控制物件的行為。
| 物件作業 | 附註 |
|---|---|
DELETE 物件 |
刪除儲存區中的物件。 |
DELETE 批次 |
使用一個作業刪除儲存區中的數個物件。 |
GET 物件 |
擷取儲存區中的物件。 |
HEAD 物件 |
擷取物件的標頭。 |
OPTIONS 物件 |
檢查 CORS 配置，以查看是否可以傳送特定要求。 |
PUT 物件 |
將物件新增至儲存區。 |
PUT 物件（副本） |
建立物件的副本。 |
| 開始多部分上傳 | 建立要上傳的一組組件的上傳 ID。 |
| 上傳組件 | 上傳與上傳 ID 相關聯之物件的組件。 |
| 上傳組件（副本） | 上傳與上傳 ID 相關聯之現有物件的組件。 |
| 完成多部分上傳 | 組合來自與上傳 ID 相關聯之組件的物件。 |
| 取消多部分上傳 | 取消上傳及刪除與上傳 ID 相關聯的未完成組件。 |
| 列出組件 | 傳回與上傳 ID 相關聯的組件清單 |
如需 IBM Cloud Object Storage 特性及使用案例的相關資訊，請參閱 ibm.com。