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

CopyObject

贡献者 netapp-lhalbert netapp-madkat
PDF

您可以使用S3 CopyObject请求为已存储在S3中的对象创建副本。CopyObject操作与依次执行GetObject和PutObject相同。

解决冲突

冲突的客户端请求（例如，两个客户端写入同一密钥）将以 " 最新成功 " 为基础进行解决。" 最新赢单 " 评估的时间取决于 StorageGRID 系统何时完成给定请求，而不是 S3 客户端何时开始操作。

对象大小

一个PutObject操作的最大_Recommended_大小为5 GiB (5、368、709、120字节)。如果您的对象大于5 GiB、请使用 "多部分上传" 而是。

一个PutObject操作的最大_supported_大小为5 TiB (5、497、555、138、880字节)。

备注 如果您从StorageGRID 11.5或更早版本升级、则在尝试上传超过5 GiB的对象时、将触发S3 Put Object Size Too Liger警报。如果您全新安装了StorageGRID 11.7或11.7、则在这种情况下不会触发警报。但是、为了符合AWS S3标准、未来版本的StorageGRID不支持上传超过5 GiB的对象。

用户元数据中的 UTF-8 字符

如果某个请求在用户定义的元数据的密钥名称或值中包含（未转义） UTF-8 值，则会未定义 StorageGRID 行为。

StorageGRID 不会解析或解释用户定义的元数据的密钥名称或值中包含的转义 UTF-8 字符。转义的 UTF-8 字符被视为 ASCII 字符：

  • 如果用户定义的元数据包含转义的 UTF-8 字符，则请求将成功。

  • StorageGRID 不会返回 x-amz-missing-meta 如果对密钥名称或值的解释值包含不可打印的字符、则为标题。

支持的请求标头

支持以下请求标头：

  • Content-Type

  • x-amz-copy-source

  • x-amz-copy-source-if-match

  • x-amz-copy-source-if-none-match

  • x-amz-copy-source-if-unmodified-since

  • x-amz-copy-source-if-modified-since

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

  • x-amz-metadata-directive：默认值为 COPY、用于复制对象和关联的元数据。

    您可以指定 REPLACE 复制对象时覆盖现有元数据、或者更新对象元数据。

  • x-amz-storage-class

  • x-amz-tagging-directive：默认值为 COPY、用于复制对象和所有标记。

    您可以指定 REPLACE 可在复制对象时覆盖现有标记、或更新标记。

  • S3 对象锁定请求标头：

    • x-amz-object-lock-mode

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

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

      如果在发出请求时没有这些标头、则会使用存储分段默认保留设置来计算对象版本模式和保留截止日期。请参见 "使用S3 REST API配置S3对象锁定"。

  • SSA 请求标头：

    • x-amz-copy-source​-server-side​-encryption​-customer-algorithm

    • x-amz-copy-source​-server-side-encryption-customer-key

    • x-amz-copy-source​-server-side-encryption-customer-key-MD5

    • 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

      请参见 服务器端加密的请求标头

请求标头不受支持

不支持以下请求标头：

  • Cache-Control

  • Content-Disposition

  • Content-Encoding

  • Content-Language

  • Expires

  • x-amz-website-redirect-location

存储类选项

。 x-amz-storage-class 支持请求标头、如果匹配的ILM规则使用"双提交"或"已平衡"、则会影响StorageGRID创建的对象副本数 ""INGest"选项"。

  • STANDARD

    （默认）指定在 ILM 规则使用双提交选项或 balanced-option 回退到创建中间副本时执行双提交载入操作。

  • REDUCED_REDUNDANCY

    指定在 ILM 规则使用双提交选项或 balanced-option 回退为创建中间副本时执行单提交载入操作。

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

在CopyObject中使用x-AMZ-copy-source

如果源存储分段和密钥、请在中指定 x-amz-copy-source 标头与目标分段和密钥不同、源对象数据的副本将写入目标。

如果源和目标匹配、则使用和 x-amz-metadata-directive 标头指定为 REPLACE、对象的元数据将使用请求中提供的元数据值进行更新。在这种情况下， StorageGRID 不会重新载入对象。这有两个重要后果：

  • 不能使用CopyObject原位加密现有对象、也不能更改原位现有对象的加密。如果您提供 x-amz-server-side-encryption 标题或 x-amz-server-side-encryption-customer-algorithm 标头、StorageGRID 拒绝请求并返回 XNotImplemented。

  • 不会使用匹配 ILM 规则中指定的 " 载入行为 " 选项。通过正常后台 ILM 进程重新评估 ILM 时，更新触发的任何对象放置更改都会进行。

    这意味着、如果ILM规则使用stricting选项执行加数据操作、则在无法放置所需对象(例如、新需要的位置不可用)时不会执行任何操作。更新后的对象会保留其当前位置，直到可以进行所需的位置为止。

服务器端加密的请求标头

如果您 "使用服务器端加密"，您提供的请求标头取决于源对象是否已加密以及是否计划加密目标对象。

  • 如果源对象使用客户提供的密钥(SSE-C)进行加密、则必须在CopyObject请求中包含以下三个标头、以便可以对该对象进行解密、然后进行复制：

    • x-amz-copy-source​-server-side​-encryption​-customer-algorithm：指定 AES256。

    • x-amz-copy-source​-server-side-encryption-customer-key：指定在创建源对象时提供的加密密钥。

    • x-amz-copy-source​-server-side-encryption-customer-key-MD5：指定在创建源对象时提供的MD5摘要。

  • 如果要使用您提供和管理的唯一密钥对目标对象（副本）进行加密，请包含以下三个标题：

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

    • x-amz-server-side-encryption-customer-key：为目标对象指定新的加密密钥。

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

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

  • 如果要使用由StorageGRID (SSE)管理的唯一密钥对目标对象(副本)进行加密，请在CopyObject请求中包括此标头：

    • x-amz-server-side-encryption

      备注 。 server-side-encryption 无法更新对象的值。而是使用新创建副本 server-side-encryption 价值使用 x-amz-metadata-directive： REPLACE。

版本控制

如果源存储分段已版本控制、则可以使用 x-amz-copy-source 用于复制最新版本对象的标题。要复制对象的特定版本、必须使用明确指定要复制的版本 versionId 子资源。如果目标存储分段已进行版本控制、则会在中返回生成的版本 x-amz-version-id 响应标头。如果目标分段的版本控制已暂停、则 x-amz-version-id 返回"null"值。