Skip to content
This repository

Python interface to Amazon Web Services

Merge branch 'danielgtaylor-cs2' into develop

* danielgtaylor-cs2:
  Remove unused wait_for_state function
  Use isinstance instead of type()
  Fix copyright year
  Documentation Updates
  CloudSearch2 updates
  Handle case where self.domain isn't defined and we have to default to some API version number. Use new 2013-01-01 in this case.
  Pass partial= param into query layer
  Implement new Cloudsearch API 2013-01-01 as cloudsearch2 module
latest commit b0ababa271
James Saryerwinnie jamesls authored April 21, 2014
Octocat-spinner-32 bin [MTurk CLI] Get all assignments, not just the first 100. March 28, 2014
Octocat-spinner-32 boto Remove unused wait_for_state function April 21, 2014
Octocat-spinner-32 docs Documentation Updates April 18, 2014
Octocat-spinner-32 scripts Started change to load endpoints from JSON. January 28, 2014
Octocat-spinner-32 tests CloudSearch2 updates April 17, 2014
Octocat-spinner-32 .gitignore Another Py2.5 fix. October 06, 2013
Octocat-spinner-32 .travis.yml Altered the pip install for Travis. February 27, 2014
Octocat-spinner-32 CONTRIBUTING Correct typo "possile" --> "possible" April 02, 2014
Octocat-spinner-32 LICENSE Adding a LICENSE file. Fixes #1199. January 08, 2013
Octocat-spinner-32 Started change to load endpoints from JSON. January 28, 2014
Octocat-spinner-32 README.rst Bumped to 2.27.0 March 06, 2014
Octocat-spinner-32 pylintrc who really cares if there is a space after a comma or not February 23, 2010
Octocat-spinner-32 requirements.txt Bumped reqs to use a higher version of HTTPretty. November 05, 2013
Octocat-spinner-32 setup.cfg Added initial wheel support. November 15, 2013
Octocat-spinner-32 CloudSearch2 updates April 17, 2014
Octocat-spinner-32 tox.ini Add a tox.ini file June 13, 2012


boto 2.27.0

Released: 6-March-2014


Boto is a Python package that provides interfaces to Amazon Web Services. At the moment, boto supports:

  • Compute
    • Amazon Elastic Compute Cloud (EC2)
    • Amazon Elastic Map Reduce (EMR)
    • AutoScaling
    • Amazon Kinesis
  • Content Delivery
    • Amazon CloudFront
  • Database
    • Amazon Relational Data Service (RDS)
    • Amazon DynamoDB
    • Amazon SimpleDB
    • Amazon ElastiCache
    • Amazon Redshift
  • Deployment and Management
    • AWS Elastic Beanstalk
    • AWS CloudFormation
    • AWS Data Pipeline
    • AWS Opsworks
    • AWS CloudTrail
  • Identity & Access
    • AWS Identity and Access Management (IAM)
  • Application Services
    • Amazon CloudSearch
    • Amazon Elastic Transcoder
    • Amazon Simple Workflow Service (SWF)
    • Amazon Simple Queue Service (SQS)
    • Amazon Simple Notification Server (SNS)
    • Amazon Simple Email Service (SES)
  • Monitoring
    • Amazon CloudWatch
  • Networking
    • Amazon Route53
    • Amazon Virtual Private Cloud (VPC)
    • Elastic Load Balancing (ELB)
    • AWS Direct Connect
  • Payments and Billing
    • Amazon Flexible Payment Service (FPS)
  • Storage
    • Amazon Simple Storage Service (S3)
    • Amazon Glacier
    • Amazon Elastic Block Store (EBS)
    • Google Cloud Storage
  • Workforce
    • Amazon Mechanical Turk
  • Other
    • Marketplace Web Services
    • AWS Support

The goal of boto is to support the full breadth and depth of Amazon Web Services. In addition, boto provides support for other public services such as Google Storage in addition to private cloud systems like Eucalyptus, OpenStack and Open Nebula.

Boto is developed mainly using Python 2.6.6 and Python 2.7.3 on Mac OSX and Ubuntu Maverick. It is known to work on other Linux distributions and on Windows. Most of Boto requires no additional libraries or packages other than those that are distributed with Python. Efforts are made to keep boto compatible with Python 2.5.x but no guarantees are made.


Install via pip:

$ pip install boto

Install from source:

$ git clone git://
$ cd boto
$ python install


To see what has changed over time in boto, you can check out the release notes at

Finding Out More About Boto

The main source code repository for boto can be found on The boto project uses the gitflow model for branching.

Online documentation is also available. The online documentation includes full API documentation as well as Getting Started Guides for many of the boto modules.

Boto releases can be found on the Python Cheese Shop.

Join our IRC channel #boto on FreeNode. Webchat IRC channel:

Join the boto-users Google Group.

Getting Started with Boto

Your credentials can be passed into the methods that create connections. Alternatively, boto will check for the existence of the following environment variables to ascertain your credentials:


AWS_SECRET_ACCESS_KEY - Your AWS Secret Access Key

Credentials and other boto-related settings can also be stored in a boto config file. See this for details.

Something went wrong with that request. Please try again.