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

启动多部件上传

贡献者

启动多部分上传(CreateMultipartUpload)操作将启动对象的多部分上传、并返回上传ID。

x-amz-storage-class 支持请求标头。为提交的值 x-amz-storage-class 影响StorageGRID 在载入期间保护对象数据的方式、而不影响StorageGRID 系统中存储的对象持久副本数(由ILM决定)。

如果与已载入对象匹配的ILM规则对载入行为使用strict选项、则为 x-amz-storage-class 标题无效。

可以使用以下值 x-amz-storage-class

  • STANDARD (默认)

    • * 双提交 * :如果 ILM 规则为载入行为指定了双提交选项,则在载入对象后,系统会立即创建该对象的第二个副本并将其分发到其他存储节点(双提交)。评估ILM时、StorageGRID 会确定这些初始临时副本是否符合规则中的放置说明。否则、可能需要在不同位置创建新对象副本、并且可能需要删除初始临时副本。

    • 已平衡:如果ILM规则指定了已平衡选项、而StorageGRID 无法立即创建规则中指定的所有副本、则StorageGRID 会在不同的存储节点上创建两个临时副本。

      如果StorageGRID 可以立即创建ILM规则(同步放置)中指定的所有对象副本、则会显示 x-amz-storage-class 标题无效。

  • REDUCED_REDUNDANCY

    • * 双提交 * :如果 ILM 规则为载入行为指定了双提交选项,则 StorageGRID 会在载入对象时创建一个临时副本(单个提交)。

    • 均衡:如果ILM规则指定了均衡选项,则只有当系统无法立即创建规则中指定的所有副本时,StorageGRID 才会创建一个临时副本。如果 StorageGRID 可以执行同步放置,则此标头不起作用。。 REDUCED_REDUNDANCY 如果与对象匹配的ILM规则创建一个复制副本、则最好使用选项。在这种情况下、使用 REDUCED_REDUNDANCY 无需在每次载入操作中创建和删除额外的对象副本。

    使用 REDUCED_REDUNDANCY 在其他情况下、不建议使用此选项。 REDUCED_REDUNDANCY 增加载入期间对象数据丢失的风险。例如,如果最初将单个副本存储在发生故障的存储节点上,而此存储节点未能进行 ILM 评估,则可能会丢失数据。

重要说明 在任何一段时间内只复制一个副本会使数据面临永久丢失的风险。如果某个对象只存在一个复制副本,则在存储节点出现故障或出现严重错误时,该对象将丢失。在升级等维护过程中,您还会暂时失去对对象的访问权限。

指定 REDUCED_REDUNDANCY 仅影响首次载入对象时创建的副本数。它不会影响在活动 ILM 策略评估对象时创建的对象副本数,也不会导致数据在 StorageGRID 系统中以较低的冗余级别存储。

备注 如果要在启用了S3对象锁定的情况下将对象载入存储分段、则会显示 REDUCED_REDUNDANCY 选项将被忽略。如果要将对象载入旧的合规存储分段、则会显示 REDUCED_REDUNDANCY 选项返回错误。StorageGRID 将始终执行双提交载入,以确保满足合规性要求。

支持以下请求标头:

  • Content-Type

  • x-amz-meta-、后跟一个名称-值对、该对包含用户定义的元数据

    为用户定义的元数据指定名称 - 值对时,请使用以下通用格式:

    x-amz-meta-_name_: `value`

    如果要使用*用户定义的创建时间*选项作为ILM规则的参考时间、则必须使用 creation-time 作为创建对象时记录的元数据的名称。例如:

    x-amz-meta-creation-time: 1443399726

    的值 creation-time 评估为自1970年1月1日以来的秒数。

    备注 正在添加 creation-time 由于在将对象添加到启用了旧合规性的存储分段时不允许使用用户定义的元数据。此时将返回错误。
  • S3 对象锁定请求标头:

    • x-amz-object-lock-mode

    • x-amz-object-lock-retain-until-date

    • x-amz-object-lock-legal-hold

      如果在不使用这些标题的情况下发出请求,则存储分段默认保留设置用于计算对象版本 retain-until 日期。

  • SSA 请求标头:

    • x-amz-server-side-encryption

    • x-amz-server-side-encryption-customer-key-MD5

    • x-amz-server-side-encryption-customer-key

    • x-amz-server-side-encryption-customer-algorithm

    备注 有关StorageGRID 如何处理UTF-8字符的信息、请参见Put对象的文档。

服务器端加密的请求标头

您可以使用以下请求标头通过服务器端加密对多部分对象进行加密。SSE 和 SSI-C 选项是互斥的。

  • * SSE* :如果要使用 StorageGRID 管理的唯一密钥对对象进行加密,请在 " 启动多部分上传请求 " 中使用以下标题。请勿在任何上传部件请求中指定此标题。

    • x-amz-server-side-encryption

  • * SSI-C* :如果要使用您提供和管理的唯一密钥对对象进行加密,请在 " 启动多部件上传请求 " (以及后续的每个 " 上传部件请求 " )中使用所有这三个标头。

    • x-amz-server-side-encryption-customer-algorithm:指定 AES256

    • x-amz-server-side-encryption-customer-key:指定新对象的加密密钥。

    • x-amz-server-side-encryption-customer-key-MD5:指定新对象加密密钥的MD5摘要。

重要说明 您提供的加密密钥永远不会存储。如果丢失加密密钥,则会丢失相应的对象。在使用客户提供的密钥保护对象数据之前、请查看的注意事项 "使用服务器端加密"

请求标头不受支持

不支持以下请求标头、并返回 XNotImplemented

  • x-amz-website-redirect-location

版本控制

多部分上传包括启动上传,发布上传,上传部件,组装上传的部件以及完成上传的操作。在执行完整的多部件上传操作时,系统会创建对象(如果适用,还会进行版本控制)。