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) {})

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%