## **功能描述** 此接口用于从桶中下载指定对象。桶的拥有者或者被授权的用户才具有调用此接口下载对象的权限。多版本状态下，如果未指定版本号，下载当前版本的对象，如果指定`versionId`，则返回指定版本的对象。 ## 服务端加密如果要下载的对象使用 TOS 托管加密密钥的服务端加密（SSE\-TOS）或使用 KMS 托管加密密钥的服务端加密（SSE\-KMS），则不应在 GET 请求中携带加密请求头域，如：`x-tos-server-side-encryption`，如果携带了该加密头域，会收到 HTTP 400 BadRequest 错误。如果客户端在对象上传时，使用客户提供的加密密钥（SSE\-C）进行服务端加密，当下载对象时，你必须携带以下头域： * x\-tos\-server\-side\-encryption\-customer\-algorithm * x\-tos\-server\-side\-encryption\-customer\-key * x\-tos\-server\-side\-encryption\-customer\-key\-MD5 关于服务端加密的更多详细信息，请参见[服务端加密概述](https://www.volcengine.com/docs/6349/105525)。 ## 注意事项使用 GetObject 接口下载归档存储、冷归档存储和深度冷归档存储对象前，需要先恢复对象。 ## 匿名请求说明 TOS 不允许在匿名访问的 Get 请求中自定义响应头域。详情请参见[对象存储匿名请求限制说明](https://www.volcengine.com/docs/6349/1451316)。 ## **请求消息样式** ```JSON GET /objectName HTTP/1.1 Host: bucketname.tos-cn-beijing.volces.com Date: GMT Date Authorization: authorization string ``` ## **请求参数和消息头** 该请求的公共请求消息头，请参见[公共参数](https://www.volcengine.com/docs/6349/75044)。 |**名称** |**位置** |**参数类型** |**是否必选** |**示例值** |**说明** | |---|---|---|---|---|---| |Range |Header |String |否 |bytes=0\-4 |指定对象的获取范围。如未指定，则获取整个对象。Range 是一个范围，它的起始值最小为 0，最大为对象长度减 1。Range 范围的起始值为必填项，如果 Range 只包含起始值，表示获取起始值到对象长度减 1 这个区间的对象内容。格式为：bytes=start\-end。

说明

携带 Range 头域后，响应消息的 ETag 仍是对象的 ETag，而不是 Range 范围内对象的 ETag。

说明

使用 GetObject 接口下载对象时，如果对象类型是软链接对象，则不同的响应头返回的内容不同，说明如下：

*

Content-Length、ETag 、x-tos-storage-class 和 x-tos-hash-crc64ecma：返回软链接对象指向的目标对象的信息。

*

Last-Modified：返回软链接对象和目标对象两者之间更新较晚的日期。

*

其他响应头：返回软链接对象信息。

|**名称** |**参数类型** |**示例值** |**说明** | |---|---|---|---| |Content\-Range |String |bytes 0\-4/300 |返回的对象数据范围。 | |Last\-Modified |String |Mon, 02 Jul 2021 10:29:28 GMT |对象最后更新日期。 | |x\-tos\-delete\-marker |Bool |true |对象是否标记删除。如果不是，不会返回此消息头。 | |x\-tos\-server\-side\-encryption |String |kms |对象是 SSE\-TOS 加密或 SSE\-KMS 时返回该头域，表示对象的服务端加密方式，取值如下：

* `AES256`：使用 SSE\-TOS 加密方式，并采用 AES256 加密算法。

* `SM4`：使用 SSE\-TOS 加密方式，并采用 SM4 加密算法。

* `kms`: 使用 SSE\-KMS 加密方式。

关于 SSE\-TOS、 SSE\-KMS 加密方式详细说明，请参见[服务端加密概述](https://www.volcengine.com/docs/6349/74856)。 | |x\-tos\-server\-side\-encryption\-kms\-key\-id |String |trn:kms:cn\-beijing:20000111:keyrings/ring\-test/keys/key\-test |对象采用 SSE\-KMS 加密方式时返回该头域，该头域表示 SSE\-KMS 加密使用的 KMS 主密钥 ID。 | |x\-tos\-server\-side\-encryption\-customer\-algorithm |String |AES256 |对象是 SSE\-C 加密时返回此头域，该头域表示解密使用的算法。 | |x\-tos\-server\-side\-encryption\-customer\-key\-MD5 |String |0gYVWExOAz67jX5A6qY4+A== |对象是 SSE\-C 加密时返回此头域，该头域表示解密使用的密钥的 MD5 值。 | |x\-tos\-version\-id |String |57AF1A32CECB56721267 |对象的版本号。如果不存在版本号，则该消息头不会出现在响应消息中。 | |x\-tos\-website\-redirect\-location |String |/abc |当桶设置了 Website 配置，可以将获取这个对象的请求重定向到桶内另一个对象或一个外部的 URL，TOS 将这个值从头域中取出，保存在对象的元数据中。 | |x\-tos\-object\-type |String |Symlink |对象为非 Normal 对象时，会返回此响应头，取值说明如下：

* `Appendable`：该对象为追加写接口上传的对象。

* `Symlink`：该对象为软链接对象。 | |x\-tos\-storage\-class |String |STANDARD |对象的存储类型，取值说明如下：

* `STANDARD`：标准存储。

* `IA`：低频访问存储。

* `INTELLIGENT_TIERING`：智能分层存储。

* `ARCHIVE_FR`：归档闪回存储。

* `ARCHIVE`：归档存储。

* `COLD_ARCHIVE`：冷归档存储。

* `DEEP_COLD_ARCHIVE`：深度冷归档存储。 | |x\-tos\-storage\-tier |String |INFREQUENT |智能分层对象所属的访问层级，取值说明如下：

* `FREQUENT`：智能分层高频访问层。

* `INFREQUENT`：智能分层低频访问层。

* `ARCHIVEFR`：智能分层归档闪回访问层。

说明

仅智能分层对象会返回 x-tos-storage-tier 参数。

说明

对 TOS 服务端支持 64 位 CRC 校验前创建的对象，则该消息头不会出现在响应消息中。

| |x‑tos‑tagging‑count |String |3 |对象的标签个数。仅当拥有对象标签读取权限时返回。 | |X\-Tos\-Expiration |String |expiry\-date="Sun, 25 Dec 2022 00:00:00 GMT" |对象的过期日期，存在以下两种情况：

* 如果该对象匹配生命周期的删除规则，则返回以下参数：

* `expiry-date`：对象的过期日期。

* `rule-id`：生命周期规则 ID。

* 如果该对象设置了过期时间，则会返回 `expiry-date` 参数，表示对象的过期日期，`rule-id` 参数则为空。 | |x\-tos\-replication\-status |String |COMPLETE |对象的跨区域或同区域复制状态，存在以下两种情况：

* 如果是源存储桶的对象，该参数取值如下：

* `COMPLETE`：该对象已成功复制到目标桶。

* `PENDING`：该对象正在复制中。

* `FAILED`：该对象复制失败。

* 如果是目标存储桶的对象，该参数只有一个取值，即 `REPLICA`，表示该对象是通过跨区域复制或同区域复制功能同步过来的。

注意

*

查询对象跨区域复制或同区域复制状态功能（即 x-tos-replication-status 参数）目前处于邀测状态，如您需要使用该功能，请联系客户经理。

*

仅该对象为跨区域复制或同区域复制规则中源存储桶或目标存储桶的对象时，才会返回该参数。

*

仅支持查询配置了一条跨区域复制规则或同区域复制规则的源存储桶的对象复制状态，例如在源存储桶设置了多条复制规则，将 A 对象复制到 B、C、D 存储桶，则不支持查询 A 对象的复制状态。目标存储桶的对象则没有该限制。

说明

您的账号需要拥有 GetObjectRetention 权限，才会返回 x-tos-object-lock-mode 参数。

说明

您的账号需要拥有 GetObjectRetention 权限，才会返回 x-tos-object-lock-retain-until-date 参数。

| |x\-tos\-service\-managed\-by |String |Ark |对象托管服务标识。若对象由内部云服务托管管理，则返回对应服务名；否则该字段为空或省略。托管对象通常仅允许同一托管服务执行受限修改操作。 | ## **响应元素** 该请求响应中无消息元素。 ## **请求示例** ```JSON GET /objectName HTTP/1.1 Host: bucketname.tos-cn-beijing.volces.com Date: Fri, 30 Jul 2021 08:05:36 GMT Authorization: authorization string ``` ## **响应示例** ```JSON HTTP/1.1 200 OK Content-Type: text/plain Content-Length: 120 Date: Fri, 30 Jul 2021 08:05:36 GMT ETag: "900150983cd24fb0d6963f7d28e17f72" Last-Modified: Mon, 02 Jul 2021 10:29:28 GMT server: TosServer x-tos-id-2: d604607e63b001f-a444ed0 x-tos-request-id: d604607e63b001f-a444ed0 x-tos-hash-crc64ecma: 6186290338114851376 [ 120 Bytes object content] ```