baidu-bcs

baidu-bcs

• baidu bcs node.js sdk

install

npm install baidu-bcs

api

• putBucket
• listBucket
• deleteBucket
• putObject
• copyObject
• putSuperfile
• getObject
• headObject
• listObject
• deleteObject
• putAcl
• getAcl

document

create bcs client

var BCS = require('baidu-bcs')
var bcs = BCS.createClient({
  accessKey: 'your access key',
  secretKey: 'your secret key'
})

put bucket

bcs.putBucket({
  bucket: '',
  acl: ''
}, function (error, result) {})

put bucket with acl

bcs.putBucket({
  bucket: '',
  acl: ''
}, function (error, result) {})

list bucket

bcs.listBucket(function (error, result) {})

delete bucket

bcs.deleteBucket({
  bucket: ''
}, function (error, result) {})

put object with file path

bcs.putObject({
  bucket: '',
  object: '',
  source: './index.js'
}, function (error, result) {})

put object with buffer

bcs.putObject({
  bucket: '',
  object: '',
  source: new Buffer('baidu-bcs'),
  headers: {
    'Content-Type': 'text/plain'
  }
}, function (error, result) {})

put object with stream

bcs.putObject({
  bucket: '',
  object: '',
  source: fs.createReadStream(__filename),
  headers: {
    'Content-Type': 'text/plain',
    'Content-Length': fs.statSync(__filename).size // important: the 'Content-Type' is must
  }
}, function (error, result) {})

put object with headers

copy object

bcs.copyObject({
  bucket: '',
  object: '',
  sourceBucket: '',
  sourceObject: '',
  headers: {
    'Content-Type': ''
  }
}, function (error, result) {})

head object

bcs.headObject({
  bucket: '',
  object: ''
}, function (error, result) {})

list object

bcs.listObject({
  bucket: '',
  start: 1,
  limit: 1
}, function (error, result) {})

get object

bcs.getObject({
  bucket: '',
  object: '',
}, function (error, result) {})

get object to file path

bcs.getObject({
  bucket: '',
  object: '',
  dest: './xxoo.xo'
}, function (error, result) {})

get object to write stream

var writeStream = fs.createWriteStream('./xxoo.xo')
bcs.getObject({
  bucket: '',
  object: '',
  dest: writeStream
}, function (error, result) {})

delete bucket

bcs.deleteBucket({
  bucket: ''
}, function (error, result) {})

put acl

bcs.putAcl({
  bucket: '',
  acl: 'private'
}, function (error, result) {})

get acl

bcs.getAcl({
  bucket: ''
}, function (error, result) {})

params note

• bucket - bucket name
• object - object name
• headers - you can set http headers by this
• sourceBucket - only for copyObject()
• sourceObject - only for copyObject()
• the result of callback is a object contain: status, headers, body

test

coverage: 94%

License

MIT