GetObjectMeta
更新时间：2021-11-05
接口描述
此命令用于获取某个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设置，常见的可取值为private、no-cache、max-age、must-revalidate |
| Content-Disposition | String | 设置浏览器是否下载，可取值为inline、attachment; 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