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

HEAD 对象

贡献者

您可以使用 S3 head Object 请求从对象检索元数据,而无需返回对象本身。如果对象存储在云存储池中,则可以使用 head 对象确定对象的过渡状态。

head 对象和多部分对象

您可以使用 partNumber 用于检索多部分或分段对象特定部分的元数据的请求参数。。 x-amz-mp-parts-count 响应元素指示对象有多少个零件。

您可以设置 partNumber 对于分段/多部分对象和非分段/非多部分对象、均为1;但是、 x-amz-mp-parts-count 只有分段对象或多部分对象才会返回响应元素。

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

StorageGRID 不会解析或解释用户定义的元数据中的转义 UTF-8 字符。对用户定义的元数据中具有转义UTF-8字符的对象发出的HEAD请求不会返回 x-amz-missing-meta 如果密钥名称或值包含不可打印的字符、则为标题。

请求标头不受支持

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

  • x-amz-website-redirect-location

版本控制

如果为 versionId 未指定子资源、此操作将提取受版本控制的存储分段中的对象的最新版本。如果对象的当前版本为删除标记、则会使用返回"`not found`"状态 x-amz-delete-marker 响应标头设置为 true

使用客户提供的加密密钥( 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摘要。

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

Cloud Storage Pool对象的head对象响应

对象存储在中 "云存储池",将返回以下响应标头:

  • x-amz-storage-class: GLACIER

  • x-amz-restore

响应标头提供了有关对象移动到云存储池,可选择过渡到不可检索状态并已还原时的状态的信息。

对象的状态 对 head 对象的响应

对象已载入 StorageGRID 但尚未通过 ILM 进行评估,或者存储在传统存储池中的对象或使用纠删编码

200 OK (不返回任何特殊的响应标头。)

云存储池中的对象,但尚未过渡到无法检索的状态

200 OK

x-amz-storage-class: GLACIER

x-amz-restore: ongoing-request="false", expiry-date="Sat, 23 July 20 2030 00:00:00 GMT"

在将对象过渡到无法检索的状态之前、为提供的值 expiry-date 设置为未来的某个远程时间。确切的过渡时间不受 StorageGRID 系统控制。

对象已过渡到不可检索状态,但网格上至少也存在一个副本

200 OK

x-amz-storage-class: GLACIER

x-amz-restore: ongoing-request="false", expiry-date="Sat, 23 July 20 2030 00:00:00 GMT"

的值 expiry-date 设置为未来的某个远程时间。

注意:如果网格上的副本不可用(例如、存储节点已关闭)、则必须使用问题描述 A "后对象还原" 请求先从云存储池还原副本、然后才能成功检索对象。

对象已过渡到无法检索的状态,网格上不存在任何副本

200 OK

x-amz-storage-class: GLACIER

正在从不可检索状态还原的对象

200 OK

x-amz-storage-class: GLACIER

x-amz-restore: ongoing-request="true"

对象已完全还原到云存储池

200 OK

x-amz-storage-class: GLACIER

x-amz-restore: ongoing-request="false", expiry-date="Sat, 23 July 20 2018 00:00:00 GMT"

expiry-date 指示何时将云存储池中的对象返回到无法检索的状态。

云存储池中的多部分或分段对象

如果您上传的是多部分对象或 StorageGRID 将一个大型对象拆分为多个区块,则 StorageGRID 会通过取样该对象的部分或区块来确定该对象是否在云存储池中可用。在某些情况下、可能会错误地返回HEAD对象请求 x-amz-restore: ongoing-request="false" 对象的某些部分已过渡到无法检索的状态、或者对象的某些部分尚未还原。

HEAD对象和跨网格复制

如果您使用的是 …​ "网格联盟""跨网格复制" 已为分段启用、则S3客户端可以通过发出HEAD对象请求来验证对象的复制状态。响应包括特定于StorageGRID的 x-ntap-sg-cgr-replication-status 响应标头、它将具有以下值之一:

网格 复制状态

  • *SUCCESS *:复制成功。

  • *pending *:对象尚未复制。

  • 失败:复制失败并出现永久故障。用户必须解决此错误。

目标

REPRAM:对象已从源网格复制。

备注 StorageGRID 不支持 x-amz-replication-status 标题。