240 lines
7.1 KiB
Text
240 lines
7.1 KiB
Text
|
Metadata-Version: 2.1
|
||
|
|
Name: boto
|
||
|
|
Version: 2.49.0
|
||
|
|
Summary: Amazon Web Services Library
|
||
|
|
Home-page: https://github.com/boto/boto/
|
||
|
|
Author: Mitch Garnaat
|
||
|
|
Author-email: mitch@garnaat.com
|
||
|
|
License: MIT
|
||
|
|
Platform: Posix; MacOS X; Windows
|
||
|
|
Classifier: Development Status :: 5 - Production/Stable
|
||
|
|
Classifier: Intended Audience :: Developers
|
||
|
|
Classifier: License :: OSI Approved :: MIT License
|
||
|
|
Classifier: Operating System :: OS Independent
|
||
|
|
Classifier: Topic :: Internet
|
||
|
|
Classifier: Programming Language :: Python :: 2
|
||
|
|
Classifier: Programming Language :: Python :: 2.6
|
||
|
|
Classifier: Programming Language :: Python :: 2.7
|
||
|
|
Classifier: Programming Language :: Python :: 3
|
||
|
|
Classifier: Programming Language :: Python :: 3.3
|
||
|
|
Classifier: Programming Language :: Python :: 3.4
|
||
|
|
|
||
|
|
####
|
||
|
|
boto
|
||
|
|
####
|
||
|
|
boto 2.49.0
|
||
|
|
|
||
|
|
Released: 11-July-2018
|
||
|
|
|
||
|
|
.. image:: https://travis-ci.org/boto/boto.svg?branch=develop
|
||
|
|
:target: https://travis-ci.org/boto/boto
|
||
|
|
|
||
|
|
.. image:: https://pypip.in/d/boto/badge.svg
|
||
|
|
:target: https://pypi.python.org/pypi/boto/
|
||
|
|
|
||
|
|
******
|
||
|
|
Boto 3
|
||
|
|
******
|
||
|
|
|
||
|
|
`Boto3 <https://github.com/boto/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.
|
||
|
|
|
||
|
|
To assist users who still depend on Boto and cannot immediately switch over, we
|
||
|
|
will be triaging and addressing critical issues and PRs in Boto in the short
|
||
|
|
term. As more users make the switch to Boto3, we expect to reduce our
|
||
|
|
maintenance involvement over time. If we decide on a cutoff date or any
|
||
|
|
significant changes to our maintenance plan, we will make pre-announcements
|
||
|
|
well ahead of schedule to allow ample time for our users to adapt/migrate.
|
||
|
|
|
||
|
|
|
||
|
|
************
|
||
|
|
Introduction
|
||
|
|
************
|
||
|
|
|
||
|
|
Boto is a Python package that provides interfaces to Amazon Web Services.
|
||
|
|
Currently, all features work with Python 2.6 and 2.7. Work is under way to
|
||
|
|
support Python 3.3+ in the same codebase. Modules are being ported one at
|
||
|
|
a time with the help of the open source community, so please check below
|
||
|
|
for compatibility with Python 3.3+.
|
||
|
|
|
||
|
|
To port a module to Python 3.3+, please view our `Contributing Guidelines`_
|
||
|
|
and the `Porting Guide`_. If you would like, you can open an issue to let
|
||
|
|
others know about your work in progress. Tests **must** pass on Python
|
||
|
|
2.6, 2.7, 3.3, and 3.4 for pull requests to be accepted.
|
||
|
|
|
||
|
|
|
||
|
|
********
|
||
|
|
Services
|
||
|
|
********
|
||
|
|
|
||
|
|
At the moment, boto supports:
|
||
|
|
|
||
|
|
* Compute
|
||
|
|
|
||
|
|
* Amazon Elastic Compute Cloud (EC2) (Python 3)
|
||
|
|
* Amazon Elastic Map Reduce (EMR) (Python 3)
|
||
|
|
* AutoScaling (Python 3)
|
||
|
|
* Amazon Kinesis (Python 3)
|
||
|
|
* AWS Lambda (Python 3)
|
||
|
|
* Amazon EC2 Container Service (Python 3)
|
||
|
|
|
||
|
|
* Content Delivery
|
||
|
|
|
||
|
|
* Amazon CloudFront (Python 3)
|
||
|
|
|
||
|
|
* Database
|
||
|
|
|
||
|
|
* Amazon Relational Data Service (RDS)
|
||
|
|
* Amazon DynamoDB (Python 3)
|
||
|
|
* Amazon SimpleDB (Python 3)
|
||
|
|
* Amazon ElastiCache (Python 3)
|
||
|
|
* Amazon Redshift (Python 3)
|
||
|
|
|
||
|
|
* Deployment and Management
|
||
|
|
|
||
|
|
* AWS Elastic Beanstalk (Python 3)
|
||
|
|
* AWS CloudFormation (Python 3)
|
||
|
|
* AWS Data Pipeline (Python 3)
|
||
|
|
* AWS Opsworks (Python 3)
|
||
|
|
* AWS CloudTrail (Python 3)
|
||
|
|
* AWS CodeDeploy (Python 3)
|
||
|
|
|
||
|
|
* Administration & Security
|
||
|
|
|
||
|
|
* AWS Identity and Access Management (IAM) (Python 3)
|
||
|
|
* AWS Key Management Service (KMS) (Python 3)
|
||
|
|
* AWS Config (Python 3)
|
||
|
|
* AWS CloudHSM (Python 3)
|
||
|
|
|
||
|
|
* Application Services
|
||
|
|
|
||
|
|
* Amazon CloudSearch (Python 3)
|
||
|
|
* Amazon CloudSearch Domain (Python 3)
|
||
|
|
* Amazon Elastic Transcoder (Python 3)
|
||
|
|
* Amazon Simple Workflow Service (SWF) (Python 3)
|
||
|
|
* Amazon Simple Queue Service (SQS) (Python 3)
|
||
|
|
* Amazon Simple Notification Server (SNS) (Python 3)
|
||
|
|
* Amazon Simple Email Service (SES) (Python 3)
|
||
|
|
* Amazon Cognito Identity (Python 3)
|
||
|
|
* Amazon Cognito Sync (Python 3)
|
||
|
|
* Amazon Machine Learning (Python 3)
|
||
|
|
|
||
|
|
* Monitoring
|
||
|
|
|
||
|
|
* Amazon CloudWatch (EC2 Only) (Python 3)
|
||
|
|
* Amazon CloudWatch Logs (Python 3)
|
||
|
|
|
||
|
|
* Networking
|
||
|
|
|
||
|
|
* Amazon Route53 (Python 3)
|
||
|
|
* Amazon Route 53 Domains (Python 3)
|
||
|
|
* Amazon Virtual Private Cloud (VPC) (Python 3)
|
||
|
|
* Elastic Load Balancing (ELB) (Python 3)
|
||
|
|
* AWS Direct Connect (Python 3)
|
||
|
|
|
||
|
|
* Payments and Billing
|
||
|
|
|
||
|
|
* Amazon Flexible Payment Service (FPS)
|
||
|
|
|
||
|
|
* Storage
|
||
|
|
|
||
|
|
* Amazon Simple Storage Service (S3) (Python 3)
|
||
|
|
* Amazon Glacier (Python 3)
|
||
|
|
* Amazon Elastic Block Store (EBS)
|
||
|
|
* Google Cloud Storage
|
||
|
|
|
||
|
|
* Workforce
|
||
|
|
|
||
|
|
* Amazon Mechanical Turk
|
||
|
|
|
||
|
|
* Other
|
||
|
|
|
||
|
|
* Marketplace Web Services (Python 3)
|
||
|
|
* AWS Support (Python 3)
|
||
|
|
|
||
|
|
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.
|
||
|
|
|
||
|
|
************
|
||
|
|
Installation
|
||
|
|
************
|
||
|
|
|
||
|
|
Install via `pip`_:
|
||
|
|
|
||
|
|
::
|
||
|
|
|
||
|
|
$ pip install boto
|
||
|
|
|
||
|
|
Install from source:
|
||
|
|
|
||
|
|
::
|
||
|
|
|
||
|
|
$ git clone git://github.com/boto/boto.git
|
||
|
|
$ cd boto
|
||
|
|
$ python setup.py install
|
||
|
|
|
||
|
|
**********
|
||
|
|
ChangeLogs
|
||
|
|
**********
|
||
|
|
|
||
|
|
To see what has changed over time in boto, you can check out the
|
||
|
|
release notes at `http://docs.pythonboto.org/en/latest/#release-notes`
|
||
|
|
|
||
|
|
***************************
|
||
|
|
Finding Out More About Boto
|
||
|
|
***************************
|
||
|
|
|
||
|
|
The main source code repository for boto can be found on `github.com`_.
|
||
|
|
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: http://webchat.freenode.net/?channels=boto
|
||
|
|
|
||
|
|
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_ACCESS_KEY_ID** - Your AWS Access Key ID
|
||
|
|
|
||
|
|
**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.
|
||
|
|
|
||
|
|
.. _Contributing Guidelines: https://github.com/boto/boto/blob/develop/CONTRIBUTING
|
||
|
|
.. _Porting Guide: http://boto.readthedocs.org/en/latest/porting_guide.html
|
||
|
|
.. _pip: http://www.pip-installer.org/
|
||
|
|
.. _release notes: https://github.com/boto/boto/wiki
|
||
|
|
.. _github.com: http://github.com/boto/boto
|
||
|
|
.. _Online documentation: http://docs.pythonboto.org
|
||
|
|
.. _Python Cheese Shop: http://pypi.python.org/pypi/boto
|
||
|
|
.. _this: http://docs.pythonboto.org/en/latest/boto_config_tut.html
|
||
|
|
.. _gitflow: http://nvie.com/posts/a-successful-git-branching-model/
|
||
|
|
.. _neo: https://github.com/boto/boto/tree/neo
|
||
|
|
.. _boto-users Google Group: https://groups.google.com/forum/?fromgroups#!forum/boto-users
|
||
|
|
|
||
|
|
|