下载文件

最近更新时间:2020-06-09 10:19:34

接口描述

  • 接口名称:GetObject
  • 接口功能:该接口可以将数据保险箱中的对象(Object)下载至本地,该接口的请求者需要对目标对象有读取权限。

请求

请求示例

GET /<CofferName-APPID>/<ObjectKey> HTTP/1.1
Host: cdcs.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
说明:

Authorization: Auth String 详情,请参见 请求签名 文档。

请求参数

此接口无请求参数。

请求头

此接口除使用公共请求头部外,还支持以下请求头部,了解公共请求头部详情,请参见 公共请求头部 文档。

名称 是否必选 类型 描述
Range string RFC 2616 中定义的字节范围,范围值必须使用 bytes = first - last 格式,first 和 last 都是基于0开始的偏移量。
例如 bytes = 0 - 9,表示下载对象的开头10个字节的数据,此时返回 HTTP 状态码206(Partial Content)及 Content-Range 响应头部,如果不指定,则表示下载整个对象。

请求体

此接口无请求体。

响应

响应头

此接口除返回公共响应头部外,还返回以下响应头部,了解公共响应头部详情请参见 公共响应头部 文档。

名称        类型 描述
Content-Range string RFC 2616 中定义的返回内容的字节范围,仅当请求中指定了 Range 请求头部时,才会返回该头部。

响应体

此接口请求的响应体为对象(文件)内容。

错误码

此接口的特殊错误信息如下所述,全部错误信息请参见 错误码 文档。

错误码 HTTP 状态码 描述
AssumeRoleFailed 409 Conflict 扮演角色失败,检查是否已授予保险箱角色。
KMSFailed 409 Conflict 调用 KMS 失败。