下载对象
更新时间 2025-06-11 14:55:25
最近更新时间: 2025-06-11 14:55:25
接口功能介绍
下载对象至本地。
URI
GET /v2/oss/object/download
请求参数
请求体body参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 |
---|---|---|---|---|
bucket | 是 | String | 桶名称 | Bucket-test |
key | 是 | String | 文件key | Obj1 |
expiresIn | 是 | Int | 下载链接过期时间(秒)。 | 180 |
versionID 可选 | 否 | String | 如果是多版本文件的话,可以versionID指定版本 | Mp6FKCm7LkZvCA3iTWj6sdqv.4vLAFy |
otherParams 可选 | 否 | String | 其他参数 | {"ResponseContentDisposition":"attachment"} |
响应参数
参数 | 参数类型 | 说明 |
---|---|---|
signedUrl | String | 可下载的链接 |
endpoint | object | endpoint |
returnObj | Object | 空对象 |
请求示例
{
"bucket": "xxxxxxx",
"key": "xxxxxxx",
"expiresIn": "xxxxxxx",
"otherParams": "{\"ResponseContentDisposition\":\"attachment\"}"
}
响应示例
成功响应示例
{
"statusCode": 800,
"returnObj": {
"signedUrl": "xxxxxxx",
"endpoint": {},
},
"message": "Success"
}
失败响应示例
{
"statusCode": 900,
"errorCode": "xxxxxx",
"message": "xxxxxx",
"description": "xxxxxx"
}
状态码
状态码 | 描述 |
---|---|
200 | 表示请求成功。 |