获取Object下载链接
更新时间：2022-08-24
接口描述
本接口用于获取指定Object的下载链接。
请求结构
GET /v1/bos/bucket/{bucketId}/object/link?objectKey={objectKey}&downloadToLocal={downloadToLocal}&expireTime={expireTime} HTTP/1.1
Host: bec.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| bucketId | String | 是 | URL参数 | Bucket的ID，全局唯一 |
| objectKey | String | 是 | Query参数 | 对象key，能确定唯一一个对象，不能以"/"符号结尾，不能以"/"符号作为开头，如："tmp/myfile"、"myfile" |
| downloadToLocal | Boolean | 是 | Query参数 | 设置是否指定生成的链接用于下载文件，默认值为false |
| expireTime | int | 是 | Query参数 | 设置链接过期时间，取值范围1-43200，单位分钟。 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| downloadLink | String | 下载链接 |
| expireTime | Date | 过期时间 |
错误码
请参照错误返回章节的内容。
请求示例
GET https://bec.baidubce.com/v1/bos/bucket/abc-test15/object/link?objectKey=tmp/myfile&downloadToLocal=true&expireTime=60 HTTP/1.1
Host: bec.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 08 Jul 2015 03:28:11 GMT
x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS
{
"downloadLink": "http://10.190.77.32:8080/abc-test15/test.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20200430T142522Z&X-Amz-SignedHeaders=host&X-Amz-Expires=600&X-Amz-Credential=61e848f903b2459a8171d6d699205a9f%2F20200430%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Signature=d30a8af1b4f94e226560b8f862a162e8f5a60671d28e499b46ca3342dd74db19",
"expireTime": "2020-04-30 22:35:22"
}