关于 IBM Cloud Object Storage S3 API
IBM Cloud® Object Storage API 是基于 REST 的 API，用于读取和写入对象。
它使用 IBM Cloud® Identity and Access Management 进行认证和授权，并且支持 S3 API 的子集，能将应用程序轻松迁移到 IBM Cloud。
本参考文档仍在不断改进中。 如果在应用程序中使用此 API 时遇到技术问题，请在 Stack Overflow 上发帖提问。 请添加 ibm-cloud-platform 和 object-storage 标记，帮助我们根据您的反馈改进本文档。
由于 Cloud Identity and Access Management 令牌使用起来相对容易，因此将 curl 用于对存储器进行基本测试以及与存储器进行交互是不错的选择。 在 curl 参考中可以找到更多相关信息。
以下各表描述了 IBM Cloud Object Storage API 的完整操作集。 有关更多信息，请参阅有关存储区或对象的 API 参考页面。
存储区操作
这些操作可创建和删除存储区，获取有关存储区的信息以及控制存储区的行为。
| 存储区操作 | 注释 |
|---|---|
GET 存储区 |
用于检索属于帐户的所有存储区的列表。 |
DELETE 存储区 |
删除空存储区。 |
DELETE Bucket CORS |
删除存储区上设置的任何 CORS（跨源资源共享）配置。 |
GET 存储区 |
列出存储区中的对象。 限制为一次可列出 1,000 个对象。 |
GET Bucket CORS |
检索存储区上设置的任何 CORS 配置。 |
HEAD 存储区 |
检索存储区的头。 |
GET Multipart Uploads |
列出未完成或已取消的分块上传。 |
PUT 存储区 |
存储区具有命名限制。 帐户限制为只能有 100 个存储区。 |
PUT Bucket CORS |
为存储区创建 CORS 配置。 |
对象操作
这些操作可创建和删除对象，获取有关对象的信息以及控制对象的行为。
| 对象操作 | 注释 |
|---|---|
DELETE 对象 |
从存储区中删除一个对象。 |
DELETE 批处理 |
通过一个操作从存储区中删除多个对象。 |
GET 对象 |
在存储区中检索对象。 |
HEAD 对象 |
检索对象的头。 |
OPTIONS 对象 |
检查 CORS 配置以确定是否可以发送特定请求。 |
PUT 对象 |
将对象添加到存储区。 |
PUT Object (Copy) |
创建对象的副本。 |
| Begin Multipart Upload | 为要上传的一组分块创建一个上传标识。 |
| Upload Part | 上传与上传标识关联的对象的分块。 |
| Upload Part (Copy) | 上传与上传标识关联的现有对象的分块。 |
| Complete Multipart Upload | 将与一个上传标识关联的分块组合成对象。 |
| Cancel Multipart Upload | 取消上传并删除与上传标识关联的待处理分块。 |
| List Parts | 返回与上传标识关联的分块的列表。 |
有关 IBM Cloud Object Storage 功能部件和用例的更多信息，请参阅 ibm.com。