Universal Command Line Environment for AWS.
Project description
# aws-cli
[](https://travis-ci.org/aws/aws-cli)
[](https://gitter.im/aws/aws-cli)
This package provides a unified command line interface to Amazon Web Services.
Jump to:
[Getting Started](#getting-started)
[Getting Help](#getting-help)
[More Resources](#more-resources)
## Getting Started
This README is for the AWS CLI version 1. If you are looking for information about the AWS CLI version 2, please visit the [v2 branch](https://github.com/aws/aws-cli/tree/v2).
### Requirements
The aws-cli package works on Python versions:
2.7.x and greater
3.4.x and greater
3.5.x and greater
3.6.x and greater
3.7.x and greater
3.8.x and greater
On 10/09/2019 support for Python 2.6 and Python 3.3 was deprecated and support was dropped on 01/10/2020. To avoid disruption, customers using the AWS CLI on Python 2.6 or 3.3 will need to upgrade their version of Python or pin the version of the AWS CLI in use prior to 01/10/2020. For more information, see this [blog post](https://aws.amazon.com/blogs/developer/deprecation-of-python-2-6-and-python-3-3-in-botocore-boto3-and-the-aws-cli/).
Attention!
We recommend that all customers regularly monitor the [Amazon Web Services Security Bulletins website](https://aws.amazon.com/security/security-bulletins) for any important security bulletins related to aws-cli.
### Installation
The safest way to install the AWS CLI is to use [pip](https://pip.pypa.io/en/stable/) in a virtualenv:
$ python -m pip install awscli
or, if you are not installing in a virtualenv, to install globally:
$ sudo python -m pip install awscli
or for your user:
$ python -m pip install –user awscli
If you have the aws-cli package installed and want to upgrade to the latest version you can run:
$ python -m pip install –upgrade awscli
This will install the aws-cli package as well as all dependencies.
Note
On macOS, if you see an error regarding the version of `six` that came with `distutils` in El Capitan, use the `–ignore-installed` option:
$ sudo python -m pip install awscli –ignore-installed six
On Linux and Mac OS, the AWS CLI can be installed using a [bundled installer](https://docs.aws.amazon.com/cli/latest/userguide/install-linux.html#install-linux-bundled). The AWS CLI can also be installed on Windows via an [MSI Installer](https://docs.aws.amazon.com/cli/latest/userguide/install-windows.html#msi-on-windows).
If you want to run the develop branch of the AWS CLI, see the [Development Version](CONTRIBUTING.md#development-version) section of the contributing guide.
See the [installation](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv1.html) section of the AWS CLI User Guide for more information.
### Configuration
Before using the AWS CLI, you need to configure your AWS credentials. You can do this in several ways:
Configuration command
Environment variables
Shared credentials file
Config file
IAM Role
The quickest way to get started is to run the aws configure command:
$ aws configure AWS Access Key ID: MYACCESSKEY AWS Secret Access Key: MYSECRETKEY Default region name [us-west-2]: us-west-2 Default output format [None]: json
To use environment variables, do the following:
$ export AWS_ACCESS_KEY_ID=<access_key> $ export AWS_SECRET_ACCESS_KEY=<secret_key>
To use the shared credentials file, create an INI formatted file like this:
[default] aws_access_key_id=MYACCESSKEY aws_secret_access_key=MYSECRETKEY
[testing] aws_access_key_id=MYACCESKEY aws_secret_access_key=MYSECRETKEY
and place it in ~/.aws/credentials (or in %UserProfile%.aws/credentials on Windows). If you wish to place the shared credentials file in a different location than the one specified above, you need to tell aws-cli where to find it. Do this by setting the appropriate environment variable:
$ export AWS_SHARED_CREDENTIALS_FILE=/path/to/shared_credentials_file
To use a config file, create an INI formatted file like this:
[default] aws_access_key_id=<default access key> aws_secret_access_key=<default secret key> # Optional, to define default region for this profile. region=us-west-1
[profile testing] aws_access_key_id=<testing access key> aws_secret_access_key=<testing secret key> region=us-west-2
and place it in ~/.aws/config (or in %UserProfile%.awsconfig on Windows). If you wish to place the config file in a different location than the one specified above, you need to tell the AWS CLI where to find it. Do this by setting the appropriate environment variable:
$ export AWS_CONFIG_FILE=/path/to/config_file
As you can see, you can have multiple profiles defined in both the shared credentials file and the configuration file. You can then specify which profile to use by using the –profile option. If no profile is specified the default profile is used.
In the config file, except for the default profile, you must prefix each config section of a profile group with profile. For example, if you have a profile named "testing" the section header would be [profile testing].
The final option for credentials is highly recommended if you are using the AWS CLI on an EC2 instance. [IAM Roles](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html) are a great way to have credentials installed automatically on your instance. If you are using IAM Roles, the AWS CLI will find and use them automatically.
In addition to credentials, a number of other variables can be configured either with environment variables, configuration file entries, or both. See the [AWS Tools and SDKs Shared Configuration and Credentials Reference Guide](https://docs.aws.amazon.com/credref/latest/refdocs/overview.html) for more information.
For more information about configuration options, please refer to the [AWS CLI Configuration Variables topic](http://docs.aws.amazon.com/cli/latest/topic/config-vars.html#cli-aws-help-config-vars). You can access this topic from the AWS CLI as well by running aws help config-vars.
### Basic Commands
An AWS CLI command has the following structure:
$ aws <command> <subcommand> [options and parameters]
For example, to list S3 buckets, the command would be:
$ aws s3 ls
To view help documentation, use one of the following:
$ aws help $ aws <command> help $ aws <command> <subcommand> help
To get the version of the AWS CLI:
$ aws –version
To turn on debugging output:
$ aws –debug <command> <subcommand>
You can read more information on the [Using the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-using.html) chapter of the AWS CLI User Guide.
### Command Completion
The aws-cli package includes a command completion feature for Unix-like systems. This feature is not automatically installed so you need to configure it manually. To learn more, read the [AWS CLI Command completion topic](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-completion.html).
## Getting Help
The best way to interact with our team is through GitHub. You can [open an issue](https://github.com/aws/aws-cli/issues/new/choose) and choose from one of our templates for guidance, bug reports, or feature requests.
You may find help from the community on [Stack Overflow](https://stackoverflow.com/) with the tag [aws-cli](https://stackoverflow.com/questions/tagged/aws-cli) or on the [AWS Discussion Forum for CLI](https://forums.aws.amazon.com/forum.jspa?forumID=150). If you have a support plan with [AWS Premium Support](https://aws.amazon.com/premiumsupport), you can also create a new support case.
Please check for open similar [issues](https://github.com/aws/aws-cli/issues/) before opening another one.
The AWS CLI implements AWS service APIs. For general issues regarding the services or their limitations, you may find the [Amazon Web Services Discussion Forums](https://forums.aws.amazon.com/) helpful.
## More Resources
[Changelog](https://github.com/aws/aws-cli/blob/develop/CHANGELOG.rst)
[AWS CLI Documentation](https://docs.aws.amazon.com/cli/index.html)
[AWS CLI User Guide](https://docs.aws.amazon.com/cli/latest/userguide/)
[AWS CLI Command Reference](https://docs.aws.amazon.com/cli/latest/reference/)
[Amazon Web Services Discussion Forums](https://forums.aws.amazon.com/)
[AWS Support](https://console.aws.amazon.com/support/home#/)
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file awscli-1.18.134.tar.gz.
File metadata
- Download URL: awscli-1.18.134.tar.gz
- Upload date:
- Size: 1.3 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.8.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.5.0 requests-toolbelt/0.9.1 clint/0.5.1 CPython/2.7.12 Linux/4.14.186-110.268.amzn1.x86_64
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 5341d6af27ebbcdfa7a20b0881c11e4eef27da7609ed5f164b5b80a2aa5d17c0 |
|
| MD5 | 7759111eb6673ce1a7bc0af67f44083d |
|
| BLAKE2b-256 | da9c243a26c833b86c9a4db70c5295e087404b908bd5d0c2c3857f943517c2c0 |
File details
Details for the file awscli-1.18.134-py2.py3-none-any.whl.
File metadata
- Download URL: awscli-1.18.134-py2.py3-none-any.whl
- Upload date:
- Size: 3.3 MB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.8.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.5.0 requests-toolbelt/0.9.1 clint/0.5.1 CPython/2.7.12 Linux/4.14.186-110.268.amzn1.x86_64
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 157824a8053e19c5c94b8598b3c952dcd9dfb3797e0425cd849b02632bd72184 |
|
| MD5 | 07ee660eef3f3ac3bb9aa3c5d8232609 |
|
| BLAKE2b-256 | d19e6db8f2d8a4fd59c9e92681867c102b0e38229cbbe573433a958aa4cbf328 |
](https://travis-ci.org/aws/aws-cli){kind=link}
](https://gitter.im/aws/aws-cli){kind=link}