HEAD 存储分区

指示存储分区是否存在,以及请求者是否具有存储分区的读取权限。

如果您发出 HEAD 请求,但其范围并不存在,则找不到 404状态代码以及错误响应的正文将包含NoSuchBucket Code元素。

查询字符串参数

此请求通常不包含查询字符串参数。

如需了解您在创建和使用签名网址时包含的参数,请参阅签名网址查询字符串参数

请求标头

标题 说明 必需
Authorization 请求的身份验证字符串。
Content-Length

请求正文的长度(无标头)(以字节为单位)。

Date 请求的日期和时间。
Host Cloud Storage 的 URI。如需了解详情,请参阅请求端点
x-goog-user-project 与请求关联的费用需要收取的项目费用。

请求正文元素

此请求不包含 XML 文档。

请求语法

HEAD / HTTP/1.1
Host: BUCKET_NAME.storage.googleapis.com
Date: DATE
Content-Length: 0
Authorization: AUTHENTICATION_STRING

响应标头

请求将返回标准响应标头。

响应正文元素

响应的响应正文中不包含 XML 文档。HEAD 请求的错误响应不包含响应正文。

示例

以下示例显示了名为 travel-maps 的存储分区的 HEAD 请求。

请求

HEAD / HTTP/1.1
Host: travel-maps.storage.googleapis.com
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg

响应

HTTP/1.1 200 OK
...