S3 API 兼容性

本页面记录 MinIO 对象存储支持的 S3 API。如需查看任意 API 的参考文档，请参阅 Amazon S3 的对应文档。

警告

重要

MinIO 强烈建议使用 S3 兼容 SDK 执行对象存储操作。

对象 API

对象锁定

不支持的 API 对象端点

GetObjectAcl
PutObjectAcl

多部分上传

与 S3 API 在多部分上传方面的差异

ListMultipartUploads 当前把非空 prefix 当成精确对象名，而不是词法对象键前缀。
prefix 为空时，结果来自节点本地的易失状态，并不具备 AWS 兼容的分页、marker 或 delimiter 行为。已验证的影响与修复方案参见 Issue #79 设计与决策记录。
PutBucketLifecycle 不支持 AbortIncompleteMultipartUpload 生命周期动作。

存储桶 API

存储桶复制

存储桶生命周期

存储桶通知

存储桶策略

不支持的 API 存储桶操作

GetBucketInventoryConfiguration
PutBucketInventoryConfiguration
DeleteBucketInventoryConfiguration
PutBucketCors
DeleteBucketCors
GetBucketMetricsConfiguration
PutBucketMetricsConfiguration
DeleteBucketMetricsConfiguration
PutBucketWebsite
GetBucketLogging
PutBucketLogging
PutBucketAccelerateConfiguration
DeleteBucketAccelerateConfiguration
PutBucketRequestPayment
DeleteBucketRequestPayment
PutBucketAcl
HeadBucketAcl
GetPublicAccessBlock
PutPublicAccessBlock
DeletePublicAccessBlock
GetBucketOwnershipControls
PutBucketOwnershipControls
DeleteBucketOwnershipControls
GetBucketIntelligentTieringConfiguration
PutBucketIntelligentTieringConfiguration
ListBucketIntelligentTieringConfigurations
DeleteBucketIntelligentTieringConfiguration
GetBucketAnalyticsConfiguration
PutBucketAnalyticsConfiguration
ListBucketAnalyticsConfigurations
DeleteBucketAnalyticsConfiguration
CreateSession

MinIO 针对不支持的存储桶资源的替代方案

对于 BucketACL 或 ObjectACL 操作调用，请使用 Policies。
不需要 BucketCORS 操作调用，因为默认情况下所有存储桶都已为所有 HTTP 动词启用 CORS。
对于 BucketWebsite 操作调用，请使用 caddy 或 nginx。
对于 BucketAnalytics、BucketMetrics 或 BucketLogging 操作调用，请使用存储桶通知。

加载评论需要启用 JavaScript。在 GitHub 上查看讨论。