GetObjectMeta
更新时间：2026-09-18
接口描述
GetObjectMeta 接口用于获取指定 Object 的 Meta 信息，但不返回 Object 数据内容。请求需要携带 Authorization 签名鉴权。
注意：
- 如果使用软链接访问 GetObjectMeta，返回响应头中
Content-Length、ETag、Content-Md5均为目标文件的元信息；Last-Modified是目标文件和软链接的最大值；其他均为软链接元信息。 - 如果使用软链接访问该接口且目标文件已删除，会返回 HTTP 404 和
SymlinkTargetNotExist；调用 GetSymlink 不会报错。
请求
请求结构
普通请求：
Http
1HEAD /<ObjectName> HTTP/1.1
2Host: <BucketName>.bj.bcebos.com
3Date: <Date>
4Authorization: <AuthorizationString>指定版本请求：
Http
1HEAD /<ObjectName>?versionId=<VersionId> HTTP/1.1
2Host: <BucketName>.bj.bcebos.com
3Date: <Date>
4Authorization: <AuthorizationString>请求头域
| 名称 | 类型 | 描述 | 是否必需 |
|---|---|---|---|
Host |
String | Bucket 的访问域名，格式为 <BucketName>.bj.bcebos.com。 |
是 |
Date |
String | 请求时间，使用 GMT 格式。 | 是 |
Authorization |
String | 请求签名认证信息。 | 是 |
If-Match |
String | 只有 BOS 侧 Object 的 ETag 与 If-Match 提供的值一致时，本次请求才会成功；否则返回 412 Precondition Failed 错误。 |
否 |
If-Modified-Since |
String | 只有 BOS 侧 Object 于 If-Modified-Since 提供的时间之后被修改过，本次请求才会成功；否则返回 304 Not Modified 错误。当 If-None-Match 和 If-Modified-Since 同时存在时，忽略 If-Modified-Since。 |
否 |
If-None-Match |
String | 只有 BOS 侧 Object 的 ETag 与 If-None-Match 提供的值不一致时，本次请求才会成功；否则返回 304 Not Modified 错误。 |
否 |
If-Unmodified-Since |
String | 只有 BOS 侧 Object 于 If-Unmodified-Since 提供的时间之后未被修改过，本次请求才会成功；否则返回 412 Precondition Failed 错误。当 If-Match 和 If-Unmodified-Since 同时存在时，忽略 If-Unmodified-Since。 |
否 |
请求参数
| 字段 | 类型 | 位置 | 是否必需 | 描述 |
|---|---|---|---|---|
ObjectName |
String | Path | 是 | Object 名称。 |
versionId |
String | Query | 否 | 获取对象的版本 ID。默认为空时获取最新版本信息；如果为 null，指定获取空版本信息。 |
响应
响应头域
| 名称 | 类型 | 描述 |
|---|---|---|
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-Md5 |
String | Object 的 MD5 校验值。使用软链接访问 GetObjectMeta 时，该值为目标文件的元信息。 |
Content-Range |
String | 有 Range 的情况下返回 Object 的数据范围。 |
Content-Type |
String | Object 的类型及编码方式。 |
Expires |
String | 下载 Object 时的缓存失效时间。 |
Last-Modified |
String | Object 的最后修改时间。使用软链接访问 GetObjectMeta 时，该值为目标文件和软链接最后修改时间的最大值。 |
ETag |
String | Object 的 HTTP 协议实体标签。 |
x-bce-request-id |
String | 请求 ID。 |
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 和 SM4 加密。 |
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；其他情况暂不返回。 |
x-bce-version-id |
String | 对象的版本 ID。 |
x-bce-expiration-date |
String | 如果设置了对象过期时间，那么显示的是对象过期时间。如果没有设置对象过期时间，那么显示的是对应生命周期规则的过期时间。例如 2025-06-17T08:00:00Z。 |
响应参数
无。
注意事项
- 如果请求头中同时包含多个条件 Header（
If-Match、If-None-Match、If-Modified-Since、If-Unmodified-Since），BOS 的判断顺序遵循 RFC 7232 第六章规定，详情请见 RFC 7232。
示例
请求示例
Http
1HEAD /ObjectName HTTP/1.1
2Host: BucketName.bj.bcebos.com
3Date: Wed, 06 Apr 2016 06:34:40 GMT
4Authorization: AuthorizationString响应示例
Http
1HTTP/1.1 200 OK
2x-bce-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409
3x-bce-storage-class: STANDARD
4Date: Wed, 06 Apr 2016 06:34:40 GMT
5Last-Modified: Sun, 1 Jan 2006 12:00:00 GMT
6ETag: "fba9dede5f27731c9771645a39863328"
7Content-Length: 0
8Content-Type: text/plain
9Connection: close
10Server: BceBos归档类型对象已取回时响应示例
Http
1HTTP/1.1 200 OK
2x-bce-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409
3x-bce-storage-class: ARCHIVE
4x-bce-restore: ongoing-request="false", expiry-date="Wed, 07 Nov 2019 00:00:00 GMT"
5Date: Wed, 27 Feb 2019 06:34:40 GMT
6Last-Modified: Wed, 20 Feb 2019 06:34:40 GMT
7ETag: "fba9dede5f27731c9771645a39863328"
8Content-Length: 15618
9Content-Type: text/plain
10Connection: close
11Server: BceBos多版本请求示例
Http
1HEAD /ObjectName?versionId=ADCQMlGFiNo%3D HTTP/1.1
2Host: BucketName.bj.bcebos.com
3Date: Wed, 06 Apr 2016 06:34:40 GMT
4Authorization: AuthorizationString多版本响应示例
Http
1HTTP/1.1 200 OK
2x-bce-request-id: 4db2b34d-654d-4ddd-b49b-3049ca786409
3x-bce-storage-class: STANDARD
4Date: Wed, 06 Apr 2016 06:34:40 GMT
5Last-Modified: Sun, 1 Jan 2022 12:01:00 GMT
6ETag: "fba9dede5f27731c9771645a39863328"
7Content-Length: 0
8Content-Type: text/plain
9Connection: close
10Server: BceBos
11x-bce-version-id: ADCQMlGFiNo=评价此篇文章