Head Bucket

Head Bucket

此操作可用于确定存储桶是否存在以及您是否有权访问。该动作返回一个 200 OK 如果存储桶存在并且您有权限访问。

如果存储桶不存在或您无权访问它，则返回一个通用的 400 Bad Request, 403 Forbidden 或者 404 Not Found 错误。

请求语法

登录后复制HEAD / HTTP/1.1
Host: Bucket.s3-us-east-1.ossfiles.com

HEAD / HTTP/1.1 Host: Bucket.s3-us-east-1.ossfiles.com

---

URI 请求参数

该请求没有URI请求参数。

名称	描述	类型
Bucket	存储桶名称	字符串

---

请求消息头

该请求没有请求消息头。

---

请求正文

该请求没有请求正文。

请求元素

该请求没有请求元素。

---

响应语法

该请求没有响应正文。

---

响应元素

该请求没有响应元素。

---

响应消息头

该请求没有响应消息头。

---

示例

请求示例

登录后复制HEAD / HTTP/1.1
Authorization: AWS4-HMAC-SHA256 Credential=2421a691b4ed625de19f6f92677b6459/20230116/us-east-1/s3/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date, Signature=5da21c76d4fef4cd0f5a589803598d8f88deb15b8e01056ca72c1abf29b00de0
Content-Length: 0
Host: bucket.s3-us-east-1.ossfiles.com
X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
X-Amz-Date: 20230116T170829Z

HEAD / HTTP/1.1 Authorization: AWS4-HMAC-SHA256 Credential=2421a691b4ed625de19f6f92677b6459/20230116/us-east-1/s3/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date, Signature=5da21c76d4fef4cd0f5a589803598d8f88deb15b8e01056ca72c1abf29b00de0 Content-Length: 0 Host: bucket.s3-us-east-1.ossfiles.com X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 X-Amz-Date: 20230116T170829Z

返回示例

登录后复制HTTP/1.1 200 OK
Content-length: 0
Content-type: text/plain;charset=UTF-8
Date: Mon, 16 Jan 2023 17:24:50 GMT
x-amz-access-point-alias: false
x-amz-bucket-region: us-east-1
x-amz-id-2: 7a465a319c1d4ce4802a92ede7a2370b
x-amz-request-id: 3109dc6051d347ccbd30761f2ac96316

HTTP/1.1 200 OK Content-length: 0 Content-type: text/plain;charset=UTF-8 Date: Mon, 16 Jan 2023 17:24:50 GMT x-amz-access-point-alias: false x-amz-bucket-region: us-east-1 x-amz-id-2: 7a465a319c1d4ce4802a92ede7a2370b x-amz-request-id: 3109dc6051d347ccbd30761f2ac96316