Skip to main content
本产品推出了新版本。
简体中文版经机器翻译而成，仅供参考。如与英语版出现任何冲突，应以英语版为准。

StorageGRID S3 REST API 支持的版本和更新

PDF

StorageGRID 支持 Simple Storage Service (S3) API，该 API 作为一组表示性状态传输 (REST) Web 服务实现。

对 S3 REST API 的支持使您能够将为 S3 Web 服务开发的面向服务的应用程序与使用 StorageGRID 系统的本地对象存储相连接。只需对客户端应用程序当前使用的 S3 REST API 调用进行极少量更改。

支持的版本

StorageGRID 支持以下特定版本的 STS、S3 和 HTTP：

个项目 版本

STS AssumeRole API 规范

"Amazon Web Services (AWS) 文档：Amazon Assumerole API Reference"

有关 AssumeRole 的详细信息，请参阅 "设置 AssumeRole"。

S3 API 规范

"AWS 文档：Amazon Simple Storage Service API 参考"

HTTP

1.1

有关 HTTP 的详细信息，请参见 HTTP/1.1 (RFCs 7230-35)。

"IETF RFC 2616：超文本传输协议 (HTTP/1.1)"

注意：StorageGRID 不支持 HTTP/1.1 流水线。

S3 REST API 支持更新

版本 注释

12.0

  • 添加了对管理接口的跨源资源共享 (CORS) 支持，允许另一个域使用管理 API 访问 StorageGRID 中的数据。"了解更多"。

  • 添加了对 STS AssumeRole 和会话策略的支持。请参阅"会话策略的示例"。您可以在租户组下设置 AssumeRole。

11.9

  • 添加了对以下请求和支持的标头的预先计算的 SHA-256 校验和值的支持。您可以使用此功能验证上传对象的完整性：

    • CompleteMultipartUpload： x-amz-checksum-sha256

    • CreateMultipartUpload: x-amz-checksum-algorithm

    • GetObject: x-amz-checksum-mode

    • HeadObject： x-amz-checksum-mode

    • ListParts

    • PutObject: x-amz-checksum-sha256

    • UploadPart: x-amz-checksum-sha256

  • 添加了网格管理员控制租户级别保留和合规性设置的功能。这些设置会影响 S3 Object Lock 设置。

    • 存储桶默认保留模式和对象保留模式：治理或合规（如果网格管理员允许）。

    • 存储桶默认保留期限和对象保留截止日期：必须小于或等于网格管理员设置的最大保留期限所允许的值。

  • 改进了对 `aws-chunked`内容编码和流式传输 `x-amz-content-sha256`值的支持。限制：

    • 如果存在， `chunk-signature`是可选的且不经过验证

    • 如果存在，则忽略 `x-amz-trailer`内容

11.8

更新了 S3 操作的名称，以匹配 "Amazon Web Services (AWS) 文档：Amazon Simple Storage Service API 参考"中使用的名称。

11.7

  • 已添加 "快速参考：支持的 S3 API 请求"。

  • 增加了对 S3 Object Lock 使用 GOVERNANCE 模式的支持。

  • 添加了对 StorageGRID 特定 `x-ntap-sg-cgr-replication-status`响应标头的支持，适用于 GET Object 和 HEAD Object 请求。此标头为跨网格复制提供对象的复制状态。

  • SelectObjectContent 请求现在支持 Parquet 对象。

11.6

  • 新增了在 GET Object 和 HEAD Object 请求中使用 `partNumber`请求参数的支持。

  • 增加了对 S3 Object Lock 存储桶级别的默认保留模式和默认保留期限的支持。

  • 添加了对 `s3:object-lock-remaining-retention-days`策略条件键的支持，以设置对象的允许保留期范围。

  • 将单个 PUT Object 操作的最大_建议_大小更改为 5 GiB（5,368,709,120 字节）。如果您的对象大于 5 GiB，请改用分段上传。

11.5

  • 增加了对存储桶加密的管理支持。

  • 新增了对 S3 Object Lock 的支持，并弃用了旧版合规性请求。

  • 添加了对在版本化存储桶上使用DELETE Multiple Objects的支持。

  • The Content-MD5 请求标头现在已得到正确支持。

11.4

  • 增加了对 DELETE Bucket 标记、GET Bucket 标记和 PUT Bucket 标记的支持。不支持成本分配标签。

  • 对于在 StorageGRID 11.4 中创建的存储桶，不再需要限制对象密钥名称以满足性能最佳实践。

  • 添加了对 `s3:ObjectRestore:Post`事件类型的存储桶通知的支持。

  • AWS 对多部分部件的大小限制现已强制执行。多部分上传中的每个部分必须介于 5 MiB 和 5 GiB 之间。最后一部分可以小于 5 MiB。

  • 增加了对 TLS 1.3 的支持

11.3

  • 增加了对使用客户提供的密钥（SSE-C）的对象数据进行服务器端加密的支持。

  • 添加了对 DELETE、GET 和 PUT Bucket 生命周期操作（仅限 Expiration 操作）以及 `x-amz-expiration`响应标头的支持。

  • 更新了 PUT Object、PUT Object - Copy 和 Multipart Upload，以描述在接收时使用同步放置的 ILM 规则的影响。

  • TLS 1.1 加密不再受支持。

11.2

添加了对用于云存储池的 POST Object restore 的支持。添加了对在组和存储桶策略中使用 AWS 语法的 ARN、策略条件键和策略变量的支持。使用 StorageGRID 语法的现有组和存储桶策略将继续受到支持。

注意： 其他配置 JSON/XML（包括自定义 StorageGRID 功能中使用的配置）中 ARN/URN 的使用没有改变。

11.1

增加了对跨源资源共享(CORS)、S3 客户端连接到网格节点的 HTTP 以及存储桶上的合规性设置的支持。

11.0

添加了对存储桶配置平台服务（CloudMirror 复制、通知和 Elasticsearch 搜索集成）的支持。还添加了对存储桶的对象标记位置约束的支持，以及可用一致性。

10.4

添加了对 ILM 扫描更改版本控制、端点域名页面更新、策略中的条件和变量、策略示例以及 PutOverwriteObject 权限的支持。

10.3

添加了对版本控制的支持。

10.2

增加了对组和存储桶访问策略以及分段复制（Upload Part - Copy）的支持。

10.1

增加了对多部分上传、虚拟托管式请求和 v4 身份验证的支持。

10.0

StorageGRID 系统对 S3 REST API 的初始支持。Simple Storage Service API Reference 当前支持的版本为 2006-03-01。