获取对象的meta信息
更新时间:2021-12-29
接口说明
此命令用于获取某个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
<公共响应头>
{ }
错误码
请参考通用错误码