对象存储BOS

    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设置,常见的可取值为privateno-cachemax-agemust-revalidate
      Content-Disposition String 设置浏览器是否下载,可取值为inlineattachment; 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
      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
    上一篇
    GetObject
    下一篇
    PostObject