Amazon Simple Storage Service
开发人员指南 (API Version 2006-03-01)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。点 击 Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

复制对象

复制操作将创建已存储在 Amazon S3 中的对象的副本。在单个原子操作中,您可以创建最大 5 GB 的对象副本。但是,对于复制大于 5 GB 的对象,您必须使用分段上传 API。通过使用 copy 操作,您可以:

  • 创建对象的其他副本

  • 通过复制对象并删除原始对象来重命名它们。

  • 在不同的 Amazon S3 位置之间 (例如,us-west-1 和 EU) 移动对象

  • 更改对象元数据

    每个 Amazon S3 对象都带有元数据。它是一组名称值对。您可以在上传对象元数据时对其进行设置。上传对象后,您将无法修改对象元数据。修改对象元数据的唯一方式是创建对象的副本并设置元数据。在复制操作中,设置与源和目标相同的对象。

每个对象都带有元数据。有些是系统元数据,而另外一些则是用户定义的元数据。用户可以控制某些系统元数据,例如,用于对象的存储类别配置和配置服务器端加密。复制对象时,还会复制用户控制的系统元数据和用户定义的元数据。Amazon S3 将重设系统控制的元数据。例如,在复制对象时,Amazon S3 将重设已复制的对象的创建日期。在复制请求中,您无需设置这些值。

复制对象时,您可能会决定更新某些元数据值。例如,如果您的源对象被配置为使用标准存储,您可能会为对象复制选择低冗余存储。您可能还会决定更改源对象上某些用户定义的元数据值。请注意,如果您选择在复制期间更新任意对象的用户可配置元数据 (系统或用户定义的),则您必须显式地指定所有的用户可配置元数据,即使您只更改一个元数据的值 (显示在请求中源对象上)。

有关对象元数据的详细信息,请参阅 对象键和元数据

注意

复制不同位置上的对象将产生带宽费用。

注意

如果源对象在 Amazon Glacier 中 (对象的存储类别为 GLACIER) 进行存档,则必须首先还原临时副本,然后才能将对象复制到另一个存储桶。有关对象存档的更多信息,请参阅转换为 GLACIER 存储类 (对象存档)

在复制对象时,您可以请求 Amazon S3 保存使用 AWS 密钥管理服务 (KMS) 加密密钥、Amazon S3 托管加密密钥或客户提供的加密密钥加密的目标对象。因此您必须在您的请求中指定加密信息。如果复制源是通过客户提供的密钥使用服务器端加密存储在 Amazon S3 中的对象,则您需要在请求中提供加密信息,以便 Amazon S3 可以解密对象进行复制。有关更多信息,请参阅 使用加密保护数据

相关资源

本页内容: