Install Latest Version
npm install aws-sdk
Please note: Installing the aws-sdk npm package on Windows may display errors while trying to install the optional dependency for libxmljs. This error can be safely ignored.
This initial release of the AWS SDK for Node.js is a preview release. We are looking for feedback on performance, and usability before we lock down the public interface. Many APIs are currently marked as private. We plan to expand the public APIs based on user feedback.
Features
| Change | Description |
|---|---|
| Configuration |
To get started you need to configure at a minimum your AWS credentaials and your default region.
// static credentials, generally not a good idea
AWS.config.update({accessKeyId: 'AKID', secretAccessKey: 'SECRET', region:'us-west-1'});
// Loading credentials/configuration from disk
AWS.config.loadFromPath('./path/to/config.json');
If you export AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY to your environment, the AWS SDK for Node.js will use these automatically. |
| Services |
This initial release provides the following service interfaces:
|
| Asynchronous APIs |
Each service has a client property that provides one method for each API operation.
var s3 = new AWS.S3();
var req = s3.client.listBuckets()
req.done(function(response) {
console.log(response.data);
});
req.error(function(response) {
console.log(response.error);
});
|
| Developer Guide |
For a more comprehensive getting started guide, see the Developer Guide. |
Supported API Versions
This release of the SDK supports the following API versions:
| Service | API Version |
|---|---|
| Amazon DynamoDB | 2011-12-05 |
| Amazon Elastic Compute Cloud | 2012-07-20 |
| Amazon Simple Storage Service | 2006-03-01 |
| Amazon Simple Workflow Service | 2012-01-25 |