腾讯云对象存储下载对象

简介

注意该接口用于读取对象内容，如果需要发起浏览器下载文件，可以通过 cos.getObjectUrl 获取 url 再触发浏览器下载，具体参见 预签名 URL 文档。本文档提供关于对象的下载操作相关的 API 概览以及 SDK 示例代码。

功能说明

GET Object 接口请求可以获取存储桶里指定文件的内容，得到文件内容是字符串格式。
下载文件到本地请参见 预签名 URL 。

下载单个对象

使用示例

cos.getObject({    Bucket: 'examplebucket-1250000000', /* 填入您自己的存储桶，必须字段 */    Region: 'COS_REGION',  /* 存储桶所在地域，例如 ap-beijing，必须字段 */    Key: '1.jpg',  /* 存储在桶里的对象键（例如1.jpg，a/b/test.txt），必须字段 */    onProgress: function (progressData) {        console.log(JSON.stringify(progressData));    }}, function(err, data) {    console.log(err || data.Body);});

指定 Range 获取文件内容：

cos.getObject({    Bucket: 'examplebucket-1250000000', /* 填入您自己的存储桶，必须字段 */    Region: 'COS_REGION',  /* 存储桶所在地域，例如 ap-beijing，必须字段 */    Key: '1.jpg',  /* 存储在桶里的对象键（例如1.jpg，a/b/test.txt），必须字段 */    Range: 'bytes=1-3',        /* 非必须 */    onProgress: function (progressData) {        console.log(JSON.stringify(progressData));    }}, function(err, data) {    console.log(err || data.Body);});

返回blob格式文件内容：

cos.getObject({    Bucket: 'examplebucket-1250000000', /* 必须 */    Region: 'COS_REGION',     /* 存储桶所在地域，必须字段 */    Key: 'exampleobject',              /* 必须 */    DataType: 'blob',        /* 非必须 */    onProgress: function (progressData) {        console.log(JSON.stringify(progressData));    }}, function(err, data) {    console.log(err || data.Body);});

下载对象（单链接限速）：说明关于下载对象的限速说明，请参见 单链接限速。

cos.getObject({    Bucket: 'examplebucket-1250000000', /* 填入您自己的存储桶，必须字段 */    Region: 'COS_REGION',  /* 存储桶所在地域，例如 ap-beijing，必须字段 */    Key: '1.jpg',  /* 存储在桶里的对象键（例如1.jpg，a/b/test.txt），必须字段 */    Headers: {      'x-cos-traffic-limit': 819200, // 限速值设置范围为819200 - 838860800，单位默认为 bit/s，即800Kb/s - 800Mb/s，如果超出该范围将返回400错误。    },    onProgress: function (progressData) {        console.log(JSON.stringify(progressData));    }}, function(err, data) {    console.log(err || data.Body);});

参数说明

回调函数说明

function(err, data) { ... }

批量下载对象

注意不推荐使用，触发浏览器下载后，无法用代码控制开始、停止。当下载的对象过多时，可能造成较差的体验。

使用示例

按前缀下载多个对象（下载指定目录下的文件）：

var getObjects = function (marker) {    cos.getBucket({        Bucket: config.Bucket,        Region: config.Region,        Prefix: 'abc', /* 要下载的目录，或要下载的前缀 */        Marker: marker,        MaxKeys: 1000,    }, function (listError, listResult) {        if (listError) return console.log('list error:', listError);        var nextMarker = listResult.NextMarker;        listResult.Contents.forEach(function (item) {            cos.getObjectUrl({              Bucket: config.Bucket,              Region: config.Region,              Key: item.Key,            }, function(err, data) {              if (err) return console.log(err);              setTimeout(() => {                var downloadUrl = data.Url + (data.Url.indexOf('?') > -1 ? '&' : '?') + 'response-content-disposition=attachment'; // 补充强制下载的参数                window.open(downloadUrl); // 这里是新窗口打开 url，如果需要在当前窗口打开，可以使用隐藏的 iframe 下载，或使用 a 标签 download 属性协助下载              }, 500);            });        });        // 如果没有处理完需要继续查询下一页文件列表        if (listResult.IsTruncated === 'true') getMultipleObjects(nextMarker);    });}getObjects();



对象存储官网1折活动，限时活动，即将结束，速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠