NOTE: AwsSum is now deprecated. Please use aws-sdk instead.

awssum-amazon-s3 #

This is an ``AwsSum` plugin!

You'll need to add awssum-amazon-s3 to your package.json
dependencies. Both awssum and
awssum-amazon are pulled in as peer dependencies.

Example ##

List all your buckets:

`
var fmt = require('fmt');
var amazonS3 = require('awssum-amazon-s3');

var s3 = new amazonS3.S3({
'accessKeyId' : process.env.ACCESS_KEY_ID,
'secretAccessKey' : process.env.SECRET_ACCESS_KEY,
'region' : amazonS3.US_EAST_1
});

s3.ListBuckets(function(err, data) {
fmt.dump(err, 'err');
fmt.dump(data, 'data');
});
`

Streaming ##

Streaming uploads:

`
var fmt = require('fmt');
var amazonS3 = require('awssum-amazon-s3');

var s3 = new amazonS3.S3({
'accessKeyId' : process.env.ACCESS_KEY_ID,
'secretAccessKey' : process.env.SECRET_ACCESS_KEY,
'region' : amazonS3.US_EAST_1
});

// you must run fs.stat to get the file size for the content-length header (s3 requires this)
fs.stat(__filename, function(err, file_info) {
var bodyStream = fs.createReadStream( __filename );

var options = {
BucketName : bucket,
ObjectName : 'amazon.js',
ContentLength : file_info.size,
Body : bodyStream
};

s3.PutObject(options, function(err, data) {
fmt.dump(err, 'err');
fmt.dump(data, 'data');
});
});
`

Streaming downloads:

`
var fmt = require('fmt');
var amazonS3 = require('awssum-amazon-s3');

var s3 = new amazonS3.S3({
'accessKeyId' : process.env.ACCESS_KEY_ID,
'secretAccessKey' : process.env.SECRET_ACCESS_KEY,
'region' : amazonS3.US_EAST_1
});

var options = {
BucketName : 'pie-17',
ObjectName : 'javascript-file.js',
};

s3.GetObject(options, { stream : true }, function(err, data) {
fmt.dump(err, 'err');
fmt.dump(data, 'data');

// stream this file to stdout
fmt.sep();
fmt.title('The File');
data.Stream.pipe(process.stdout);
data.Stream.on('end', function() {
fmt.sep();
});
});
``

Operations ##

$3

Docs: ListBuckets on AWS

$3

Docs: DeleteBucket on AWS

$3

Docs: DeleteBucketCors on AWS

$3

Docs: DeleteBucketLifecycle on AWS

$3

Docs: DeleteBucketPolicy on AWS

$3

Docs: [DeleteBucketTagging on AWS]()

$3

Docs: DeleteBucketWebsite on AWS

$3

Docs: ListObjects on AWS

$3

Docs: GetBucketAcl on AWS

$3

Docs: GetBucketCors on AWS

$3

Docs: GetBucketLifecycle on AWS

$3

Docs: GetBucketPolicy on AWS

$3

Docs: [GetBucketTagging on AWS]()

$3

Docs: GetBucketLocation on AWS

$3

Docs: GetBucketLogging on AWS

$3

Docs: GetBucketNotification on AWS

$3

Docs: GetBucketObjectVersions on AWS

$3

Docs: GetBucketRequestPayment on AWS

$3

Docs: GetBucketVersioning on AWS

$3

Docs: GetBucketWebsite on AWS

$3

Docs: CheckBucket on AWS

$3

Docs: ListMultipartUploads on AWS

$3

Docs: CreateBucket on AWS

$3

Docs: PutBucketAcl on AWS

$3

Docs: PutBucketCors on AWS

$3

Docs: PutBucketLifecycle on AWS

$3

Docs: PutBucketPolicy on AWS

$3

Docs: PutBucketLogging on AWS

$3

Docs: PutBucketNotification on AWS

$3

Docs: [PutBucketTagging on AWS]()

$3

Docs: PutBucketRequestPayment on AWS

$3

Docs: PutBucketVersioning on AWS

$3

Docs: PutBucketWebsite on AWS

$3

Docs: DeleteObject on AWS

$3

Docs: DeleteMultipleObjects on AWS

$3

Docs: GetObject on AWS

$3

Docs: GetObjectAcl on AWS

$3

Docs: GetObjectTorrent on AWS

$3

Docs: GetObjectMetadata on AWS

$3

Docs: OptionsObject on AWS

$3

Docs: PostObjectRestore on AWS

$3

Docs: PutObject on AWS

$3

Docs: PutObjectAcl on AWS

$3

Docs: CopyObject on AWS

$3

Docs: InitiateMultipartUpload on AWS

$3

Docs: UploadPart on AWS

$3

Docs: UploadPartCopy on AWS

$3

Docs: CompleteMultipartUpload on AWS

$3

Docs: AbortMultipartUpload on AWS

$3

Docs: ListParts on AWS

Author #

Written by Andrew Chilton - Blog -
Twitter.

License #

* Copyright 2011-2013 Apps Attic Ltd. All rights reserved.
* Copyright 2013 Andrew Chilton. All rights reserved.

(Ends)