AWS SDK for JavaScript in the browser and Node.js
JavaScript CoffeeScript Cucumber Ruby HTML CSS
Latest commit 7e3c279 Aug 23, 2016 @LiuJoyceC LiuJoyceC Tag release v2.5.3
  #1078, #1094
Failed to load latest commit information.
.changes Updates SDK to version 2.5.3 Aug 23, 2016
apis Updates SDK to version 2.5.3 Aug 23, 2016
dist-tools Adds AutoScaling, ApplicationAutoScaling, and CodeDeploy as default b… Aug 4, 2016
dist Tag release v2.5.3 Aug 23, 2016
doc-src Tag release v2.5.3 Aug 23, 2016
features Updates SDK version to 2.5.0. See for details. Aug 11, 2016
lib Tag release v2.5.3 Aug 23, 2016
scripts Adds README. Fixes bug in util.checkAndNormalizeVersion. Adds more ch… Jul 18, 2016
tasks Update links to point to non-frames URL Nov 4, 2014
test Merge pull request #1078 from wryun/terminate-eachitem Aug 18, 2016
.eslintrc Update linter rules Jun 16, 2015
.gitignore Add istanbul for coverage and improve some test coverage Jun 16, 2014
.jshintrc Remove JSHint options CC doesn't understand Oct 2, 2014
.npmignore Don't ignore dist/ Aug 18, 2015
.tesselinclude Adds .tesselinclude for resource deployment inclusion. Fixes gh-967 Apr 18, 2016
.travis.yml Updates travis to use phantomjs 2.0.0 Jun 13, 2016
.yardopts Add upgrading notes (1.x-2.0) to repository Jun 10, 2014
.yardopts_guide Add to guide Jun 13, 2014 Updates SDK to version 2.5.3 Aug 23, 2016 Adds add-change CLI to allow easy creation of changelog entry JSON fi… Jul 14, 2016
Gemfile Update navigation bar in template Jul 8, 2015
Gemfile.lock Update navigation bar in template Jul 8, 2015
LICENSE.txt Updating copyright year in NOTICE. Making LICENSE a standard Apache 2… Feb 22, 2016
NOTICE.txt Updating copyright year in NOTICE. Making LICENSE a standard Apache 2… Feb 22, 2016 Tag release v2.5.3 Aug 23, 2016
Rakefile Don't need bundle/setup in Rakefile Mar 14, 2014 Update upgrading notes to mention removed `.client` property. Jun 20, 2014
bower.json Update bower.json Jul 7, 2015
configuration.sample Add support for AWS.DeviceFarm Jul 14, 2015
index.js Add index.js for convenience Jul 8, 2014
package.json Tag release v2.5.3 Aug 23, 2016
testem.json Update testem.json Aug 26, 2014

AWS SDK for JavaScript


Gitter chat

Version Build Status Coverage Status

The official AWS SDK for JavaScript, available for browsers and mobile devices, or Node.js backends

Release notes can be found at

If you are upgrading from 1.x to 2.0 of the SDK, please see the {} notes for information on how to migrate existing code to work with the new major version.


In the Browser

To use the SDK in the browser, simply add the following script tag to your HTML pages:

<script src=""></script>

You can also build a custom browser SDK with your specified set of AWS services. This can allow you to reduce the SDK's size, specify different API versions of services, or use AWS services that don't currently support CORS if you are working in an environment that does not enforce CORS. To get started:

The AWS SDK is also compatible with browserify.

In Node.js

The preferred way to install the AWS SDK for Node.js is to use the npm package manager for Node.js. Simply type the following into a terminal window:

npm install aws-sdk

Using Bower

You can also use Bower to install the SDK by typing the following into a terminal window:

bower install aws-sdk-js

Usage and Getting Started

You can find a getting started guide at:

Supported Services

Note: Although all services are supported in the browser version of the SDK, not all of the services are available in the default hosted build (using the script tag provided above). A list of services in the hosted build are provided in the "Working With Services" section of the browser SDK guide, including instructions on how to build a custom version of the SDK with extra services.

The SDK currently supports the following services:

Service Name Class Name API Version
Amazon API GatewayAWS.APIGateway2015-07-09
Amazon CloudFrontAWS.CloudFront2014-10-21
Amazon CloudHSMAWS.CloudHSM2014-05-30
Amazon CloudSearchAWS.CloudSearch2013-01-01
Amazon CloudSearch DomainAWS.CloudSearchDomain2013-01-01
Amazon CloudWatchAWS.CloudWatch2010-08-01
Amazon CloudWatch EventsAWS.CloudWatchLogs2015-10-07
Amazon CloudWatch LogsAWS.CloudWatchLogs2014-03-28
Amazon Cognito IdentityAWS.CognitoIdentity2014-06-30
Amazon Cognito SyncAWS.CognitoSync2014-06-30
Amazon DynamoDBAWS.DynamoDB2012-08-10
Amazon DynamoDB StreamsAWS.DynamoDBStreams2012-08-10
Amazon EC2 Container RegistryAWS.ECR2015-09-21
Amazon EC2 Container ServiceAWS.ECS2014-11-13
Amazon Elastic Compute CloudAWS.EC22014-10-01
Amazon Elastic File SystemAWS.EFS2015-02-01
Amazon Elastic MapReduceAWS.EMR2009-03-31
Amazon Elastic TranscoderAWS.ElasticTranscoder2012-09-25
Amazon ElastiCacheAWS.ElastiCache2014-09-30
Amazon Elasticsearch ServiceAWS.ES2015-01-01
Amazon GameLiftAWS.GameLift2015-10-01
Amazon GlacierAWS.Glacier2012-06-01
Amazon InspectorAWS.Inspector2016-02-16
Amazon KinesisAWS.Kinesis2013-12-02
Amazon Kinesis AnalyticsAWS.KinesisAnalytics2015-08-14
Amazon Kinesis FirehoseAWS.Firehose2015-08-04
Amazon Machine LearningAWS.MachineLearning2014-12-12
Amazon Mobile AnalyticsAWS.MobileAnalytics2014-06-05
Amazon RedshiftAWS.Redshift2012-12-01
Amazon Relational Database ServiceAWS.RDS2014-09-01
Amazon Route 53AWS.Route532013-04-01
Amazon Route 53 DomainsAWS.Route53Domains2014-05-15
Amazon Simple Email ServiceAWS.SES2010-12-01
Amazon Simple Notification ServiceAWS.SNS2010-03-31
Amazon Simple Queue ServiceAWS.SQS2012-11-05
Amazon Simple Storage ServiceAWS.S32006-03-01
Amazon Simple Systems Management ServiceAWS.SSM2014-11-06
Amazon Simple Workflow ServiceAWS.SWF2012-01-25
Amazon SimpleDBAWS.SimpleDB2009-04-15
Amazon SnowballAWS.Snowball2016-06-30
Amazon WorkSpacesAWS.WorkSpaces2015-04-08
Auto ScalingAWS.AutoScaling2011-01-01
AWS Certificate ManagerAWS.ACM2015-12-08
AWS CloudFormationAWS.CloudFormation2010-05-15
AWS CloudTrailAWS.CloudTrail2013-11-01
AWS CodeCommitAWS.CodeCommit2015-04-13
AWS CodeDeployAWS.CodeDeploy2014-10-06
AWS CodePipelineAWS.CodePipeline2015-07-09
AWS ConfigAWS.ConfigService2014-11-12
AWS Data PipelineAWS.DataPipeline2012-10-29
AWS Database Migration ServiceAWS.DMS2016-01-01
AWS Device FarmAWS.DeviceFarm2015-06-23
AWS Direct ConnectAWS.DirectConnect2012-10-25
AWS Directory ServiceAWS.DirectoryService2015-04-16
AWS Elastic BeanstalkAWS.ElasticBeanstalk2010-12-01
AWS Identity and Access ManagementAWS.IAM2010-05-08
AWS Import/ExportAWS.ImportExport2010-06-01
AWS IoTAWS.Iot2015-05-28
AWS IoT Data PlaneAWS.IotData2015-05-28
AWS Key Management ServiceAWS.KMS2014-11-01
AWS LambdaAWS.Lambda2015-03-31
AWS Marketplace Commerce AnalyticsAWS.MarketplaceCommerceAnalytics2015-07-01
AWS Marketplace MeteringAWS.MarketplaceMetering2016-01-14
AWS OpsWorksAWS.OpsWorks2013-02-18
AWS Security Token ServiceAWS.STS2011-06-15
AWS Storage GatewayAWS.StorageGateway2013-06-30
AWS SupportAWS.Support2013-04-15
AWS WAFAWS.WAF2015-08-24
Elastic Load BalancingAWS.ELB2012-06-01
Elastic Load Balancing v2AWS.ELBv22015-12-01


This SDK is distributed under the Apache License, Version 2.0, see LICENSE.txt and NOTICE.txt for more information.