GetObjectMeta
所有文档

          对象存储 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;如果是多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
          上一篇
          GetObject
          下一篇
          PostObject