GetObjectMeta

接口描述

此命令用于获取某个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