A simple Node.js application illustrating usage of the AWS SDK for Node.js.

The only requirement of this application is the Node Package Manager. All other dependencies (including the AWS SDK for Node.js) can be installed with:

npm install

You need to set your AWS security credentials before the sample is able to connect to AWS. The SDK will automatically pick up credentials in environment variables:

export AWS_ACCESS_KEY_ID="Your AWS Access Key ID"
export AWS_SECRET_ACCESS_KEY="Your AWS Secret Access Key"

See the Security Credentials page. It's also possible to configure your credentials via a configuration file or directly in source. See the AWS SDK for Node.js Developer Guide for more information.

This sample application connects to Amazon's Simple Storage Service (S3), creates a bucket, and uploads a file to that bucket. The script will automatically create the file to upload. All you need to do is run it:

node sample.js

The S3 documentation has a good overview of the restrictions for bucket names for when you start making your own buckets.

This sample application is distributed under the Apache License, Version 2.0.