上传文件

用户可以通过以下方式向OSS中上传文件：

• 上传本地文件
• 上传Buffer内容
• 分片上传

上传本地文件

请直接参考分片上传

上传Buffer内容

用户也可以通过put接口简单地将Buffer中的内容上传到OSS：

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.put('object-key', new Buffer('hello world'));
  console.log(result);
}).catch(function (err) {
  console.log(err);
});

分片上传

在需要上传的文件较大时，可以通过multipartUpload接口进行分片上传。分片上传的好处是将一个大请求分成多个小请求来执行，这样当其中一些请求失败后，不需要重新上传整个文件，而只需要上传失败的分片就可以了。一般对于大于100MB的文件，建议采用分片上传的方法，每次进行分片上传都建议重新new一个新的OSS实例。
相关参数：

• name {String} object 名称
• file {File} HTML5 Web File
• [options] {Object} 额外参数
  • [checkpoint] {Object} 断点记录点，可以进行断点续传, 如果设置这个参数，上传会从断点开始，如果没有设置，就会重新上传.
    • file {File} 用户选取的文件对象，如果浏览器重启后这个需要用户手动触发进行设置
    • name {String} 上传的object key
    • fileSize {Number} 文件大小
    • partSize {Number} 分片大小
    • uploadId {String} 分片上传的ID
    • doneParts {Array} 已完成的分片的数组, 包含的对象结构如下
      • number {Number} 分片的number
      • etag {String} 分片的etag
  • [partSize] {Number} 分片大小
  • [progress] {Function} thunk 或 generator形式, 回调函数包含三个参数
    • (percentage {Number} 进度百分比(0-1之间小数)
    • checkpoint {Object} 断点记录点
    • res {Object}) 单次part成功返回的response
  • [meta] {Object} 用户自定义header meta信息, header前缀 x-oss-meta-
  • [headers] {Object} http 额外的头字段, 详情请看 RFC 2616
    • ‘Cache-Control’ 通用消息头被用于在http 请求和响应中通过指定指令来实现缓存机制, e.g.: Cache-Control: public, no-cache
    • ‘Content-Disposition’ 指示回复的内容该以何种形式展示，是以内联的形式（即网页或者页面的一部分），还是以附件的形式下载并保存到本地, e.g.: Content-Disposition: somename
    • ‘Content-Encoding’ 用于对特定媒体类型的数据进行压缩, e.g.: Content-Encoding: gzip
    • ‘Expires’ 过期时间, e.g.: Expires: 3600000

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.multipartUpload('object-key', 'local-file', {
    progress: function* (p) {
      console.log('Progress: ' + p);
    },
    meta: {
      year: 2017,
      people: 'test'
    },
    mime: 'image/jpeg'
  });
  console.log(result);
  var head = yield client.head('object-key');
  console.log(head);
}).catch(function (err) {
  console.log(err);
});

上面的progress参数是一个进度回调函数，用于获取上传进度。progress可以是一个generator function(function*)，也可以是一个”thunk”：

var progress = function (p) {
  return function (done) {
    console.log(p);
    done();
  };
};

上面的meta参数是一个用户自定义的元数据，通过head接口可以获取到object的meta数据，但是这个meta header 需要在控制台跨域设置里边的暴露header中设置好，如图：请求成功后的返回结果展示:

暂停分片上传

1. 分片上传暂停后，恢复上传时需要将之前记录的checkpoint参数传入即可.
2. 每次进行分片上传建议重新new一个新的OSS实例.

var co = require('co');
var OSS = require('ali-oss')
var ossConfig = {
  region: '<Your region>',
  accessKeyId: '<Your AccessKeyId>',
  accessKeySecret: '<Your AccessKeySecret>',
  bucket: 'Your bucket name'
}
var client = new OSS(ossConfig);
var tempCheckpoint;
co(function* () {
    var result = yield client.multipartUpload('object-key', 'local-file', {
    progress: function* (p, checkpoint) {
      // 记录断点, 如果关闭了浏览器，然后重新启动继续上传的话，是不行的，请参考上边对file对象的描述
      tempCheckpoint = checkpoint;
    }
  })
}
// 暂停分片上传方法
client.cancel();
// 恢复上传
var resumeclient = new OSS(ossConfig);
co(function* () {
    var result = yield resumeclient.multipartUpload('object-key', 'local-file', {
    progress: function* (p, checkpoint) {
      tempCheckpoint = checkpoint;
    },
    checkpoint: tempCheckpoint
  })
}