aws-cli ======= .. image:: https://github.com/aws/aws-cli/actions/workflows/run-tests.yml/badge.svg :target: https://github.com/aws/aws-cli/actions/workflows/run-tests.yml :alt: Build Status 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: - 3.7.x and greater - 3.8.x and greater - 3.9.x and greater - 3.10.x and greater - 3.11.x and greater Notices ~~~~~~~ On 2021-01-15, deprecation for Python 2.7 was announced and support was dropped on 2021-07-15. To avoid disruption, customers using the AWS CLI on Python 2.7 may need to upgrade their version of Python or pin the version of the AWS CLI. For more information, see this `blog post <https://aws.amazon.com/blogs/developer/announcing-end-of-support-for-python-2-7-in-aws-sdk-for-python-and-aws-cli-v1/>`__. On 2022-05-30, support for Python 3.6 was ended. This follows the Python Software Foundation `end of support <https://www.python.org/dev/peps/pep-0494/#lifespan>`__ for the runtime which occurred on 2021-12-23. For more information, see this `blog post <https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/>`__. *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.* Maintenance and Support for CLI Major Versions ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The AWS CLI version 1 was made generally available on 09/02/2013 and is currently in the full support phase of the availability life cycle. For information about maintenance and support for SDK major versions and their underlying dependencies, see the `Maintenance Policy <https://docs.aws.amazon.com/credref/latest/refdocs/maint-policy.html>`__ section in the *AWS SDKs and Tools Shared Configuration and Credentials Reference Guide*. Installation ~~~~~~~~~~~~ Installation of the AWS CLI and its dependencies use a range of packaging features provided by ``pip`` and ``setuptools``. To ensure smooth installation, it's recommended to use: - ``pip``: 9.0.2 or greater - ``setuptools``: 36.2.0 or greater 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#cli-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%\.aws\config`` 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 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#/>`__ .. |Build Status| image:: https://travis-ci.org/aws/aws-cli.svg?branch=develop :target: https://travis-ci.org/aws/aws-cli .. |Gitter| image:: https://badges.gitter.im/aws/aws-cli.svg :target: https://gitter.im/aws/aws-cli

Release History

Subscribe above to receive notifications when new versions are released.
Version Date Stability
1.27.99 Mar 24, 2023 stable
1.27.98 Mar 23, 2023 stable
1.27.97 Mar 22, 2023 stable
1.27.96 Mar 21, 2023 stable
1.27.95 Mar 20, 2023 stable
1.27.94 Mar 17, 2023 stable
1.27.93 Mar 16, 2023 stable
1.27.92 Mar 15, 2023 stable
1.27.91 Mar 14, 2023 stable
1.27.90 Mar 13, 2023 stable
1.27.89 Mar 10, 2023 stable
1.27.88 Mar 9, 2023 stable
1.27.87 Mar 8, 2023 stable
1.27.86 Mar 7, 2023 stable
1.27.85 Mar 6, 2023 stable
1.27.84 Mar 3, 2023 stable
1.27.83 Mar 2, 2023 stable
1.27.82 Mar 1, 2023 stable
1.27.81 Feb 28, 2023 stable
1.27.80 Feb 27, 2023 stable
1.27.79 Feb 24, 2023 stable
1.27.78 Feb 23, 2023 stable
1.27.77 Feb 22, 2023 stable
1.27.76 Feb 21, 2023 stable
1.27.75 Feb 20, 2023 stable
1.27.74 Feb 17, 2023 stable
1.27.73 Feb 16, 2023 stable
1.27.72 Feb 15, 2023 stable
1.27.71 Feb 14, 2023 stable
1.27.70 Feb 13, 2023 stable
1.27.69 Feb 10, 2023 stable
1.27.68 Feb 9, 2023 stable
1.27.67 Feb 8, 2023 stable
1.27.66 Feb 7, 2023 stable
1.27.65 Feb 6, 2023 stable
1.27.64 Feb 3, 2023 stable
1.27.63 Feb 2, 2023 stable
1.27.62 Feb 1, 2023 stable
1.27.61 Jan 31, 2023 stable
1.27.60 Jan 30, 2023 stable
1.27.59 Jan 27, 2023 stable
1.27.58 Jan 26, 2023 stable
1.27.57 Jan 25, 2023 stable
1.27.56 Jan 24, 2023 stable
1.27.55 Jan 23, 2023 stable
1.27.54 Jan 20, 2023 stable
1.27.53 Jan 19, 2023 stable
1.27.52 Jan 18, 2023 stable
1.27.51 Jan 17, 2023 stable
1.27.50 Jan 13, 2023 stable
1.27.49 Jan 12, 2023 stable
1.27.48 Jan 11, 2023 stable
1.27.47 Jan 10, 2023 stable
1.27.46 Jan 9, 2023 stable
1.27.45 Jan 6, 2023 stable
1.27.44 Jan 5, 2023 stable
1.27.43 Jan 4, 2023 stable
1.27.42 Jan 3, 2023 stable
1.27.41 Dec 30, 2022 stable
1.27.40 Dec 29, 2022 stable
1.27.39 Dec 28, 2022 stable
1.27.38 Dec 27, 2022 stable
1.27.37 Dec 23, 2022 stable
1.27.36 Dec 22, 2022 stable
1.27.35 Dec 21, 2022 stable
1.27.34 Dec 20, 2022 stable
1.27.33 Dec 19, 2022 stable
1.27.32 Dec 16, 2022 stable
1.27.31 Dec 15, 2022 stable
1.27.30 Dec 14, 2022 stable
1.27.29 Dec 13, 2022 stable
1.27.28 Dec 12, 2022 stable
1.27.27 Dec 9, 2022 stable
1.27.26 Dec 8, 2022 stable
1.27.25 Dec 7, 2022 stable
1.27.24 Dec 6, 2022 stable
1.27.23 Dec 5, 2022 stable
1.27.22 Dec 2, 2022 stable
1.27.21 Dec 1, 2022 stable
1.27.20 Nov 30, 2022 stable
1.27.19 Nov 29, 2022 stable
1.27.18 Nov 29, 2022 stable
1.27.17 Nov 28, 2022 stable
1.27.16 Nov 23, 2022 stable
1.27.15 Nov 22, 2022 stable
1.27.14 Nov 21, 2022 stable
1.27.13 Nov 18, 2022 stable
1.27.12 Nov 17, 2022 stable
1.27.11 Nov 16, 2022 stable
1.27.10 Nov 15, 2022 stable
1.27.9 Nov 14, 2022 stable
1.27.8 Nov 11, 2022 stable
1.27.7 Nov 10, 2022 stable
1.27.6 Nov 9, 2022 stable
1.27.5 Nov 8, 2022 stable
1.27.4 Nov 7, 2022 stable
1.27.3 Nov 4, 2022 stable
1.27.2 Nov 3, 2022 stable
1.27.1 Nov 2, 2022 stable
1.27.0 Nov 1, 2022 stable
1.26.5 Oct 31, 2022 stable
1.26.4 Oct 28, 2022 stable
1.26.3 Oct 27, 2022 stable
1.26.2 Oct 26, 2022 stable
1.26.1 Oct 25, 2022 stable
1.26.0 Oct 25, 2022 stable
1.25.97 Oct 21, 2022 stable
1.25.96 Oct 20, 2022 stable
1.25.95 Oct 19, 2022 stable
1.25.94 Oct 18, 2022 stable
1.25.93 Oct 17, 2022 stable
1.25.92 Oct 14, 2022 stable
1.25.91 Oct 13, 2022 stable
1.25.90 Oct 7, 2022 stable
1.25.89 Oct 6, 2022 stable
1.25.88 Oct 5, 2022 stable
1.25.87 Oct 4, 2022 stable
1.25.86 Oct 3, 2022 stable
1.25.85 Sep 30, 2022 stable
1.25.84 Sep 29, 2022 stable
1.25.83 Sep 27, 2022 stable
1.25.82 Sep 26, 2022 stable
1.25.81 Sep 23, 2022 stable
1.25.80 Sep 22, 2022 stable
1.25.79 Sep 21, 2022 stable
1.25.78 Sep 20, 2022 stable
1.25.77 Sep 19, 2022 stable
1.25.76 Sep 16, 2022 stable
1.25.75 Sep 15, 2022 stable
1.25.74 Sep 14, 2022 stable
1.25.73 Sep 13, 2022 stable
1.25.72 Sep 12, 2022 stable
1.25.71 Sep 9, 2022 stable
1.25.70 Sep 8, 2022 stable
1.25.69 Sep 7, 2022 stable
1.25.68 Sep 6, 2022 stable
1.25.67 Sep 2, 2022 stable
1.25.66 Sep 1, 2022 stable
1.25.65 Aug 31, 2022 stable
1.25.64 Aug 30, 2022 stable
1.25.63 Aug 29, 2022 stable
1.25.62 Aug 26, 2022 stable
1.25.61 Aug 25, 2022 stable
1.25.60 Aug 24, 2022 stable
1.25.59 Aug 23, 2022 stable
1.25.58 Aug 22, 2022 stable
1.25.57 Aug 19, 2022 stable
1.25.56 Aug 18, 2022 stable
1.25.55 Aug 17, 2022 stable
1.25.54 Aug 17, 2022 stable
1.25.53 Aug 16, 2022 stable
1.25.52 Aug 15, 2022 stable
1.25.51 Aug 12, 2022 stable
1.25.50 Aug 11, 2022 stable
1.25.49 Aug 10, 2022 stable
1.25.48 Aug 9, 2022 stable
1.25.47 Aug 8, 2022 stable
1.25.46 Aug 4, 2022 stable
1.25.45 Aug 3, 2022 stable
1.25.44 Aug 2, 2022 stable
1.25.43 Aug 1, 2022 stable
1.25.42 Jul 30, 2022 stable
1.25.41 Jul 29, 2022 stable
1.25.40 Jul 28, 2022 stable
1.25.39 Jul 27, 2022 stable
1.25.38 Jul 26, 2022 stable
1.25.37 Jul 25, 2022 stable
1.25.36 Jul 22, 2022 stable
1.25.35 Jul 21, 2022 stable
1.25.34 Jul 20, 2022 stable
1.25.33 Jul 19, 2022 stable
1.25.32 Jul 18, 2022 stable
1.25.31 Jul 15, 2022 stable
1.25.30 Jul 14, 2022 stable
1.25.29 Jul 13, 2022 stable
1.25.28 Jul 12, 2022 stable
1.25.27 Jul 11, 2022 stable
1.25.26 Jul 8, 2022 stable
1.25.25 Jul 7, 2022 stable
1.25.24 Jul 6, 2022 stable
1.25.23 Jul 5, 2022 stable
1.25.22 Jul 1, 2022 stable
1.25.21 Jun 30, 2022 stable
1.25.20 Jun 29, 2022 stable
1.25.19 Jun 28, 2022 stable
1.25.18 Jun 27, 2022 stable
1.25.17 Jun 24, 2022 stable
1.25.16 Jun 23, 2022 stable
1.25.15 Jun 22, 2022 stable
1.25.14 Jun 21, 2022 stable
1.25.13 Jun 20, 2022 stable
1.25.12 Jun 17, 2022 stable
1.25.11 Jun 16, 2022 stable
1.25.10 Jun 15, 2022 stable
1.25.9 Jun 14, 2022 stable
1.25.8 Jun 13, 2022 stable
1.25.7 Jun 10, 2022 stable
1.25.6 Jun 9, 2022 stable
1.25.5 Jun 8, 2022 stable
1.25.4 Jun 7, 2022 stable
1.25.3 Jun 6, 2022 stable
1.25.2 Jun 2, 2022 stable
1.25.1 Jun 1, 2022 stable
1.25.0 May 31, 2022 stable
1.24.10 May 27, 2022 stable
1.24.9 May 26, 2022 stable
1.24.8 May 25, 2022 stable
1.24.7 May 24, 2022 stable
1.24.6 May 23, 2022 stable
1.24.5 May 20, 2022 stable
1.24.4 May 19, 2022 stable
1.24.3 May 18, 2022 stable
1.24.2 May 17, 2022 stable
1.24.1 May 16, 2022 stable
1.24.0 May 13, 2022 stable
1.23.13 May 12, 2022 stable
1.23.12 May 11, 2022 stable
1.23.11 May 10, 2022 stable
1.23.10 May 9, 2022 stable
1.23.9 May 6, 2022 stable
1.23.8 May 5, 2022 stable
1.23.7 May 4, 2022 stable
1.23.6 May 3, 2022 stable
1.23.5 May 2, 2022 stable
1.23.4 Apr 29, 2022 stable
1.23.3 Apr 28, 2022 stable
1.23.2 Apr 27, 2022 stable
1.23.1 Apr 26, 2022 stable
1.23.0 Apr 25, 2022 stable
1.22.101 Apr 22, 2022 stable
1.22.100 Apr 21, 2022 stable
1.22.99 Apr 20, 2022 stable
1.22.98 Apr 19, 2022 stable
1.22.97 Apr 15, 2022 stable
1.22.96 Apr 14, 2022 stable
1.22.95 Apr 13, 2022 stable
1.22.94 Apr 12, 2022 stable
1.22.93 Apr 11, 2022 stable
1.22.92 Apr 8, 2022 stable
1.22.91 Apr 7, 2022 stable
1.22.90 Apr 6, 2022 stable
1.22.89 Apr 5, 2022 stable
1.22.88 Apr 4, 2022 stable
1.22.87 Apr 1, 2022 stable
1.22.86 Mar 31, 2022 stable
1.22.85 Mar 30, 2022 stable
1.22.84 Mar 29, 2022 stable
1.22.83 Mar 28, 2022 stable
1.22.82 Mar 25, 2022 stable
1.22.81 Mar 24, 2022 stable