检索存储桶及其权限

最近更新时间: 2024-10-17 17:10:00

功能描述

HEAD Bucket 请求可以确认该 Bucket 是否存在,是否有权限访问。HEAD 的权限与 Read 一致。有以下几种情况:

  • Bucket 存在,返回 HTTP 状态码为200。

  • Bucket 无访问权限,返回 HTTP 状态码为403。

  • Bucket 不存在,返回 HTTP 状态码为404。

注意:

目前我们还没有公开获取 Bucket 属性的接口(即可以返回 acl 等信息)。

请求

请求示例

HEAD / HTTP/1.1
Host: <BucketName-APPID>.<Endpoint>
Date: GMT Date
Authorization: Auth String

说明:

Authorization:Auth String(详细参见请求签名章节)。

请求头

公共头部

该请求操作的实现使用公共请求头,了解公共请求头详细请参见 公共请求头部 章节。

非公共头部

该请求操作无特殊的请求头部信息。

请求体

该请求的请求体为空。

响应

响应头

公共响应头

该响应包含公共响应头,了解公共响应头详情请参见 公共响应头部 章节。

特有响应头

该响应无特殊的响应头。

响应体

该响应体为空。

实际案例

请求

HEAD / HTTP/1.1
Host: <BucketName-APPID>.<Endpoint>
Date: Thu, 27 Oct 2015 20:32:00 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKIDWtTCBYjM5OwLB9CAwA1Qb2ThTSUjfGFO&q-sign-time=1484640517;32557536517&q-key-time=1484640517;32557536517&q-header-list=host&q-url-param-list=&q-signature=7bedc2f84a0a3d29df85fe727d0c1e388c410376

响应

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 0
Date: Thu, 27 Oct 2015 20:32:00 GMT
x-cos-request-id: NTg3ZGQxNDNfNDUyMDRlXzUyOWNfMjY5