使用对象元数据 - Amazon Simple Storage Service
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

欢迎使用新的 Amazon S3 用户指南! Amazon S3 用户指南结合了以下三个已停用的指南中的信息和说明:Amazon S3 开发人员指南Amazon S3 控制台用户指南Amazon S3 入门指南

使用对象元数据

您可以在上传对象时在 Amazon S3 中设置对象元数据。对象元数据是一组名称值对。上传对象后,您将无法修改对象元数据。修改对象元数据的唯一方式是创建对象的副本并设置元数据。

创建对象时,还要指定键名,它在存储桶中唯一地标识该对象。对象键(或键名称)唯一标识 Amazon S3 存储桶中的对象。有关更多信息,请参阅 创建对象键名称

Amazon S3 中有两种元数据:系统定义的元数据用户定义的元数据。以下各节提供了有关系统定义和用户定义元数据的更多信息。有关使用 Amazon S3 控制台编辑元数据的更多信息,请参阅在 Amazon S3 控制台中编辑对象元数据

系统定义的对象元数据

对存储桶中存储的每个对象,Amazon S3 将保留一组系统元数据。Amazon S3 将根据需要处理此系统元数据。例如,Amazon S3 将保留数据元创建日期和大小元数据并将此信息用作数据元管理的一部分。

有两种类别的系统元数据:

  1. 元数据(例如对象创建日期)受系统控制,仅 Amazon S3 可以在其中修改该值。

  2. 其他系统元数据 (例如为对象配置的存储类以及指示对象是否已启用服务器端加密的数据) 是您可以控制其值的系统元数据的示例。如果您的存储桶配置为网站,有时您可能想要将页面请求重定向到其他页面或外部 URL。在这种情况下,网页就是您的存储桶中的对象。Amazon S3 将存储页面重定向值作为您可以控制其值的系统元数据。

    创建对象时,您可以配置这些系统元数据项目的值或在需要时更新这些值。有关存储类别的更多信息,请参阅 使用 Amazon S3 存储类

    有关服务器端加密的更多信息,请参阅使用加密保护数据

注意

PUT 请求标头的大小限制为 8 KB。在 PUT 请求标头中,系统定义的元数据的大小限制为 2 KB。通过计算每个键和值的 US-ASCII 编码中的字节总数来测量系统定义的元数据的大小。

下表提供了系统定义的元数据列表以及您是否可以更新它。

名称 描述 用户是否可以修改该值?
日期 当前日期和时间。
内容长度 对象大小以字节为单位。
Content-Type 对象类型。
上次修改日期

对象创建日期或上次修改日期 (以较晚者为准)。

Content-MD5 对象的 base64 编码的 128 位 MD5 摘要。
x-amz-server-side-encryption 指示是否为对象启用了服务器端加密,以及加密是来自 AWS Key Management Service (AWS KMS) 还是来自 Amazon S3 托管加密 (SSE-S3)。有关更多信息,请参阅 使用服务器端加密保护数据
x-amz-version-id 对象版本。在存储桶上启用版本控制时,Amazon S3 会为添加到存储桶的对象指定版本号。有关更多信息,请参阅 在 S3 存储桶中使用版本控制
x-amz-delete-marker 在启用版本控制的存储桶中,此布尔值标记指示对象是否为删除标记。
x-amz-storage-class 用于存储对象的存储类。有关更多信息,请参阅 使用 Amazon S3 存储类
x-amz-website-redirect-location 将相关联的对象的请求重定向到同一存储桶中的其他对象或外部 URL。有关更多信息,请参阅 (可选)配置网页重定向
x-amz-server-side-encryption-aws-kms-key-id 如果 x-amz-server-side-encryption 存在并具有值 aws:kms,则这表示用于对象的 AWS KMS 对称客户主密钥 (CMK) 的 ID。
x-amz-server-side-encryption-customer-algorithm 指示是否启用了具有客户提供的加密密钥的服务器端加密 (SSE-C)。有关更多信息,请参阅 通过使用客户提供的加密密钥的服务器端加密 (SSE-C) 保护数据

用户定义的对象元数据

上传对象时,您也可以将元数据指定给该对象。发送 PUT 或 POST 请求创建对象时,您将以名称-值 (键-值) 对的形式提供此可选信息。如果使用 REST API 上传对象,可选的用户定义的元数据名称必须以“x-amz-meta-”开头,以与其他 HTTP 标头区分开来。使用 REST API 检索对象时,将返回此前缀。如果使用 SOAP API 上传对象则无需前缀。使用 SOAP API 检索对象时,无论您使用哪种 API 上传对象,都将删除前缀。

注意

HTTP 上的 SOAP 支持已弃用,但是仍可在 HTTPS 上使用。不支持将新 Amazon S3 功能用于 SOAP。我们建议您使用 REST API 或 AWS 开发工具包。

通过 REST API 检索元数据时,Amazon S3 会将具有相同名称(不分大小写)的标头合并为逗号分隔的列表。如果某些元数据包含不可打印的字符,则不会返回它。但是,x-amz-missing-meta 标头将与不可打印的元数据条目的数量值一起返回。该 HeadObject 操作从对象检索元数据而不返回对象本身。如果您只对某个对象的元数据感兴趣,则此操作很有用。要使用 HEAD,您必须具有对象的读取权限。有关详细信息,请参阅 Amazon Simple Storage Service API 参考 中的 HeadObject

用户定义的元数据是一组键值对。Amazon S3 以小写形式存储用户定义的元数据键。

Amazon S3 允许元数据值中有任意 Unicode 字符。

为避免与这些元数据值显示有关的问题,如果使用 SOAP 或通过 POST 进行基于浏览器的上传,则当使用 REST 和 UTF-8 时,应遵守使用 US-ASCII 字符的规定。

在元数据值中使用非 US-ASCII 字符时,将检查提供的 Unicode 字符串中是否存在非 US-ASCII 字符。如果字符串仅包含 US-ASCII 字符,则按原样显示。如果字符串包含非 US-ASCII 字符,则首先使用 UTF-8 进行字符编码,然后编码为 US-ASCII。

以下是示例。

PUT /Key HTTP/1.1 Host: awsexamplebucket1.s3.amazonaws.com x-amz-meta-nonascii: ÄMÄZÕÑ S3 HEAD /Key HTTP/1.1 Host: awsexamplebucket1.s3.amazonaws.com x-amz-meta-nonascii: =?UTF-8?B?w4PChE3Dg8KEWsODwpXDg8KRIFMz?= PUT /Key HTTP/1.1 Host: awsexamplebucket1.s3.amazonaws.com x-amz-meta-ascii: AMAZONS3 HEAD /Key HTTP/1.1 Host: awsexamplebucket1.s3.amazonaws.com x-amz-meta-ascii: AMAZONS3
注意

PUT 请求标头的大小限制为 8 KB。在 PUT 请求标头中,用户定义的元数据的大小限制为 2 KB。通过计算每个键和值的 UTF-8 编码中的字节总数来测量用户定义的元数据的大小。

有关在上传对象后向其中添加元数据的信息,请参阅在 Amazon S3 控制台中编辑对象元数据