该操作将返回Object的元数据,需有Object的READ权限。
HEAD /ObjectName HTTP/1.1 Host: <bucket>.s3.<region>.jdcloud-oss.com Authorization: <authorization string> (see Authenticating Requests (AWS Signature Version4)) Date: <date>
无请求参数
除了共用的请求Header之外,该操作的实现还可以使用以下请求头,请求Header大小不超过8KB。
名称 | 描述 | 必须 |
---|---|---|
Range | 指定字节范围下载Object Type: String Default: None Constraints: None |
否 |
If-Modified-Since | 若Object在指定时间后修改,则返回该Object,否则返回304(not modified) Type: String Default: None Constraints: None |
否 |
If-Unmodified-Since | 若Object在指定时间后未修改,则返回该Object,否则返回412(precondition failed)。 Type: String Default: None Constraints: None |
否 |
If-Match | 如果ETag与指定的相同,则返回该Object,否则返回412(precondition failed)。 Type: String Default: None Constraints: None |
否 |
IF-None-Match | 如果ETag与指定的不同,则返回该Object,否则返回304(not modified)。 Type: String Default: None Constraints: None |
否 |
注意:
无请求元素
名称 | 描述 |
---|---|
x-amz-storage-class | 提供Object的存储类型信息。非标准存储情况下,OSS将会返回该Header |
x-amz-restore | 该对象的还原信息及副本生命周期 |
无响应元素
HEAD /my-image.jpg HTTP/1.1 Host: oss-example.s3.<region>.jdcloud-oss.com Date: Wed, 28 Oct 2009 22:32:00 GMT Authorization: <authorization string>
HTTP/1.1 200 OK x-amz-request-id: 318BC8BC143432E5 Date: Wed, 28 Oct 2009 22:32:00 GMT Last-Modified: Sun, 1 Jan 2006 12:00:00 GMT ETag: "fba9dede5f27731c9771645a39863328" Content-Length: 434234 Content-Type: text/plain Connection: close Server: JDCloudOSS