兼容接口
更新时间：2026-09-09
Service API
AWS S3 接口支持情况如下：
| AWS S3 接口 | 兼容情况 | 说明 |
|---|---|---|
| GET Service/List Buckets | 兼容 | 用于列出当前账号可访问的 Bucket 列表。 |
Bucket API
AWS S3 接口支持情况如下。涉及生命周期、日志、CORS、Website、请求者付费、版本控制等配置类接口时，请求体以 BOS JSON 结构为准。
| AWS S3 接口 | 兼容情况 | 说明 |
|---|---|---|
| DELETE Bucket | 兼容 | 删除 Bucket 前需确保 Bucket 为空；启用版本控制时需先删除对象版本。 |
| GET Bucket/List Objects | 兼容 | 兼容 GET Bucket (List Objects) Version 1。 |
| GET Bucket acl | 兼容 | 用于查询 Bucket ACL。 |
| GET Bucket Location | 兼容 | 用于查询 Bucket 所属区域。 |
| HEAD Bucket | 兼容 | 用于确认 Bucket 是否存在。 |
| List Multipart Uploads | 兼容 | 用于查询 Bucket 中未完成的分片上传任务。 |
| PUT Bucket | 部分兼容 | 未支持 x-amz-grant-*。 |
| PUT Bucket ACL | 兼容 | 支持通过兼容请求头设置 ACL，例如 x-amz-acl。 |
| List Objects | 兼容 | 用于列举 Bucket 中的对象。 |
| List Objects V2 | 部分兼容 | 未支持 fetch-owner。 |
| OPTIONS | 兼容 | 受 Bucket CORS 配置控制；未配置匹配的 CORS 规则时，预检请求可能返回拒绝。 |
| PUT Bucket LifeCycle | 部分兼容 | 兼容生命周期配置，同时支持配置多版本、标签生命周期；未支持配置 NoncurrentVersionTransition、ObjectSizeGreaterThan、ObjectSizeLessThan。 |
| GET Bucket LifeCycle | 兼容 | 用于查询 Bucket 生命周期配置。 |
| DELETE Bucket LifeCycle | 兼容 | 用于删除 Bucket 生命周期配置。 |
| PUT Bucket Logging | 部分兼容 | 仅支持配置 TargetBucket、TargetPrefix；使用 BOS JSON 请求体时，对应字段为 targetBucket、targetPrefix。 |
| GET Bucket Logging | 兼容 | 用于查询 Bucket Logging 配置。 |
| PUT Bucket Cors | 兼容 | 使用 BOS JSON 请求体配置 CORS 规则。 |
| GET Bucket Cors | 兼容 | 用于查询 Bucket CORS 配置。 |
| DELETE Bucket Cors | 兼容 | 用于删除 Bucket CORS 配置。 |
| PUT Bucket Website | 部分兼容 | 仅支持配置 ErrorDocument、IndexDocument；使用 BOS JSON 请求体时，对应字段为 notFound、index。 |
| GET Bucket Website | 兼容 | 用于查询 Bucket Website 配置。 |
| DELETE Bucket Website | 兼容 | 用于删除 Bucket Website 配置。 |
| PUT Bucket RequestPayment | 兼容 | 使用 BOS JSON 请求体配置请求者付费。 |
| GET Bucket RequestPayment | 兼容 | 用于查询请求者付费配置。 |
| PUT Bucket Versioning | 兼容 | 使用 BOS JSON 请求体配置 Bucket 版本控制状态。 |
| GET Bucket Versioning | 兼容 | 用于查询 Bucket 版本控制状态。 |
| List Object Version | 兼容 | 用于列举对象版本。 |
Object API
AWS S3 接口支持情况如下。下表中的“未支持”表示未支持 AWS S3 对应功能语义；服务端是否接收相关请求头不作为功能兼容依据。
| AWS S3 接口 | 兼容情况 | 说明 |
|---|---|---|
| DELETE Object | 部分兼容 | 未支持 x-amz-mfa。 |
| DELETE Multiple Objects | 部分兼容 | 未支持 x-amz-mfa。 |
| GET Object | 兼容 | 用于获取对象内容。 |
| HEAD Object | 部分兼容 | 未支持 x-amz-server-side-encryption-*。 |
| PUT Object | 部分兼容 | 未支持 x-amz-grant-*、x-amz-server-side-encryption-* 的 AWS 功能语义；x-amz-storage-class 支持 STANDARD、STANDARD_IA。 |
| PUT Object - Copy | 兼容 | 用于复制对象。 |
| Abort Multipart Upload | 兼容 | 用于终止分片上传任务。 |
| Complete Multipart Upload | 兼容 | 用于完成分片上传任务。 |
| Initiate Multipart Upload | 部分兼容 | 未支持 x-amz-grant-*、x-amz-server-side-encryption-*；x-amz-storage-class 支持 STANDARD、STANDARD_IA。 |
| List Parts | 兼容 | 用于列举已上传的分片。 |
| Upload Part | 部分兼容 | 未支持 x-amz-server-side-encryption-*。 |
| Upload Part Copy | 兼容 | 用于通过复制对象内容上传分片。 |
| POST Object | 兼容 | 用于表单方式上传对象。 |
| OPTIONS Object | 兼容 | 用于对象级跨域预检请求。 |
| POST Object restore | 部分兼容 | 仅支持配置 Days 和 GlacierJobParameters。 |
| PUT Object Acl | 兼容 | 用于设置对象 ACL。 |
| GET Object Acl | 兼容 | 用于查询对象 ACL。 |
| PUT Object Tagging | 兼容 | 用于设置对象标签。 |
| GET Object Tagging | 兼容 | 用于查询对象标签。 |
| DELETE Object Tagging | 兼容 | 用于删除对象标签。 |
评价此篇文章