Download objects

You can download an object from OSS through any of the following methods:

• Download to a local file
• Stream download
• Download to the buffer
• HTTP download (via a browser)

Download an object to a local file

Download an object to a local file through the ‘get’ interface:

var co = require('co');
var OSS = require('ali-oss');
var client = new OSS({
  region: '<Your region>',
  accessKeyId: '<Your AccessKeyId>',
  accessKeySecret: '<Your AccessKeySecret>',
  bucket: 'Your bucket name'
});
co(function* () {
  var result = yield client.get('object-key', 'local-file');
  console.log(result);
}).catch(function (err) {
  console.log(err);
});

Stream download

When you use ‘getStream’ to download an object, a ‘Readable Stream’ will be returned for you to process object content in a streaming way.

var co = require('co');
var OSS = require('ali-oss');
var fs = require('fs);
var client = new OSS({
  region: '<Your region>',
  accessKeyId: '<Your AccessKeyId>',
  accessKeySecret: '<Your AccessKeySecret>',
  bucket: 'Your bucket name'
});
co(function* () {
  var result = yield client.getStream('object-key');
  console.log(result);
  var writeStream = fs.createWriteStream('local-file');
  result.stream.pipe(writeStream);
}).catch(function (err) {
  console.log(err);
});

Download to buffer

You can also download the object content to the buffer through the ‘get’ interface simply:

var co = require('co');
var OSS = require('ali-oss');
var client = new OSS({
  region: '<Your region>',
  accessKeyId: '<Your AccessKeyId>',
  accessKeySecret: '<Your AccessKeySecret>',
  bucket: 'Your bucket name'
});
co(function* () {
  var result = yield client.get('object-key');
  console.log(result.content);
}).catch(function (err) {
  console.log(err);
});

HTTP download

Objects stored in OSS can be downloaded via HTTP directly without using the SDK. HTTP download supports browsers and command-line interface (CLI) tools (such as ‘wget’ and ‘curl’). The URL of the object to be downloaded is generated by the SDK. You can use the ‘signatureUrl’ method to generate the downloadable HTTP address. The validity period of the URL is half an hour by default:

var co = require('co');
var OSS = require('ali-oss');
var client = new OSS({
  region: '<Your region>',
  accessKeyId: '<Your AccessKeyId>',
  accessKeySecret: '<Your AccessKeySecret>',
  bucket: 'Your bucket name'
});
var url = client.signatureUrl('object-key');
console.log(url);
var url = client.signatureUrl('object-key', {expires: 3600});
console.log(url);
// signed URL for PUT
var url = client.signatureUrl('object-key', {method: 'PUT'});
console.log(url);