复制、移动和重命名对象
CopyObject
操作将创建已存储在 Amazon S3 中的对象的副本。
在单个原子操作中,您可以创建最大 5GB 的对象副本。但是,要复制大于 5GB 的对象,您必须使用分段上传。有关更多信息,请参阅 使用分段上传复制对象。
通过使用 CopyObject
操作,您可以:
-
创建对象的其它副本。
-
通过复制对象并删除原始对象来重命名它们。
-
将对象从一个存储桶复制或移动到另一个存储桶,包括跨 Amazon Web Services 区域(例如,从
us-west-1
到eu-west-2
)。移动对象时,Amazon S3 将对象复制到指定目标,然后删除源对象。注意
跨 Amazon Web Services 区域复制或移动对象会产生带宽费用。有关更多信息,请参阅 Amazon S3 定价
。 -
更改对象元数据。每个 Amazon S3 对象都有元数据。此元数据是一组名称/值对。您可以在上传对象时设置对象元数据。上传对象后,您将无法修改对象元数据。修改对象元数据的唯一方式是创建对象的副本并设置元数据。为此,在复制操作中,将相同的对象设置为源和目标。
有些对象元数据是系统元数据,而另外一些则是用户定义的元数据。您可以控制某些系统元数据。例如,您可以控制要用于对象的存储类和服务器端加密的类型。复制对象时,还会复制用户控制的系统元数据和用户定义的元数据。Amazon S3 将重置系统控制的元数据。例如,在复制对象时,Amazon S3 将重置已复制对象的创建日期。您不需要在复制请求中设置任何这些系统控制的元数据值。
复制对象时,您可能会决定更新某些元数据值。例如,如果您的源对象被配置为使用 S3 Standard 存储,您可以选择对对象复制使用 S3 Intelligent-Tiering。您可能还会决定更改源对象上某些用户定义的元数据值。请注意,如果您选择在复制期间更新任意对象的用户可配置元数据(系统或用户定义的元数据),则必须显式指定请求中源对象上存在的所有用户可配置的元数据,即使您只更改其中一个元数据值也是如此。
有关对象元数据的详细信息,请参阅 使用对象元数据。
复制已存档和已还原的对象
如果源对象归档在 S3 Glacier Flexible Retrieval 或 S3 Glacier Deep Archive 中,您必须先还原临时副本,然后才能将对象复制到另一个存储桶中。有关对象归档的更多信息,请参阅 转换为 S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive 存储类(对象存档)。
在 Amazon S3 控制台中,不支持对 S3 Glacier Flexible Retrieval 或 S3 Glacier Deep Archive 存储类中的已还原对象执行复制操作。要复制这些已还原对象,请使用 Amazon Command Line Interface(Amazon CLI)、Amazon SDK 或 Amazon S3 REST API。
复制加密对象
Amazon S3 会自动加密所有复制到 S3 存储桶的新对象。如果您未在复制请求中指定加密信息,则目标对象的加密设置将设为目标存储桶的默认加密配置。默认情况下,所有存储桶都有基本级别的加密配置,该配置使用具有 Amazon S3 托管密钥的服务器端加密(SSE-S3)。如果目标存储桶的默认加密配置使用具有 Amazon Key Management Service(Amazon KMS)密钥(SSE-KMS)或客户提供加密密钥(SSE-C)的服务器端加密,则 Amazon S3 使用相应的 KMS 密钥或客户提供的密钥来加密目标对象副本。
在复制对象时,如果您希望对目标对象使用其他类型的加密设置,您可以请求 Amazon S3 使用 KMS 密钥、Amazon S3 托管式密钥或客户提供的密钥对目标对象加密。如果您的请求中的加密设置与目标存储桶的默认加密配置不同,则您的请求中的加密设置优先。如果副本的源对象是用 SSE-C 加密的,您必须在请求中提供必需的加密信息,以便 Amazon S3 可以解密对象以进行复制。有关更多信息,请参阅 利用加密来保护数据。
复制对象时使用校验和
复制对象时,可以选择对对象使用不同的校验和算法。无论您选择使用相同的算法还是新算法,Amazon S3 都会在复制对象后计算一个新的校验和值。Amazon S3 不会直接复制校验和的值。通过使用分段上传加载的对象的校验和值可能会发生变化。有关如何计算此校验和的更多信息,请参阅使用分段级别墅校验和进行分段上传。
在单个请求中复制多个对象
要使用单个请求复制多个 Amazon S3 对象,您还可以使用 S3 批量操作。您为 S3 批量操作提供要操作的对象列表。S3 批量操作调用相应的 API 操作来执行指定的操作。单个批量操作任务可对包含 EB 级数据的数十亿个对象执行指定操作。
S3 批量操作特征包括跟踪进度、发送通知并存储所有操作的详细完成报告,从而提供完全托管、可审核的无服务器体验。您可以通过 Amazon S3 控制台、Amazon CLI、Amazon SDK 或 REST API 使用 S3 批量操作。有关更多信息,请参阅 S3 批量操作基础知识。
将对象复制到目录存储桶
有关将对象复制到目录存储桶的信息,请参阅将对象复制到目录存储桶。有关将 Amazon S3 Express One Zone 存储类与目录存储桶结合使用的信息,请参阅什么是 S3 Express One Zone?和目录桶。
复制对象
要复制对象,请使用以下方法。
注意
-
使用 Amazon S3 控制台复制对象时,您必须具有
s3:ListAllMyBuckets
权限。控制台需要此权限以验证复制操作。有关授予此权限的示例策略,请参阅Amazon S3 基于身份的策略示例。如果您要复制具有用户定义标签的对象,您还必须拥有
s3:GetObjectTagging
权限。如果您要复制的对象没有用户定义的标签,但大小超过 16 MB,您还必须拥有 s3:GetObjectTagging
权限。如果目标存储桶策略拒绝
s3:GetObjectTagging
操作,则会复制对象,但不包含用户定义的标签,并且您将收到错误。 -
无法使用 S3 控制台复制使用客户提供的加密密钥(SSE-C)加密的对象。要复制使用 SSE-C 加密的对象,请使用 Amazon CLI、Amazon SDK 或 Amazon S3 REST API。
-
Amazon S3 控制台不支持跨区域复制使用 SSE-KMS 加密的对象。要跨区域复制使用 SSE-KMS 加密的对象,请使用 Amazon CLI、Amazon SDK 或 Amazon S3 REST API。
复制对象
登录到 Amazon Web Services Management Console,然后通过以下网址打开 Amazon S3 控制台:https://console.aws.amazon.com/s3/
。 -
在左侧导航窗格中,选择存储桶,然后选择通用存储桶选项卡。导航到包含待复制对象的 Amazon S3 存储桶或文件夹。
-
选中要复制的对象名称左侧的复选框。
-
在操作菜单上,从显示的选项列表中选择复制。
-
选择目标类型和目标账户。要指定目标路径,请选择 Browse S3(浏览 S3),导航到目标,然后选中目标左侧的复选框。选择右下角的选择目标。
或者,输入目标路径。
-
如果未启用存储桶版本控制,则系统可能会要求您确认是否覆盖具有相同名称的现有对象。如果可以覆盖,请选中该复选框并继续。如果要在此存储桶中保留对象的所有版本,请选择 Enable Bucket Versioning(启用存储桶版本控制)。您还可以更新默认加密和 S3 对象锁定属性。
-
在 Additional checksums(其他校验和)下,选择是要使用现有校验和函数复制对象,还是用新校验和函数替换现有校验和函数。上传对象时,您可以选择指定用于验证数据完整性的校验和算法。复制对象时,您可以选择新函数。如果您最初没有指定额外的校验和,则可以使用复制选项的这一部分添加一个校验和。
注意
即使您选择使用相同的校验和函数,如果您复制对象且对象大小超过 16 MB,校验和值也可能会发生变化。由于分段上传的校验和计算方式的原因,校验和值可能会发生变化。有关在复制对象时校验和可能会如何变化的信息,请参阅使用分段级别墅校验和进行分段上传。
要更改校验和函数,请选择用新的校验和函数替换。从框中选择新的校验和函数。复制对象时,将使用指定的算法计算和存储新校验和。
-
选择右下角的复制。Amazon S3 会将对象复制到目标。
本节中的示例向您展示了如何复制单个操作中大于 5 GB 的对象。要复制大于 5GB 的对象,您必须使用分段上传。有关更多信息,请参阅 使用分段上传复制对象。
本示例描述了如何使用 Amazon S3 REST API 复制对象。有关 REST API 的更多信息,请参阅CopyObject。
本示例将 flotsam
存储桶中的
对象复制到 example-s3-bucket1
jetsam
存储桶的
对象,同时保留其元数据。example-s3-bucket2
PUT /jetsam HTTP/1.1 Host:
example-s3-bucket2
.s3.amazonaws.com x-amz-copy-source: /example-s3-bucket1
/flotsam Authorization: AWS AKIAIOSFODNN7EXAMPLE:ENoSbxYByFA0UGLZUqJN5EUnLDg= Date: Wed, 20 Feb 2008 22:12:21 +0000
将从以下信息生成签名。
PUT\r\n \r\n \r\n Wed, 20 Feb 2008 22:12:21 +0000\r\n x-amz-copy-source:/
example-s3-bucket1
/flotsam\r\n /example-s3-bucket2
/jetsam
Amazon S3 将返回以下响应来指定对象的 ETag 及其上次修改的时间。
HTTP/1.1 200 OK x-amz-id-2: Vyaxt7qEbzv34BnSu5hctyyNSlHTYZFMWK4FtzO+iX8JQNyaLdTshL0KxatbaOZt x-amz-request-id: 6B13C3C5B34AF333 Date: Wed, 20 Feb 2008 22:13:01 +0000 Content-Type: application/xml Transfer-Encoding: chunked Connection: close Server: AmazonS3 <?xml version="1.0" encoding="UTF-8"?> <CopyObjectResult> <LastModified>2008-02-20T22:13:01</LastModified> <ETag>"7e9c608af58950deeb370c98608ed097"</ETag> </CopyObjectResult>
也可以使用 Amazon Command Line Interface(Amazon CLI)复制 S3 对象。有关更多信息,请参阅 Amazon CLI 命令参考 中的 copy-object
有关 Amazon CLI 的更多信息,请参阅《Amazon Command Line Interface 用户指南》中的什么是 Amazon Command Line Interface?。
移动对象
要移动对象,请使用以下方法。
注意
-
如果您要移动具有用户定义标签的对象,您还必须拥有
s3:GetObjectTagging
权限。如果您要移动的对象没有用户定义的标签,但大小超过 16 MB,您还必须拥有 s3:GetObjectTagging
权限。如果目标存储桶策略拒绝
s3:GetObjectTagging
操作,则将在没有用户定义标签的情况下移动对象,并且您将收到错误。 -
无法使用 Amazon S3 控制台移动使用客户提供的加密密钥(SSE-C)加密的对象。要移动使用 SSE-C 加密的对象,请使用 Amazon CLI、Amazon SDK 或 Amazon S3 REST API。
-
移动文件夹时,请等待移动操作完成,然后再对文件夹进行其它更改。
-
您不能使用 S3 接入点别名作为 Amazon S3 控制台中移动操作的源或目标。
移动对象
-
登录到Amazon Web Services Management Console,然后通过以下网址打开 Amazon S3 控制台:https://console.aws.amazon.com/s3/
。 -
在左侧导航窗格中,选择存储桶,然后选择通用存储桶选项卡。导航到包含待移动对象的 Amazon S3 存储桶或文件夹。
-
选中要移动的对象名称左侧的复选框。
-
在操作菜单上,选择移动。
-
要指定目标路径,请选择 Browse S3(浏览 S3),导航到目标,然后选中目标左侧的复选框。选择右下角的选择目标。
或者,输入目标路径。
-
如果未启用存储桶版本控制,则系统可能会要求您确认是否覆盖具有相同名称的现有对象。如果可以覆盖,请选中该复选框并继续。如果要在此存储桶中保留对象的所有版本,请选择 Enable Bucket Versioning(启用存储桶版本控制)。您还可以更新默认加密和对象锁定属性。
-
选择右下角的移动。Amazon S3 将您的对象移动到目标位置。
注意
-
此操作创建具有更新设置的所有指定对象的副本,更新指定位置的上次修改日期,然后向原始对象添加删除标记。
-
此操作会更新存储桶版本控制、加密、对象锁定特征和归档对象的元数据。
您也可以使用 Amazon Command Line Interface(Amazon CLI)移动 S3 对象。有关更多信息,请参阅 Amazon CLI 命令参考 中的 mv
有关 Amazon CLI 的更多信息,请参阅《Amazon Command Line Interface 用户指南》中的什么是 Amazon Command Line Interface?。
重命名对象
要重命名对象,请使用以下过程。
注意
-
重命名对象将创建具有新的上次修改日期的对象副本,然后在原始对象上添加删除标记。
-
默认加密的存储桶设置会自动应用于任何未加密的指定对象。
-
您无法使用 Amazon S3 控制台来重命名采用客户提供的加密密钥(SSE-C)的对象。要重命名使用 SSE-C 加密的对象,请使用 Amazon CLI、Amazon SDK 或 Amazon S3 REST API 以新名称复制这些对象。
-
如果此存储桶的 S3 对象所有权使用强制存储桶拥有者设置,则不会复制对象访问控制列表(ACL)。
-
如果您要重命名具有用户定义标签的对象,您必须拥有
s3:GetObjectTagging
权限。如果您要重命名的对象没有用户定义的标签,但大小超过 16 MB,您还必须拥有 s3:GetObjectTagging
权限。如果目标存储桶策略拒绝
s3:GetObjectTagging
操作,则将重命名对象,但将从该对象中移除用户定义的标签,并且您将收到错误。
重命名对象
登录到Amazon Web Services Management Console,然后通过以下网址打开 Amazon S3 控制台:https://console.aws.amazon.com/s3/
。 -
在左侧导航窗格中,选择存储桶,然后选择通用存储桶选项卡。导航到包含待重命名的对象的 Amazon S3 存储桶或文件夹。
-
选中要重命名的对象名称左侧的复选框。
-
在操作菜单中,选择重命名对象。
-
在新对象名称框中,输入对象的新名称。
-
选择右下角的保存更改。Amazon S3 随即重命名您的对象。