You are viewing the documentation for an older version of boto (boto2).

Boto3, the next version of Boto, is now stable and recommended for general use. It can be used side-by-side with Boto in the same project, so it is easy to start using Boto3 in your existing projects as well as new projects. Going forward, API updates and all new feature work will be focused on Boto3.

For more information, see the documentation for boto3.

boto v2.25.0


This release includes Amazon Route53 service and documentation updates, preliminary log file support for Amazon Relational Database Service (RDS), as well as various other small fixes. Also included is an opt-in to use signature version 4 with Amazon EC2.

IMPORTANT - This release also include a SIGNIFICANT underlying change to the Amazon S3 get_bucket method, to addresses the blog post by AppNeta. We’ve altered the default behavior to now perform a HEAD on the bucket, in place of the old GET behavior (which would fetch a zero-length list of keys).

This should reduce all users costs & should also be mostly backward-compatible. HOWEVER, if you were previously parsing the exception message from S3Connection.get_bucket, you will have to change your code (see the S3 tutorial for details). HEAD does not return as detailed of error messages & while we’ve attempted to patch over as much of the differences as we can, there may still be edge-cases over the prior behavior.