获取对象的meta信息
所有文档

          对象存储 BOS

          获取对象的meta信息

          接口说明

          此命令用于获取某个Object的Meta信息,但此时并不返回数据。 注意

          • 如果使用软链接访问GetObjectMeta, 返回响应头中Content-Length、ETag、Content-Md5 均为目标文件的元信息;Last-Modified是目标文件和软链接的最大值;其他均为软链接元信息。
          • 如果使用软链接访问该接口且目标文件删除了,会返回Http 404,SymlinkTargetNotExist,调用GetSymlink不会报错。

          请求URI

          HEAD /v1/{bucketName}/{objectKey}

          参数名称 参数类型 是否必须 描述 示例值 参数位置
          bucketName String bucket的名称 "bucketName_example" Path
          objectKey String object的名称 "objectKey_example" Path

          请求体参数

          请求体字段数据结构说明

          响应头参数

          参数名称 参数类型 描述 示例值
          Cache-Control String 下载Object的Cache设置,常见的可取值为private、no-cache、max-age、must-revalidate
          Content-Disposition String 设置浏览器是否下载,可取值为inline、attachment; filename="download.txt"
          Content-Length String 返回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 /v1/bucketName_example/objectKey_example
          <公共请求头>
          
          
          { }

          响应示例

          HTTP/1.1 200 OK
          <公共响应头>
          
          { }

          错误码

          请参考通用错误码

          上一篇
          获取对象
          下一篇
          取回归档文件