Node S3

A simple Amazon S3 node.js integration.

Install

npm install node-s3

Usage

Initialization

First initialize the node-s3 module with a URI to your S3 bucket

vars3Url='s3://key:secret@your_bucket.s3.amazonaws.com';vars3=require('node-s3')(s3Url);

It's important that the key/secret provided have write permissions to the bucket.

Alternatively initialize with an options object:

varoptions={key: '...',secret: '...',bucket: '...',pathname: '/foo'// optional: prefix all S3 keys with this path};vars3=require('node-s3')(options);

Uploading

Example 1: Upload a body

s3.put('/some-s3-key',body,callback);

Example 2: Pipe an incoming http request directly to S3

http.createServer(function(req,res){varheaders={'Content-Length': req.headers['content-length']};vars3Req=s3.put('/some-s3-key',{headers: headers},callback);req.pipe(s3Req);}).listen(3000);

API

Common for all functions on the s3 object returned from the node-s3 constructor is that they take up to 3 arguemnts:

• key - The requested S3 key (required). Will be concatinated with the optional pathname given upon initalization
• body or options - Optional body or options hash
• callback - Optional callback called with (err, response, body).

In any case, an instance of curly is returned which you among other things can pipe your data to.

Options or body:

The 2nd argument can either be a string, Buffer og an options hash. The first two should be rather self explanatory, and the options hash can be used to provide custom headers as well as a body to the S3 request:

varoptions={headers: { ... },body: '...'};

Functions:

• s3.head(key, options || body, callback) - Perform a HEAD request
• s3.get(key, options || body, callback) - Perform a GET request
• s3.post(key, options || body, callback) - Perform a POST request
• s3.put(key, options || body, callback) - Perform a PUT request
• s3.del(key, options || body, callback) - Perform a DELETE request

License

MIT