GetObjectMeta
更新时间:2020-11-24
接口描述
此命令用于获取某个Object的Meta信息,但此时并不返回数据。
注意:
- 如果使用软链接访问GetObjectMeta, 返回响应头中Content-Length、ETag、Content-Md5 均为目标文件的元信息;Last-Modified是目标文件和软链接的最大值;其他均为软链接元信息。
- 如果使用软链接访问该接口且目标文件删除了,会返回Http 404,SymlinkTargetNotExist,调用GetSymlink不会报错。
请求(Request)
-
请求语法
HEAD /<ObjectName> HTTP/1.1 Host: <BucketName>.bj.bcebos.com Date: <Date> Authorization: <AuthorizationString>
-
请求头域
无特殊header参数
无特殊参数
响应(Response)
-
响应头域
名称 类型 描述 Cache-Control String 下载Object的Cache设置,常见的可取值为 private
、no-cache
、max-age
、must-revalidate
Content-Disposition String 设置浏览器是否下载,可取值为 inline
、attachment
; filename="download.txt"Content-Length Long Int 返回Object的数据大小 Content-Range String 有range的情况下返回Object的数据范围 Content-Type String Object的类型及编码方式 Expires String 下载Object时的缓存失效时间 ETag String Object的HTTP协议实体标签 x-bce-meta-* String 如果有自定meta,才返回此项 x-bce-storage-class String 标准存储返回STANDARD,低频存储返回 STANDARD_IA
,冷存储返回COLD
,归档存储返回ARCHIVE
;如果是多AZ类型bucket,多AZ低频存储返回MAZ_STANDARD_IA
,多AZ标准存储返回MAZ_STANDARD
。x-bce-server-side-encryption String Object的服务器端加密类型,当前只支持AES256加密。 x-bce-restore String 当对象为归档存储类型,并且处于正在取回或已经取回时,会返回头域“x-bce-restore”,表示归档类型对象的取回状态:正在取回时返回 ongoing-request="true"
;已取回归档对象时,返回ongoing-request="false", expiry-date="Wed, 07 Nov 2019 00:00:00 GMT"
。其中expiry-date表示对象取回后的失效时间。x-bce-object-type String 当访问的是软链接,则返回值“Symlink”。其他情况暂不返回 -
响应参数
无
注意事项
无
示例
-
请求示例
HEAD /ObjectName HTTP/1.1 Host: BucketName.bj.bcebos.com Date: Wed, 06 Apr 2016 06:34:40 GMT Authorization: AuthorizationString
-
响应示例
HTTP/1.1 200 OK x-bce-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409 x-bce-storage-class: STANDARD Date: Wed, 06 Apr 2016 06:34:40 GMT Last-Modified: Sun, 1 Jan 2006 12:00:00 GMT ETag: "fba9dede5f27731c9771645a39863328" Content-Length: 0 Content-Type: text/plain Connection: close Server: BceBos
-
归档类型对象已取回时响应示例
HTTP/1.1 200 OK x-bce-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409 x-bce-storage-class: ARCHIVE x-bce-restore: ongoing-request="false", expiry-date="Wed, 07 Nov 2019 00:00:00 GMT" Date: Wed, 27 Feb 2019 06:34:40 GMT Last-Modified: Wed, 20 Feb 2019 06:34:40 GMT ETag: "fba9dede5f27731c9771645a39863328" Content-Length: 15618 Content-Type: text/plain Connection: close Server: BceBos