View a markdown version of this page

通用响应标头 - Amazon Simple Storage Service
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

通用响应标头

下表描述了对于大多数 Amazon S3 响应通用的响应标头。

名称 描述
Access-Control-Allow-Credentials

一个布尔值，用于确定服务器是否支持 CORS 请求包含凭证。如果 Access-Control-Allow-Origin 请求标头设置为 '*'，则将忽略 Access-Control-Allow-Credentials 响应标头，否则在 CORS 评估取得成功时，它将设置为 true。

类型：布尔值

默认值：无
Access-Control-Allow-Headers

CORS 请求可以使用的 HTTP 标头列表。对于成功的 CORS 评估返回 Access-Control-Allow-Headers 响应标头，并显式指定所有支持的 Access-Control-Request-Headers。

类型：字符串

默认值：无
Access-Control-Allow-Methods

指定支持哪些 HTTP 方法的列表。只有在 CORS 评估取得成功后，Amazon S3 才会支持来自可让使用的 CORS 方法的 CORS 请求。

类型：字符串

默认值：无
Access-Control-Allow-Origin

支持的源的位置。只有在 CORS 评估取得成功后，Amazon S3 才会发送 Access-Control-Allow-Origin 响应标头。如果请求源与 CORS 配置支持的源中的 '*' 相匹配，则将在此响应标头而不是原始源中返回 '*'。

类型：字符串

默认值：无
Access-Control-Expose-Headers

一个列表，可让服务器识别响应标头，当 CORS 评估取得成功时，该标头会公开应用程序的访问权限。

类型：字符串

默认值：无
Access-Control-Max-Age

对于由资源、HTTP 方法和源识别的 CORS 预检请求，浏览器可以为该请求缓存响应的时间（以秒为单位）。仅当 CORS 评估取得成功时，才会返回 Access-Control-Max-Age 响应标头。

类型：整数

默认值：无
Vary

一个列表，用于指示 CORS 评估结果会因哪些请求标头而异。仅当 CORS 评估取得成功时，才会返回 Vary 响应标头。

类型：字符串

默认值：无
Content-Length

响应正文的长度（以字节为单位）。

类型：字符串

默认值：无
Content-Type

内容的 MIME 类型。例如 Content-Type: text/html; charset=utf-8。

类型：字符串

默认值：无
Connection

一个值，用于指定与服务器的连接是打开还是关闭。

类型：Enum

有效值：open | close

默认值：无
Date

Amazon S3 响应的日期和时间；例如“Wed, 01 Mar 2006 12:00:00 GMT”。

类型：字符串

默认值：无
ETag

表示对象的特定版本的实体标签（ETag）。ETag 仅反映对对象的内容的更改，而不反映对对象的元数据的更改。ETag 可能是该对象数据的 MD5 摘要，也可能不是。是与不是取决于创建对象的方式及对象加密方式，具体如下：

  • 通过 Amazon Web Services 管理控制台或由 PUT 对象、POST Object 或 Copy 操作创建的对象：

    • 对于属于纯文本或以具有 Amazon S3 托管式密钥的服务器端加密（SSE-S3）进行加密的对象，其 ETag 是其数据的 MD5 摘要。

    • 对于以具有客户提供的密钥（SSE-C）或 Amazon Key Management Service（Amazon KMS）密钥（SSE-KMS）的服务器端加密进行加密的对象，其 ETag 不是其对象数据的 MD5 摘要。

  • 对于通过分段上传或上传分段副本操作创建的对象，其 ETag 不是 MD5 摘要，而无论采用的是何种加密方法。

类型：字符串
Server

创建了响应的服务器的名称。

类型：字符串

默认：AmazonS3
x-amz-delete-marker

一个值，它指定返回的对象是 (true) 或不是 (false) 删除标记。

类型：布尔值

有效值：true | false

默认：false
x-amz-id-2

与 x-amz-request-id 标头一起使用的特殊令牌，有助于 Amazon 排查问题。有关使用这些请求 ID 的 Amazon Web Services Support 的信息，请参阅 Amazon S3 故障排除。

类型：字符串

默认值：无
x-amz-request-id

由 Amazon S3 创建的唯一标识请求的值。此值与 x-amz-id-2 标头一起使用，有助于 Amazon 排查问题。有关使用这些请求 ID 的 Amazon Web Services Support 的信息，请参阅 Amazon S3 故障排除。

类型：字符串

默认值：无
x-amz-server-side-encryption

在 Amazon S3 中存储此对象时使用的服务器端加密算法（例如，AES256、aws:kms）。

有效值：AES256 | aws:kms
x-amz-version-id

对象的版本。启用版本控制时，Amazon S3 会为添加到存储桶的对象生成一个随机数。该值采用 UTF-8 编码且支持 URL。当您在已暂停版本控制的存储桶中 PUT 对象时，版本 ID 始终为 null。

类型：字符串

有效值：null | 任何支持 URL 的 UTF-8 编码字符串

默认值：null