搜索本产品文档关键词
获取对象的meta信息
所有文档
menu

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-cachemax-agemust-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”。其他情况暂不返回

响应体参数

响应体字段数据结构说明

请求示例

JSON
1HEAD /v1/bucketName_example/objectKey_example
2<公共请求头>
3
4
5{ }

响应示例

JSON
1HTTP/1.1 200 OK
2<公共响应头>
3
4{ }

错误码

请参考通用错误码

上一篇
获取对象
下一篇
删除Object