aws-cli

=======
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.

The aws-cli package works on Python versions:

* 3.9.x
* 3.10.x
* 3.11.x
* 3.12.x
* 3.13.x
* 3.14.x

.. attention::
   We recommend that all customers regularly monitor the
   `Amazon Web Services Security Bulletins website`_ for any important security bulletins related to
   aws-cli.

 Jump to:

-  `Notices <#notices>`__
-  `Installation <#installation>`__
-  `CLI Releases <#cli-releases>`__
-  `Getting Started <#getting-started>`__
-  `Getting Help <#getting-help>`__
-  `More Resources <#more-resources>`__


-------
Notices
-------
On 2024-11-13, support for macOS version 10.15 was dropped.
To use up-to-date versions of AWS CLI v2, customers using macOS 10.15 or prior
should upgrade to macOS 11 or later. For more information, please see
this `blog post <https://aws.amazon.com/blogs/developer/macos-support-policy-updates-for-the-aws-cli-v2/>`__.


------------
Installation
------------

AWS CLI v2 can easily be installed on most standard platforms:

* `MacOS pkg installer <https://awscli.amazonaws.com/AWSCLIV2.pkg>`__

* `Linux x86-64 executable installer <https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip>`__

* `Linux arm64 (aarch64) executable installer <https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip>`__

* `Windows MSI installer <https://awscli.amazonaws.com/AWSCLIV2.msi>`__

You can find more detailed installation instructions `here <https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html>`__.

If you want to run the ``v2`` development branch of the CLI, see the
"CLI Dev Version" section below.


------------
CLI Releases
------------

The release notes for the AWS CLI can be found `here <https://github.com/aws/aws-cli/blob/v2/CHANGELOG.rst>`__.

Within AWS CLI v2, the middle number is the minor version and the last number
is the patch version:

* **Minor version releases** generally include substantial new CLI
  capabilities or changes in behavior. Examples of these are new global
  options that apply to all commands, a new credentials type, changes to
  "foundational" commands such as ``s3``, and adding or dropping support for
  a Python version. The minor version increases and the patch version resets
  to zero (for example,  ``2.39.6`` to ``2.40.0``).
* **Patch version releases** generally include incremental improvements to
  existing functionality, bug fixes, dependency updates, and updates to
  supported AWS service APIs. Examples of these include new service launches,
  new operations for existing services, and bugfixes or enhancements
  to a single command. The patch version increases (for example, ``2.39.6``
  to ``2.39.7``).

Minor releases can also include improvements, bug fixes, and service API
updates. Review the r