接口描述
- 接口名称: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 失败。 |