**このドキュメントはバージョン 1 の AWS CLI のみを対象としています。**
AWS CLI バージョン 1 のサポート終了を発表しました。AWS CLI バージョン 2 に移行することをお勧めします。日付、その他の詳細、移行方法については、「[お知らせ](https://aws.amazon.com/blogs/developer/cli-v1-maintenance-mode-announcement/)」を参照してください。AWS CLI のバージョン 2 に関連するドキュメントについては、[バージョン 2 用ユーザーガイド](https://docs.aws.amazon.com/cli/latest/userguide/)を参照してください。
# AWS CLI のインストール、更新、アンインストール
このトピックでは、AWS Command Line Interface(AWS CLI) の元のバージョンのインストール、更新、アンインストール方法へのリンクを提供します。AWS CLI バージョン 1 は現在サポートされていますが、AWS CLI バージョン 2 で追加された新機能は、AWS CLI バージョン 1 には追加されない可能性があります。これらの機能を使用するには、AWS CLI バージョン 2 をインストールする必要があります。バージョン 2 のインストールの詳細については、「[AWS CLI バージョン 2 のインストール](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)」を参照してください。
**Topics**
+ [Python バージョンの要件](#cli-chap-install-python)
+ [Amazon Linux](install-linux-al2017.md)
+ [Linux](install-linux.md)
+ [macOS](install-macos.md)
+ [Server](install-windows.md)
+ [Virtualenv](install-virtualenv.md)
## Python バージョンの要件
AWS CLI バージョン 1 は Python SDK を使用して構築されるため、互換性のあるバージョンの Python をインストールする必要があります。
**Python バージョンのサポートマトリックス**
| AWS CLI バージョン | サポートされている Python のバージョン |
| --- | --- |
| 1.39.0～最新 | Python 3.9 以上 |
| 1.32.0～1.38.38 | Python 3.8 以上 |
| 1.27.0 – 1.31.x | Python 3.7 以上 |
| 1.20.0 – 1.26.x | Python 3.6 以上 |
| 1.19.0 – 1.19.x | Python 2.7 以上、Python 3.6 以上 |
| 1.17 — 1.18.x | Python 2.7 以上、Python 3.4 以上 |
| 1.0 — 1.16.x | Python 2.6 以上、Python 3.3 以上 |
AWS CLI の最新リリースについては、GitHub の「[AWS CLI version 2 Changelog](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)」を参照してください。
# Amazon Linux での AWS CLI バージョン 1 のインストール、更新、アンインストール
AWS CLI バージョン 1 は、Amazon Linux および Amazon Linux 2 に事前にインストールされています。以下のコマンドを使用して、現在インストールされているバージョンを確認します。
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
Amazon Linux インスタンスを作成した時期に応じて、AWS CLIバージョン 1 は、次のパッケージマネージャーのいずれかを使用してプリインストールされています。
+ [pip](#install-amazon-linux-pip)
+ [yum](#install-amazon-linux-yum)
## 前提条件
Python 3.8 以降をインストールする必要があります。インストール手順については、Python の *Beginner Guide* で「[Downloading Python](https://wiki.python.org/moin/BeginnersGuide/Download)」ページを参照してください。
**Python バージョンのサポートマトリックス**
| AWS CLI バージョン | サポートされている Python のバージョン |
| --- | --- |
| 1.39.0～最新 | Python 3.9 以上 |
| 1.32.0～1.38.38 | Python 3.8 以上 |
| 1.27.0 – 1.31.x | Python 3.7 以上 |
| 1.20.0 – 1.26.x | Python 3.6 以上 |
| 1.19.0 – 1.19.x | Python 2.7 以上、Python 3.6 以上 |
| 1.17 — 1.18.x | Python 2.7 以上、Python 3.4 以上 |
| 1.0 — 1.16.x | Python 2.6 以上、Python 3.3 以上 |
## pip を使用したインストール、更新、アンインストール
ほとんどの Amazon Linux インスタンスでは、pip を使用して AWS CLI バージョン 1 をプリインストールしています。
### pip を使用した Amazon Linux での AWS CLI バージョン 1 のインストールまたは更新
現在のユーザーのために AWS CLI バージョン 1 の最新バージョンをインストールするには、以下の手順を実行します。
1. Python version 3 以降がインストールされている場合は、`pip3` の使用が推奨されます。`pip3 install` を使用して、AWS CLI バージョン 1 の最新バージョンをインストール、または最新バージョンに更新します。[Python 仮想環境 (venv)](https://docs.python.org/3/library/venv.html) 内からコマンドを実行する場合は、`--user` オプションを使用する必要はありません。
```
$ pip3 install --upgrade --user awscli
```
1. `aws` を含むフォルダが `PATH` 変数の一部であることを確認します。
1. ユーザーディレクトリでシェルのプロファイルスクリプトを見つけます。現在使用しているシェルが不明な場合は、`echo $SHELL` を実行します。
```
$ ls -a ~
. .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
```
+ **Bash** - `.bash_profile`、`.profile`、または `.bash_login`
+ **Zsh** - `.zshrc`
+ **Tcsh** - `.tcshrc`、`.cshrc`、または `.login`
1. 次の例のように、プロファイルスクリプトの末尾にエクスポートコマンドを追加します。
```
export PATH=$HOME/.local/bin:$PATH
```
このコマンドでは、パス (この例では `$HOME/.local/bin`) が、既存の `$PATH` 変数の前に挿入されます。
1. 変更が有効になるように、プロファイルを現在のセッションに再ロードします。
```
$ source ~/.bash_profile
```
1. 新しいバージョンを実行していることを確認するには、`aws --version` コマンドを使用します。
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
### pip を使用した AWS CLI バージョン 1 のアンインストール
AWS CLI をアンインストールする必要がある場合は、`pip uninstall` を使用します。
```
$ pip3 uninstall awscli
```
## yum を使用したインストール、更新、アンインストール
ほとんどの Amazon Linux 2 インスタンスでは、yum を使用して AWS CLI バージョン 1 をプリインストールしています。
### yum を使用した Amazon Linux での AWS CLI バージョン 1 のインストールまたは更新
次のコマンドを実行して、Amazon Linux で提供されている AWS CLI バージョン 1 の最新バージョンをインストールします。
```
$ sudo yum install awscli
```
次のコマンドを実行して、Amazon Linux で提供されている AWS CLI バージョン 1 を最新バージョンに更新します。
```
$ sudo yum update awscli
```
新しいバージョンを実行していることを確認するには、`aws --version` コマンドを使用します。
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
### yum を使用した AWS CLI バージョン 1 のアンインストール
AWS CLI をアンインストールするには、`yum remove` を使用します。
```
$ sudo yum remove awscli
```
## AWS CLI のインストールエラーとアンインストールエラーのトラブルシューティング
AWS CLI をインストールまたはアンインストールした後に問題が発生した場合のトラブルシューティングステップについては、「[AWS CLI のエラーのトラブルシューティング](cli-chap-troubleshooting.md)」を参照してください。最も関連性の高いトラブルシューティングステップについては、「[コマンドが見つからないエラー](cli-chap-troubleshooting.md#tshoot-install-not-found)」、「[「`aws --version`」コマンドが、インストールしたのとは異なるバージョンを返す](cli-chap-troubleshooting.md#tshoot-install-wrong-version)」、および「[AWS CLI のアンインストール後に、「`aws --version`」コマンドがバージョンを返す](cli-chap-troubleshooting.md#tshoot-uninstall-1)」を参照してください。
# Linux での AWS CLI バージョン 1 のインストール、更新、アンインストール
AWS Command Line Interface パッケージマネージャーまたはバンドルされたインストーラを使用して、AWS CLI (`pip`) バージョン 1 とその依存関係をほとんどの Linux ディストリビューションにインストールできます。
`awscli` パッケージは、`apt` や `yum` などの他のパッケージマネージャーのリポジトリで利用できますが、これらのパッケージは AWS によって生成、管理、サポートされません。このガイドに記載されている公式の AWS CLI ディストリビューションポイントからのみ AWS をインストールすることを推奨します。
**Topics**
+ [前提条件](#install-linux-prereqs)
+ [バンドルされたインストーラを使用した Linux での AWS CLI バージョン 1 のインストールおよびアンインストール](#install-linux-bundled)
+ [pip を使用した AWS CLI バージョン 1 のインストールとアンインストール](#install-linux-pip)
+ [Snapcraft を使用した AWS CLI バージョン 1 のインストールとアンインストール](#install-linux-snap)
+ [コマンドラインパスへの AWS CLI バージョン 1 の実行可能ファイルの追加](#install-linux-path)
+ [AWS CLI のインストールエラーとアンインストールエラーのトラブルシューティング](#install-linux-tshoot)
## 前提条件
Python 3.8 以降をインストールする必要があります。インストール手順については、Python の *Beginner Guide* で「[Downloading Python](https://wiki.python.org/moin/BeginnersGuide/Download)」ページを参照してください。
**Python バージョンのサポートマトリックス**
| AWS CLI バージョン | サポートされている Python のバージョン |
| --- | --- |
| 1.39.0～最新 | Python 3.9 以上 |
| 1.32.0～1.38.38 | Python 3.8 以上 |
| 1.27.0 – 1.31.x | Python 3.7 以上 |
| 1.20.0 – 1.26.x | Python 3.6 以上 |
| 1.19.0 – 1.19.x | Python 2.7 以上、Python 3.6 以上 |
| 1.17 — 1.18.x | Python 2.7 以上、Python 3.4 以上 |
| 1.0 — 1.16.x | Python 2.6 以上、Python 3.3 以上 |
## バンドルされたインストーラを使用した Linux での AWS CLI バージョン 1 のインストールおよびアンインストール
Linux または macOS では、バンドルされたインストーラを使用して AWS CLI のバージョン 1 をインストールできます。バンドルされたインストーラにはすべての依存関係が含まれており、オフラインで使用できます。
**注記**
バンドルされたインストーラでは、スペースを含むパスへのインストールはサポートされていません。
**Topics**
+ [`sudo` を使用したバンドルされたインストーラでの AWS CLI バージョン 1 のインストール](#install-linux-bundled-sudo)
+ [`sudo` を使用しないバンドルされたインストーラでの AWS CLI バージョン 1 のインストール](#install-linux-bundled-no-sudo)
+ [AWS CLI バージョン 1 のバンドルされたインストーラのアンインストール](#install-linux-bundled-uninstall)
### `sudo` を使用したバンドルされたインストーラでの AWS CLI バージョン 1 のインストール
次の手順では、Linux または macOS の任意のビルドで、コマンドラインから AWS CLI バージョン 1 をインストールできます。
ここでは、以下に説明するインストールコマンドの概要を示しています。これらは単一のコマンドセットとしてカットアンドペーストして実行できます。
**AWS CLI の最新バージョンの場合は**、次のコマンドブロックを使用します。
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```
**AWS CLI の特定バージョンの場合は**、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン *1.16.312* のファイル名が `awscli-bundle-1.16.312.zip` になるため、コマンドは以下のようになります。
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```
コマンドラインから以下の手順を実行して、バンドルされたインストーラを使用して AWS CLI バージョン 1 をインストールします。
**バンドルされたインストーラを使用して AWS CLI バージョン 1 をインストールする**
1. 次の方法の 1 つを使用して、AWS CLI バージョン 1 のバンドルされたインストーラをダウンロードします。
+ `curl` コマンドを使用してダウンロードします。
**AWS CLI の最新バージョンの場合は**、次のコマンドブロックを使用します。
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
```
**AWS CLI の特定バージョンの場合は**、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン *1.16.312* のファイル名が `awscli-bundle-1.16.312.zip` になるため、コマンドは以下のようになります。
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
```
+ 直接リンクを使用してダウンロードします。
**最新バージョンの AWS CLI:** [https://s3.amazonaws.com/aws-cli/awscli-bundle.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle.zip)
**AWS CLI の特定バージョンの場合は**、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン *1.16.312* のファイル名が `awscli-bundle-1.16.312.zip` になるため、URL が [https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip) になります
1. パッケージからファイルを抽出します。ファイルを抽出する `unzip` がない場合は、Linux ディストリビューションに組み込まれたパッケージマネージャーを使用してインストールします。
```
$ unzip awscli-bundle.zip
```
1. インストールプログラムを実行します。インストーラは AWS CLI を `/usr/local/aws` にインストールし、シンボリックリンク `aws` を `/usr/local/bin` ディレクトリに作成します。`-b` オプションを使用してシンボリックリンクを作成すると、ユーザーの `$PATH` 変数にインストールディレクトリを指定する必要がなくなります。これにより、すべてのユーザーが任意のディレクトリから AWS CLI を入力して `aws` を呼び出せるようになります。
```
$ sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```
デフォルトでは、インストールスクリプトはシステムのデフォルトバージョンの Python で実行されます。別のバージョンの Python がインストールされており、そのバージョンを使用して AWS CLI をインストールする場合は、次のように Python の実行可能ファイルへの絶対パスを指定してそのバージョンでインストールスクリプトを実行します。
```
$ sudo /usr/local/bin/python3.7 awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```
1. AWS CLI が正しくインストールされたことを確認します。
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
エラーが表示される場合は、「[AWS CLI のエラーのトラブルシューティング](cli-chap-troubleshooting.md)」を参照してください。
### `sudo` を使用しないバンドルされたインストーラでの AWS CLI バージョン 1 のインストール
`sudo` を使用するアクセス許可がない場合、または現在のユーザー向けに AWS CLI のみをインストールする場合は、前述のコマンドの修正バージョンを使用できます。最初の 2 つのコマンドは同じです。
**AWS CLI の最新バージョンの場合は**、次のコマンドブロックを使用します。
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
./awscli-bundle/install -b ~/bin/aws
```
**AWS CLI の特定バージョンの場合は**、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン *1.16.312* のファイル名が `awscli-bundle-1.16.312.zip` になるため、コマンドは以下のようになります。
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
./awscli-bundle/install -b ~/bin/aws
```
**現在のユーザーのために AWS CLI バージョン 1 をインストールする**
1. 次のいずれかの方法で、AWS CLI バージョン 1 のバンドルされたインストーラをダウンロードします。
+ `curl` コマンドを使用してダウンロードします。
**AWS CLI の最新バージョンの場合は**、次のコマンドブロックを使用します。
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
```
**AWS CLI の特定バージョンの場合は**、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン *1.16.312* のファイル名が `awscli-bundle-1.16.312.zip` になるため、コマンドは以下のようになります。
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
```
+ 直接リンクを使用してダウンロードします。
**最新バージョンの AWS CLI:** [https://s3.amazonaws.com/aws-cli/awscli-bundle.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle.zip)
**AWS CLI の特定バージョンの場合は**、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン *1.16.312* のファイル名が `awscli-bundle-1.16.312.zip` になるため、URL が [https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip) になります
1. `unzip` を使用してパッケージからファイルを抽出します。`unzip` がない場合は、Linux ディストリビューションに組み込まれたパッケージマネージャーを使用してインストールします。
```
$ unzip awscli-bundle.zip
```
1. インストールプログラムを実行します。インストーラは AWS CLI を `/usr/local/aws` にインストールし、シンボリックリンク `aws` を `/usr/local/bin` ディレクトリに作成します。このコマンドは `-b` パラメータを使用して、インストーラが `aws` シンボリックリンクファイルを配置するディレクトリを指定します。指定したフォルダへの書き込み権限が必要です。
```
$ ./awscli-bundle/install -b ~/bin/aws
```
これにより、AWS CLI がデフォルトの場所 (`~/.local/lib/aws`) にインストールされ、シンボリックリンクが `~/bin/aws` に作成されます。シンボリックリンクが動作するように、`~/bin` が `PATH` 環境変数にあることを確認してください。
```
$ echo $PATH | grep ~/bin // See if $PATH contains ~/bin (output will be empty if it doesn't)
$ export PATH=~/bin:$PATH // Add ~/bin to $PATH if necessary
```
1. AWS CLI バージョン 1 が `PATH` 変数の一部であるディレクトリを確認します。
1. ユーザーフォルダーでシェルのプロファイルスクリプトを見つけます。現在使用しているシェルが不明な場合は、`echo $SHELL` を実行します。
```
$ ls -a ~
. .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
```
+ **Bash** - `.bash_profile`、`.profile`、または `.bash_login`
+ **Zsh** - `.zshrc`
+ **Tcsh** - `.tcshrc`、`.cshrc`、または `.login`
1. 次の例のように、プロファイルスクリプトの末尾にエクスポートコマンドを追加します。
```
export PATH=~/.local/bin:$PATH
```
このコマンドでは、パス (この例では `~/.local/bin`) が、既存の `PATH` 変数の前に挿入されます。
1. 変更が有効になるように、プロファイルを現在のセッションに再ロードします。
```
$ source ~/.bash_profile
```
1. AWS CLI が正しくインストールされたことを確認します。
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
エラーが表示される場合は、「[AWS CLI のエラーのトラブルシューティング](cli-chap-troubleshooting.md)」を参照してください。
### AWS CLI バージョン 1 のバンドルされたインストーラのアンインストール
1. バンドルされたインストーラを使用して AWS CLI をインストールした場合は、次の手順に従ってください。バンドルされたインストーラでは、オプションのシンボリックリンク以外は、インストールディレクトリの外に何も置きません。そのため、アンインストールはこの 2 つの項目を削除するだけでシンプルです。
```
$ sudo rm -rf /usr/local/aws
$ sudo rm -rf /usr/local/bin/aws
```
1. **(オプション)** `.aws` フォルダ内の共有 AWS SDK と AWS CLI 設定情報を削除します。
**警告**
これらの設定と認証情報の設定は、すべての AWS SDK と AWS CLI で共有されます。このフォルダを削除すると、システムに残っている AWS SDK からはアクセスできなくなります。
`.aws` フォルダのデフォルトの場所はプラットフォームによって異なります。デフォルトでは、フォルダは *\$1/.aws/* にあります。このディレクトリへの書き込みアクセス許可がユーザーにある場合は、`sudo` を使用する必要はありません。
```
$ sudo rm -r ~/.aws/
```
## pip を使用した AWS CLI バージョン 1 のインストールとアンインストール
**Topics**
+ [pip をインストールします。](#install-linux-pip-pip)
+ [pip を使用した AWS CLI バージョン 1 のインストールと更新](#install-linux-awscli)
+ [pip を使用して AWS CLI をアンインストールする](#post-install-uninstall)
### pip をインストールします。
`pip` がインストールされていない場合は、*Python Packaging Authority* が提供するスクリプトを使用してインストールできます。`pip --version` を実行して、Linux のバージョンにすでに Python と `pip` が含まれているかどうか確認します。Python version 3 以降がインストールされている場合は、`pip3` コマンドの使用が推奨されます。
1. `curl` コマンドを使用してインストールスクリプトをダウンロードします。以下のコマンドでは、`-O` (大文字の O) パラメータを使用して、ダウンロードしたファイルが、リモートホストでの同じ名前で、現在のディレクトリに保存されるように指定します。
```
$ curl -O https://bootstrap.pypa.io/get-pip.py
```
1. `python` または `python3` コマンドでスクリプトを実行して、`pip` の最新バージョンとその他の必要なサポートパッケージをダウンロードしてインストールします。`--user` スイッチを含めると、スクリプトは `pip` をパス `~/.local/bin` にインストールします。
```
$ python3 get-pip.py --user
```
1. `pip` を含むディレクトリが `PATH` 変数の一部であることを確認します。
1. ユーザーフォルダーでシェルのプロファイルスクリプトを見つけます。現在使用しているシェルが不明な場合は、`echo $SHELL` を実行します。
```
$ ls -a ~
. .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
```
+ **Bash** - `.bash_profile`、`.profile`、または `.bash_login`
+ **Zsh** - `.zshrc`
+ **Tcsh** - `.tcshrc`、`.cshrc`、または `.login`
1. 次の例のように、プロファイルスクリプトの末尾にエクスポートコマンドを追加します。
```
export PATH=~/.local/bin:$PATH
```
このコマンドでは、パス (この例では `~/.local/bin`) が、既存の `PATH` 変数の前に挿入されます。
1. 変更が有効になるように、プロファイルを現在のセッションに再ロードします。
```
$ source ~/.bash_profile
```
1. `pip` または `pip3` が正しくインストールされていることを確認するには、次のコマンドを実行します。
```
$ pip3 --version
pip 24.0 from ~/.local/lib/python3.7/site-packages (python 3.7)
```
### pip を使用した AWS CLI バージョン 1 のインストールと更新
1. `pip` または `pip3` コマンドを使用して、AWS CLI をインストールまたは更新します。Python バージョン 3 以降を使用する場合、`pip3` コマンドの使用が推奨されます。`--user` スイッチ `pip` は、AWS CLI を `~/.local/bin` にインストールします。
**AWS CLI の最新バージョンの場合は**、次のコマンドブロックを使用します。
```
$ pip3 install awscli --upgrade --user
```
**AWS CLI の特定バージョンの場合は**、ファイル名に 2 つの等号 「`=`」とバージョン番号を追加します。この例では、バージョン *1.16.312* のファイル名が *==1.16.312* になるため、コマンドは以下のようになります。
```
$ pip3 install awscli==1.16.312 --upgrade --user
```
**注記**
端末に適切な引用符ルールを使用してください。`=` 文字を使用するためには、一重引用符または二重引用符を使用して、適切にエスケープする必要があります。次の例では、一重引用符を使用してエスケープしています。
```
$ pip3 install 'awscli==1.16.312' --upgrade --user
```
1. AWS CLI が正しくインストールされたことを確認します。
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
エラーが表示される場合は、「[AWS CLI のエラーのトラブルシューティング](cli-chap-troubleshooting.md)」を参照してください。
### pip を使用して AWS CLI をアンインストールする
1. `pip` を使用して AWS CLI バージョン 1 をインストールした場合は、`pip` を使用してアンインストールする必要もあります。
```
$ pip uninstall awscli
```
Python 2 または 3 バージョンを使用している場合は、`pip2` または `pip3` コマンドを使用する必要がある場合があります。`aws --version` コマンドを使用して、インストールした AWS CLI バージョン 1 に関連付けられている Python バージョンを確認します。
```
$ pip3 uninstall awscli
```
すべてのファイルを削除するには、コマンドプロンプトウィンドウまたはコンピュータの再起動が必要になる場合があります。
1. **(オプション)** `.aws` フォルダ内の共有 AWS SDK と AWS CLI 設定情報を削除します。
**警告**
これらの設定と認証情報の設定は、すべての AWS SDK と AWS CLI で共有されます。このフォルダを削除すると、システムに残っている AWS SDK からはアクセスできなくなります。
`.aws` フォルダのデフォルトの場所はプラットフォームによって異なります。デフォルトでは、フォルダは *\$1/.aws/* にあります。このディレクトリへの書き込みアクセス許可がユーザーにある場合は、`sudo` を使用する必要はありません。
```
$ sudo rm -r ~/.aws/
```
## Snapcraft を使用した AWS CLI バージョン 1 のインストールとアンインストール
**Topics**
+ [スナップのインストール](#install-linux-snap-install)
+ [スナップを使用した AWS CLI バージョン 1 のインストールと更新](#install-linux-snap-update)
+ [スナップを使用して AWS CLI をアンインストールする](#install-linux-snap-uninstall)
### スナップのインストール
まだ `snap` をインストールしていない場合は、*Canonical Snapcraft* が提供する手順を使用してインストールできます。`snap version` を実行して、Linux のバージョンにすでに `snap` が含まれているかどうか確認します。
1. プラットフォームに Snapcraft をインストールします。Snapcraft のインストールの詳細については、「*Snap ドキュメント*」の「[デーモンのインストール](https://snapcraft.io/docs/installing-snapd)」を参照してください。
1. `PATH` 変数が正しく更新されるように、システムを再起動します。インストールに問題がある場合は、「*Snap ドキュメント*」の「[一般的な問題を修正する](https://snapcraft.io/docs/fix-common-issues)」のステップに従います。
1. `snap` が正しくインストールされていることを確認するには、次のコマンドを実行します。
```
$ snap version
```
### スナップを使用した AWS CLI バージョン 1 のインストールと更新
1. AWS CLI バージョン 1 に次の `snap install` コマンドを実行します。
```
$ snap install aws-cli --channel=v1/stable --classic
```
アクセス許可によっては、 コマンドに `sudo` を追加しないといけない場合があります。
```
$ sudo snap install aws-cli --channel=v1/stable --classic
```
1. AWS CLI が正しくインストールされたことを確認します。
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
エラーが表示される場合は、「[AWS CLI のエラーのトラブルシューティング](cli-chap-troubleshooting.md)」を参照してください。
### スナップを使用して AWS CLI をアンインストールする
1. `snap` を使用して AWS CLI バージョン 1 をインストールした場合は、`snap` を使用してアンインストールする必要もあります。
```
$ snap remove aws-cli
```
すべてのファイルを削除するには、コマンドプロンプトウィンドウまたはコンピュータの再起動が必要になる場合があります。
1. **(オプション)** `.aws` フォルダ内の共有 AWS SDK と AWS CLI 設定情報を削除します。
**警告**
これらの設定と認証情報の設定は、すべての AWS SDK と AWS CLI で共有されます。このフォルダを削除すると、システムに残っている AWS SDK からはアクセスできなくなります。
`.aws` フォルダのデフォルトの場所はプラットフォームによって異なります。デフォルトでは、フォルダは *\$1/.aws/* にあります。このディレクトリへの書き込みアクセス許可がある場合は、`sudo` を使用する必要はありません。
```
$ sudo rm -r ~/.aws/
```
## コマンドラインパスへの AWS CLI バージョン 1 の実行可能ファイルの追加
`pip` または `snap` を使用してインストールした後、オペレーティングシステムの `PATH` 環境変数への `aws` 実行ファイルの追加が必要になる場合があります。
`pip` によって AWS CLI をインストールしたフォルダを確認するには、次のコマンドを実行します。
```
$ which aws
/home/username/.local/bin/aws
```
`~/.local/bin/` は Linux では `/home/username` に対応するため、これを `~` として参照できます。
`--user` スイッチを省いて、ユーザーモードでインストールしなかった場合、実行可能ファイルは Python のインストール先の `bin` フォルダにあります。Python がインストールされた場所が不明な場合は、次のコマンドを実行します。
```
$ which python
/usr/local/bin/python
```
出力は、実際の実行可能ファイルではなく symlink へのパスになる場合があります。`ls -al` を実行して、その参照先を確認します。
```
$ ls -al /usr/local/bin/python
/usr/local/bin/python -> ~/.local/Python/3.6/bin/python3.6
```
`pip` は、Python プログラムが含まれている同じフォルダに、アプリケーションをインストールします。このフォルダを `PATH` 変数に追加します。
**`PATH` 変数を変更するには**
1. ユーザーディレクトリでシェルのプロファイルスクリプトを見つけます。現在使用しているシェルが不明な場合は、`echo $SHELL` を実行します。
```
$ ls -a ~
. .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
```
+ **Bash** - `.bash_profile`、`.profile`、または `.bash_login`
+ **Zsh** – `.zshrc`
+ **Tcsh** - `.tcshrc`、`.cshrc`、または `.login`
1. プロファイルスクリプトにエクスポートコマンドを追加します。
```
export PATH=~/.local/bin:$PATH
```
このコマンドは、現在の `~/.local/bin` 変数にパス (この例では `PATH`) を追加します。
1. 現在のセッションに更新されたプロファイルをロードします。
```
$ source ~/.bash_profile
```
## AWS CLI のインストールエラーとアンインストールエラーのトラブルシューティング
AWS CLI をインストールまたはアンインストールした後に問題が発生した場合のトラブルシューティングステップについては、「[AWS CLI のエラーのトラブルシューティング](cli-chap-troubleshooting.md)」を参照してください。最も関連性の高いトラブルシューティングステップについては、「[コマンドが見つからないエラー](cli-chap-troubleshooting.md#tshoot-install-not-found)」、「[「`aws --version`」コマンドが、インストールしたのとは異なるバージョンを返す](cli-chap-troubleshooting.md#tshoot-install-wrong-version)」、および「[AWS CLI のアンインストール後に、「`aws --version`」コマンドがバージョンを返す](cli-chap-troubleshooting.md#tshoot-uninstall-1)」を参照してください。
# macOS での AWS CLI バージョン 1 のインストール、更新、アンインストール
AWS Command Line Interface (AWS CLI) バージョン 1 とその依存関係を macOS にインストールするには、バンドルされたインストーラまたは `pip` を使用します。
**Topics**
+ [前提条件](#install-macosos-prereq)
+ [バンドルされたインストーラを使用した macOS での AWS CLI バージョン 1 のインストール、更新、アンインストール](#install-macosos-bundled)
+ [pip を使用した AWS CLI バージョン 1 のインストール、更新、アンインストール](#awscli-install-osx-pip)
+ [AWS CLI のインストールエラーとアンインストールエラーのトラブルシューティング](#awscli-install-osx-tshoot)
## 前提条件
macOS に AWS CLI バージョン 1 をインストールする前に、Python 3.8 以降がインストールされていることを確認してください。インストール手順については、Python の *Beginner Guide* で「[Downloading Python](https://wiki.python.org/moin/BeginnersGuide/Download)」ページを参照してください。
**Python バージョンのサポートマトリックス**
| AWS CLI バージョン | サポートされている Python のバージョン |
| --- | --- |
| 1.39.0～最新 | Python 3.9 以上 |
| 1.32.0～1.38.38 | Python 3.8 以上 |
| 1.27.0 – 1.31.x | Python 3.7 以上 |
| 1.20.0 – 1.26.x | Python 3.6 以上 |
| 1.19.0 – 1.19.x | Python 2.7 以上、Python 3.6 以上 |
| 1.17 — 1.18.x | Python 2.7 以上、Python 3.4 以上 |
| 1.0 — 1.16.x | Python 2.6 以上、Python 3.3 以上 |
## バンドルされたインストーラを使用した macOS での AWS CLI バージョン 1 のインストール、更新、アンインストール
Linux または macOS では、バンドルされたインストーラを使用して AWS Command Line Interface (AWS CLI) のバージョン 1 をインストールできます。バンドルされたインストーラにはすべての依存関係が含まれており、オフラインで使用できます。
バンドルされたインストーラでは、スペースを含むパスへのインストールはサポートされていません。
**Topics**
+ [`sudo` を使用したバンドルされたインストーラでの AWS CLI バージョン 1 のインストール](#install-macosos-bundled-sudo)
+ [`sudo` を使用しないバンドルされたインストーラでの AWS CLI バージョン 1 のインストール](#install-macosos-bundled-no-sudo)
+ [AWS CLI バージョン 1 のバンドルされたインストーラのアンインストール](#install-macosos-bundled-uninstall)
### `sudo` を使用したバンドルされたインストーラでの AWS CLI バージョン 1 のインストール
次の手順では、macOS の任意のビルドに、コマンドラインから AWS CLI バージョン 1 をインストールできます。
以下は、単一のコマンドセットとしてカットアンドペーストして実行できるコマンドのインストールの概要を示しています。
**AWS CLI の最新バージョンの場合は**、次のコマンドブロックを使用します。
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```
**AWS CLI の特定バージョンの場合は**、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン *1.16.312* のファイル名が `awscli-bundle-1.16.312.zip` になるため、コマンドは以下のようになります。
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```
**バンドルされたインストーラを使用して AWS CLI バージョン 1 をインストールする**
1. 次のいずれかの方法で、AWS CLI バージョン 1 のバンドルされたインストーラをダウンロードします。
+ `curl` コマンドを使用してダウンロードします。
**AWS CLI の最新バージョンの場合は**、次のコマンドブロックを使用します。
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
```
**AWS CLI の特定バージョンの場合は**、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン *1.16.312* のファイル名が `awscli-bundle-1.16.312.zip` になるため、コマンドは以下のようになります。
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
```
+ 直接リンクを使用してダウンロードします。
**最新バージョンの AWS CLI:** [https://s3.amazonaws.com/aws-cli/awscli-bundle.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle.zip)
**AWS CLI の特定バージョンの場合は**、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン *1.16.312* のファイル名が `awscli-bundle-1.16.312.zip` になるため、URL が [https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip) になります
1. パッケージからファイルを抽出 (解凍) します。`unzip` がない場合は、macOS ディストリビューションに組み込まれたパッケージマネージャーを使用してインストールします。
```
$ unzip awscli-bundle.zip
```
1. インストールプログラムを実行します。インストーラは AWS CLI を `/usr/local/aws` にインストールし、シンボリックリンク `aws` を `/usr/local/bin` フォルダに作成します。`-b` オプションを使用してシンボリックリンクを作成すると、ユーザーの `$PATH` 変数にインストールフォルダを指定する必要がなくなります。これにより、すべてのユーザーが任意のディレクトリから AWS CLI を入力して `aws` を呼び出せるようになります。
```
$ sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```
デフォルトでは、インストールスクリプトはシステムのデフォルトバージョンの Python で実行されます。別のバージョンの Python がインストールされており、それを使用して AWS CLI をインストールする場合は、次のように Python の実行可能ファイルへの絶対パスを指定してそのバージョンでインストールスクリプトを実行します。
```
$ sudo /usr/local/bin/python3.7 awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```
1. AWS CLI が正しくインストールされたことを確認します。
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
エラーが表示される場合は、「[AWS CLI のエラーのトラブルシューティング](cli-chap-troubleshooting.md)」を参照してください。
### `sudo` を使用しないバンドルされたインストーラでの AWS CLI バージョン 1 のインストール
`sudo` を使用するアクセス許可がない場合、または現在のユーザー向けに AWS CLI のみをインストールする場合は、前述のコマンドの修正バージョンを使用できます。最初の 2 つのコマンドは同じです。
**AWS CLI の最新バージョンの場合は**、次のコマンドブロックを使用します。
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
./awscli-bundle/install -b ~/bin/aws
```
**AWS CLI の特定バージョンの場合は**、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン *1.16.312* のファイル名が `awscli-bundle-1.16.312.zip` になるため、コマンドは以下のようになります。
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
./awscli-bundle/install -b ~/bin/aws
```
**現在のユーザーのために AWS CLI バージョン 1 をインストールする**
1. 次の方法の 1 つを使用して、AWS CLI バージョン 1 のバンドルされたインストーラをダウンロードします。
+ `curl` コマンドを使用してダウンロードします。
**AWS CLI の最新バージョンの場合は**、次のコマンドブロックを使用します。
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
```
**AWS CLI の特定バージョンの場合は**、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン *1.16.312* のファイル名が `awscli-bundle-1.16.312.zip` になるため、コマンドは以下のようになります。
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
```
+ 直接リンクを使用してダウンロードします。
**最新バージョンの AWS CLI:** [https://s3.amazonaws.com/aws-cli/awscli-bundle.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle.zip)
**AWS CLI の特定バージョンの場合は**、ファイル名にハイフンとバージョン番号を追加します。この例では、バージョン *1.16.312* のファイル名が `awscli-bundle-1.16.312.zip` になるため、URL が [https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip) になります
1. パッケージからファイルを抽出します。`unzip` がない場合は、Linux ディストリビューションに組み込まれたパッケージマネージャーを使用してインストールします。
```
$ unzip awscli-bundle.zip
```
1. インストールプログラムを実行します。インストーラは AWS CLI を `/usr/local/aws` にインストールし、シンボリックリンク `aws` を `/usr/local/bin` ディレクトリに作成します。このコマンドは `-b` パラメータを使用して、インストーラが `aws` シンボリックリンクファイルを配置するディレクトリを指定します。指定したディレクトリへの書き込み権限が必要です。
```
$ ./awscli-bundle/install -b ~/bin/aws
```
これにより、AWS CLI がデフォルトの場所 (`~/.local/lib/aws`) にインストールされ、シンボリックリンクが `~/bin/aws` に作成されます。シンボリックリンクが動作するように、`~/bin` が `$PATH` 環境変数にあることを確認してください。
```
$ echo $PATH | grep ~/bin // See if $PATH contains ~/bin (output will be empty if it doesn't)
$ export PATH=~/bin:$PATH // Add ~/bin to $PATH if necessary
```
1. AWS CLI バージョン 1 がインストールされているフォルダが `$PATH` 変数の一部であることを確認します。
1. ユーザーフォルダーでシェルのプロファイルスクリプトを見つけます。現在使用しているシェルが不明な場合は、`echo $SHELL` を実行します。
```
$ ls -a ~
. .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
```
+ **Bash** - `.bash_profile`、`.profile`、または `.bash_login`
+ **Zsh** - `.zshrc`
+ **Tcsh** - `.tcshrc`、`.cshrc`、または `.login`
1. 次の例のように、プロファイルスクリプトの末尾にエクスポートコマンドを追加します。
```
export PATH=~/.local/bin:$PATH
```
このコマンドでは、パス (この例では `~/.local/bin`) が、既存の `PATH` 変数の前に挿入されます。
1. 変更が有効になるように、プロファイルを現在のセッションに再ロードします。
```
$ source ~/.bash_profile
```
1. AWS CLI が正しくインストールされたことを確認します。
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
エラーが表示される場合は、「[AWS CLI のエラーのトラブルシューティング](cli-chap-troubleshooting.md)」を参照してください。
### AWS CLI バージョン 1 のバンドルされたインストーラのアンインストール
1. バンドルされたインストーラは、オプションのシンボリックリンク以外のすべてをインストールディレクトリの内部に配置します。したがって、アンインストールするには、これら 2 つの項目を削除するだけです。
```
$ sudo rm -rf /usr/local/aws
$ sudo rm /usr/local/bin/aws
```
1. **(オプション)** `.aws` フォルダ内の共有 AWS SDK と AWS CLI 設定情報を削除します。
**警告**
これらの設定と認証情報の設定は、すべての AWS SDK と AWS CLI で共有されます。このフォルダを削除すると、システムに残っている AWS SDK からはアクセスできなくなります。
`.aws` フォルダのデフォルトの場所はプラットフォームによって異なります。デフォルトでは、フォルダは *\$1/.aws/* にあります。このディレクトリへの書き込みアクセス許可がユーザーにある場合は、`sudo` を使用する必要はありません。
```
$ sudo rm ~/.aws/
```
## pip を使用した AWS CLI バージョン 1 のインストール、更新、アンインストール
`pip` を直接使用して AWS CLI をインストールできます。
**Topics**
+ [pip をインストールします。](#awscli-install-osx-pip-pip)
+ [pip を使用した AWS CLI のインストールと更新](#awscli-install-osx-pip-install)
+ [macOS コマンドラインパスへの AWS CLI バージョン 1 の実行可能ファイルの追加](#awscli-install-osx-path)
+ [pip を使用して AWS CLI をアンインストールする](#awscli-install-osx-pip-uninstall)
### pip をインストールします。
`pip` がインストールされていない場合は、*Python Packaging Authority* が提供するスクリプトを使用してインストールできます。`pip --version` を実行して、Linux のバージョンにすでに Python と `pip` が含まれているかどうか確認します。Python version 3 以降がインストールされている場合は、`pip3` コマンドの使用が推奨されます。
1. `curl` コマンドを使用してインストールスクリプトをダウンロードします。以下のコマンドでは、`-O` (大文字の O) パラメータを使用して、ダウンロードしたファイルが、リモートホストでの同じ名前で、現在のフォルダに保存されるように指定します。
```
$ curl -O https://bootstrap.pypa.io/get-pip.py
```
1. `python` または `python3` コマンドでスクリプトを実行して、`pip` の最新バージョンとその他の必要なサポートパッケージをダウンロードしてインストールします。`--user` スイッチを含めると、スクリプトは `pip` をパス `~/.local/bin` にインストールします。
```
$ python3 get-pip.py --user
```
### pip を使用した AWS CLI のインストールと更新
1. `pip` または `pip3` コマンドを使用して、AWS CLI をインストールします。Python バージョン 3 以降を使用する場合、`pip3` コマンドの使用が推奨されます。
**AWS CLI の最新バージョンの場合は**、次のコマンドブロックを使用します。
```
$ pip3 install awscli --upgrade --user
```
**AWS CLI の特定バージョンの場合は**、ファイル名に 2 つの等号 「`=`」とバージョン番号を追加します。この例では、バージョン *1.16.312* のファイル名が *==1.16.312* になるため、コマンドは以下のようになります。
```
$ pip3 install awscli==1.16.312 --upgrade --user
```
**注記**
端末に適切な引用符ルールを使用してください。`=` 文字を使用するには、一重引用符または二重引用符を使用して、適切にエスケープする必要があります。次の例では、一重引用符を使用してエスケープしています。
```
$ pip3 install 'awscli==1.16.312' --upgrade --user
```
1. AWS CLI が正しくインストールされたことを確認します。
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Darwin/23.3.0 botocore/1.18.6
```
プログラムが見つからない場合は、[そのプログラムをコマンドラインパスに追加](#awscli-install-osx-path)します。
### macOS コマンドラインパスへの AWS CLI バージョン 1 の実行可能ファイルの追加
`pip` を使用してインストールした後は、オペレーティングシステムの `aws` 環境変数への `PATH` プログラムの追加が必要になる場合があります。プログラムの場所は、Python のインストール先によって異なります。
**Example AWS CLI のインストール場所 - Python 3.6 および `pip` のある macOS (ユーザーモード)**
```
~/Library/Python/3.7/bin
```
前の例のバージョン用に使用する Python のバージョンで置き換えます。
Python のインストール先がわからない場合は、`which python` を実行します。
```
$ which python
/usr/local/bin/python
```
出力は、実際のプログラムではなくシンボリックリンクへのパスになる場合があります。`ls -al` を実行して、その参照先を確認します。
```
$ ls -al /usr/local/bin/python
~/Library/Python/3.7/bin/python3.7
```
`pip` は、Python プログラムが含まれている同じフォルダに、アプリケーションをインストールします。このフォルダを `PATH` 変数に追加します。
**`PATH` 変数を変更するには**
1. ユーザーディレクトリでシェルのプロファイルスクリプトを見つけます。現在使用しているシェルが不明な場合は、`echo $SHELL` を実行します。
```
$ ls -a ~
. .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
```
+ **Bash** - `.bash_profile`、`.profile`、または `.bash_login`
+ **Zsh** – `.zshrc`
+ **Tcsh** - `.tcshrc`、`.cshrc`、または `.login`
1. プロファイルスクリプトにエクスポートコマンドを追加します。
```
export PATH=~/.local/bin:$PATH
```
このコマンドは、現在の `~/.local/bin` 変数にパス (この例では `PATH`) を追加します。
1. 現在のセッションに更新されたプロファイルをロードします。
```
$ source ~/.bash_profile
```
### pip を使用して AWS CLI をアンインストールする
1. `pip` を使用して AWS CLI バージョン 1 をインストールした場合は、`pip` を使用してアンインストールする必要もあります。
```
$ pip uninstall awscli
```
Python 2 または 3 バージョンを使用している場合は、`pip2` または `pip3` コマンドを使用する必要がある場合があります。`aws --version` コマンドを使用して、インストールした AWS CLI バージョン 1 に関連付けられている Python バージョンを確認します。
```
$ pip3 uninstall awscli
```
すべてのファイルを削除するには、コマンドプロンプトウィンドウまたはコンピュータの再起動が必要になる場合があります。
1. **(オプション)** `.aws` フォルダ内の共有 AWS SDK と AWS CLI 設定情報を削除します。
**警告**
これらの設定と認証情報の設定は、すべての AWS SDK と AWS CLI で共有されます。このフォルダを削除すると、システムに残っている AWS SDK からはアクセスできなくなります。
`.aws` フォルダのデフォルトの場所はプラットフォームによって異なります。デフォルトでは、フォルダは *\$1/.aws/* にあります。このディレクトリへの書き込みアクセス許可がユーザーにある場合は、`sudo` を使用する必要はありません。
```
$ sudo rm -rf ~/.aws/
```
## AWS CLI のインストールエラーとアンインストールエラーのトラブルシューティング
AWS CLI をインストールまたはアンインストールした後に問題が発生した場合のトラブルシューティングステップについては、「[AWS CLI のエラーのトラブルシューティング](cli-chap-troubleshooting.md)」を参照してください。最も関連性の高いトラブルシューティングステップについては、「[コマンドが見つからないエラー](cli-chap-troubleshooting.md#tshoot-install-not-found)」、「[「`aws --version`」コマンドが、インストールしたのとは異なるバージョンを返す](cli-chap-troubleshooting.md#tshoot-install-wrong-version)」、および「[AWS CLI のアンインストール後に、「`aws --version`」コマンドがバージョンを返す](cli-chap-troubleshooting.md#tshoot-uninstall-1)」を参照してください。
# Installing, Updating, and Uninstalling the AWS CLI version 1 on Windows
Windows に AWS Command Line Interface (AWS CLI) のバージョン 1 をインストールするには、スタンドアロンインストーラを使用するか (推奨)、または Python のパッケージマネージャーである `pip` を使用します。
コマンドを入力するときは、プロンプト記号 (`C:\>`) を含めないでください。これらは、入力したコマンドと AWS CLI から返された出力を区別するためにプログラムのリストに含まれています。このガイドの残りの部分では、コマンドが Windows 固有の場合を除き、一般的なプロンプト記号 (`$`) を使用します。
**Topics**
+ [MSI インストーラを使用した AWS CLI バージョン 1 のインストール、更新、アンインストール](#msi-on-windows)
+ [Python と pip を使用した Windows での AWS CLI バージョン 1 のインストール、更新、アンインストール](#awscli-install-windows-pip)
+ [コマンドラインパスへの AWS CLI バージョン 1 の実行可能ファイルの追加](#awscli-install-windows-path)
+ [AWS CLI のインストールエラーとアンインストールエラーのトラブルシューティング](#awscli-install-windows-tshoot)
## MSI インストーラを使用した AWS CLI バージョン 1 のインストール、更新、アンインストール
AWS CLI バージョン 1 は、Windows XP 以降でサポートされています。Windows ユーザーの場合、MSI インストールパッケージが、他の前提条件をインストールせずに AWS CLI バージョン 1 をインストールするための使い慣れた便利な方法を提供します。
### MSI インストーラを使用した AWS CLI バージョン 1 のインストールと更新
GitHub の[リリース](https://github.com/aws/aws-cli/releases)ページで、最新バージョンがいつリリースされたかを確認してください。更新がリリースされたら、インストールプロセスを繰り返して AWS CLI バージョン 1 の最新バージョンを取得する必要があります。
1. 適切な MSI インストーラをダウンロードします。
+ Windows 用 AWS CLI MSI インストーラ (64 ビット):[https://s3.amazonaws.com/aws-cli/AWSCLI64PY3.msi](https://s3.amazonaws.com/aws-cli/AWSCLI64PY3.msi)
+ Windows 用 AWS CLI MSI インストーラ (32 ビット):[https://s3.amazonaws.com/aws-cli/AWSCLI32PY3.msi](https://s3.amazonaws.com/aws-cli/AWSCLI32PY3.msi)
+ AWS CLI で、Windows 用の設定ファイル: [https://s3.amazonaws.com/aws-cli/AWSCLISetup.exe](https://s3.amazonaws.com/aws-cli/AWSCLISetup.exe) が統合されました (32 ビットと 64 ビットの両方の MSI インストーラが含まれ、正しいバージョンが自動的にインストールされます)。
1. ダウンロードした MSI インストーラまたは設定ファイルを実行します。
1. 画面上の指示に従ってください。AWS CLI バージョン 1 はデフォルトで、`C:\Program Files\Amazon\AWSCLI` (64 ビットバージョン) または `C:\Program Files (x86)\Amazon\AWSCLI` (32 ビットバージョン) にインストールされます。
1. インストールを確認するには、コマンドプロンプトで `aws --version` コマンドを使用します (コマンドプロンプトを開始するには、[**スタート**] メニューを開いて "`cmd`" を検索します)。
```
C:\> aws --version
aws-cli/1.40.41 Python/3.11.6 Windows/10 botocore/1.18.6
```
Windows がプログラムを見つけることができない場合、パスを読み込み直すためにコマンドプロンプトを閉じて再度開くか、または手動で[インストールディレクトリを PATH 環境変数に追加](#awscli-install-windows-path)する必要が生じることもあります。
### AWS CLI バージョン 1 のアンインストール
以下のアンインストール手順を使用するには、MSI インストーラまたはセットアップファイルで AWS CLI バージョン 1 をインストールしている必要があります。
1. 次のいずれかを実行して、[**プログラムと機能**] を開きます。
+ [**コントロールパネル**] を開き、[**プログラムと機能**] を選択します。
+ コマンドプロンプトを開き、次のコマンドを使用します。
```
C:\> appwiz.cpl
```
1. [**AWS Command Line Interface**] という名前のエントリを選択後、[**アンインストール**] を選択してアンインストーラを起動します。
1. AWS CLI をアンインストールすることを確認します。
1. **(オプション)** `.aws` フォルダ内の共有 AWS SDK と AWS CLI 設定情報を削除します。
**警告**
これらの設定と認証情報の設定は、すべての AWS SDK と AWS CLI で共有されます。このフォルダを削除すると、システムに残っている AWS SDK からはアクセスできなくなります。
`.aws` フォルダのデフォルトの場所はプラットフォームによって異なります。デフォルトでは、フォルダは *%UserProfile%\$1.aws* にあります。
```
$ rmdir %UserProfile%\.aws
```
## Python と pip を使用した Windows での AWS CLI バージョン 1 のインストール、更新、アンインストール
Python Software Foundation は、`pip` を含む Windows 用インストーラを提供しています。
### 前提条件
Python 3.8 以降をインストールする必要があります。インストール手順については、Python の *Beginner Guide* で「[Downloading Python](https://wiki.python.org/moin/BeginnersGuide/Download)」ページを参照してください。
### pip を使用した AWS CLI バージョン 1 のインストールと更新
1. AWS CLI バージョン 1 をインストールするには、`pip3` コマンド (Python バージョン 3 以降を使用している場合) または `pip` コマンドを使用します。
**AWS CLI の最新バージョンの場合は**、次のコマンドブロックを使用します。
```
C:\> pip3 install awscli --upgrade --user
```
**特定バージョンの AWS CLI には**、ファイル名に小なり記号 `<` とバージョン番号を付加してください。この例では、バージョン *1.16.312* のファイル名が *<1.16.312* になるため、コマンドは以下のようになります。
```
C:\> pip3 install awscli<1.16.312 --upgrade --user
```
1. AWS CLI バージョン 1 が正しくインストールされていることを確認します。応答がない場合は、[コマンドラインパスへの AWS CLI バージョン 1 の実行可能ファイルの追加](#awscli-install-windows-path) セクションを参照してください。
```
C:\> aws --version
aws-cli/1.40.41 Python/3.11.6 Windows/10 botocore/1.18.6
```
### pip を使用した AWS CLI バージョン 1 のアンインストール
1. `pip` を使用して AWS CLI バージョン 1 をインストールした場合は、`pip` を使用してアンインストールする必要もあります。
```
C:\> pip uninstall awscli
```
Python 2 または 3 バージョンを使用している場合は、`pip2` または `pip3` コマンドを使用する必要がある場合があります。`aws --version` コマンドを使用して、インストールした AWS CLI バージョン 1 に関連付けられている Python バージョンを確認します。
```
C:\> pip3 uninstall awscli
```
すべてのファイルを削除するには、コマンドプロンプトウィンドウまたはコンピュータの再起動が必要になる場合があります。
1. **(オプション)** `.aws` フォルダ内の共有 AWS SDK と AWS CLI 設定情報を削除します。
**警告**
これらの設定と認証情報の設定は、すべての AWS SDK と AWS CLI で共有されます。このフォルダを削除すると、システムに残っている AWS SDK からはアクセスできなくなります。
`.aws` フォルダのデフォルトの場所はプラットフォームによって異なります。デフォルトでは、フォルダは *%UserProfile%\$1.aws* にあります。
```
$ rmdir %UserProfile%\.aws
```
## コマンドラインパスへの AWS CLI バージョン 1 の実行可能ファイルの追加
`pip` を使用して AWS CLI バージョン 1 をインストールしたら、オペレーティングシステムの `PATH` 環境変数に `aws` プログラムを追加します。MSI のインストールでは、これは自動的に行われます。ただし、インストール後に `aws` コマンドが実行されない場合は、手動で設定する必要があります。
1. `where` コマンドを使用して、`aws` ファイルの場所を検索します。デフォルトでは、`where` コマンドは、指定したプログラムがシステムの `PATH` 内のどこにあるかを表示します。
```
C:\> where aws
```
表示されるパスは、プラットフォームと、AWS CLI のインストールに使用した方法によって異なります。バージョン番号が含まれるフォルダ名は、異なる場合があります。これらの例では、Python バージョン 3.7 を使用しています。必要に応じて、使用しているバージョン番号にバージョンを置き換えます。代表的なパスとしては、以下のようなものがあります。
+ **Python 3 と `pip3`** - `C:\Program Files\Python37\Scripts\`
+ ** Python 3 と`pip3` -- 以前のバージョンの Windows における user オプション ** -- `%USERPROFILE%\AppData\Local\Programs\Python\Python37\Scripts`
+ ** Python 3 と`pip3` -- Windows 10 における user オプション **-- `%USERPROFILE%\AppData\Roaming\Python\Python37\Scripts`
+ **MSI インストーラ (64 ビット)** -`C:\Program Files\Amazon\AWSCLI\bin`
+ **MSI インストーラ (32 ビット)** -`C:\Program Files (x86)\Amazon\AWSCLI\bin`
ファイルパスが返されるかどうかに基づいて、次のステップを使用します。
------
#### [ A file path is returned ]
```
C:\> where aws
C:\Program Files\Amazon\AWSCLI\bin\aws.exe
```
次のコマンドを実行すると、`aws` プログラムがインストールされた場所を確認できます。
```
C:\> where c:\ aws
C:\Program Files\Python37\Scripts\aws
```
------
#### [ A file path is NOT returned ]
`where` コマンドが次のエラーを返す場合、プログラムはシステムの `PATH` 内にはなく、名前を入力するだけでは実行できません。
```
C:\> where c:\ aws
INFO: Could not find files for the given pattern(s).
```
この場合は、`where` パラメータを指定して `/R path` コマンドを実行し、すべてのフォルダを検索するように指示します。その後に、パスを手動で追加する必要があります。コマンドラインまたはファイルエクスプローラーを使用して、コンピュータのインストールされている場所を見つけます。
```
C:\> where /R c:\ aws
c:\Program Files\Amazon\AWSCLI\bin\aws.exe
c:\Program Files\Amazon\AWSCLI\bincompat\aws.cmd
c:\Program Files\Amazon\AWSCLI\runtime\Scripts\aws
c:\Program Files\Amazon\AWSCLI\runtime\Scripts\aws.cmd
...
```
------
1. Windows キーを押し、「**environment variables**」と入力します。
1. **[Edit environment variables for your account]** (アカウントの環境変数を編集する) を選択します。
1. **PATH** を選択して、**編集** を選択します。
1. 見つかったパスを [**変数値**] フィールドに追加します (例: ***C:\$1Program Files\$1Amazon\$1AWSCLI\$1bin\$1aws.exe***)。
1. [**OK**] を 2 回選択して、新しい設定を適用します。
1. 実行中のコマンドプロンプトを閉じ、コマンドプロンプトウィンドウを再度開きます。
## AWS CLI のインストールエラーとアンインストールエラーのトラブルシューティング
AWS CLI をインストールまたはアンインストールした後に問題が発生した場合のトラブルシューティングステップについては、「[AWS CLI のエラーのトラブルシューティング](cli-chap-troubleshooting.md)」を参照してください。最も関連性の高いトラブルシューティングステップについては、「[コマンドが見つからないエラー](cli-chap-troubleshooting.md#tshoot-install-not-found)」、「[「`aws --version`」コマンドが、インストールしたのとは異なるバージョンを返す](cli-chap-troubleshooting.md#tshoot-install-wrong-version)」、および「[AWS CLI のアンインストール後に、「`aws --version`」コマンドがバージョンを返す](cli-chap-troubleshooting.md#tshoot-uninstall-1)」を参照してください。
# Installing and updating the AWS CLI version 1 in a virtual environment
仮想環境に `pip` (AWS Command Line Interface) のバージョン 1 をインストールすることで、他の AWS CLI パッケージとのバージョンに関する要件の競合を回避できます。
**Topics**
+ [前提条件](#install-virtualenv-prereqs)
+ [仮想環境での AWS CLI バージョン 1 のインストールと更新](#install-virtualenv-install)
+ [AWS CLI のインストールエラーとアンインストールエラーのトラブルシューティング](#install-virtualenv-tshoot)
## 前提条件
+ Python 3.8 以降。インストール手順については、Python の *Beginner Guide* で「[Downloading Python](https://wiki.python.org/moin/BeginnersGuide/Download)」ページを参照してください。
**Python バージョンのサポートマトリックス**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/cli/v1/userguide/install-virtualenv.html)
+ `pip` または `pip3` がインストールされています。
## 仮想環境での AWS CLI バージョン 1 のインストールと更新
1. `virtualenv` を使用して `pip` をインストールします。
```
$ pip install --user virtualenv
```
1. 仮想環境を作成して名前を付けます。
```
$ virtualenv ~/cli-ve
```
または、`-p` オプションを使用してデフォルト以外のバージョンの Python を指定できます。
```
$ virtualenv -p /usr/bin/python37 ~/cli-ve
```
1. 新しい仮想環境をアクティブ化します。
**Linux または macOS**
```
$ source ~/cli-ve/bin/activate
```
**Windows**:
```
$ %USERPROFILE%\cli-ve\Scripts\activate
```
プロンプトが変わり、仮想環境がアクティブであることが示されます。
```
(cli-ve)~$
```
1. 仮想環境で AWS CLI バージョン 1 をインストールまたは更新します。
```
(cli-ve)~$ pip install --upgrade awscli
```
1. AWS CLI バージョン 1 が正しくインストールされていることを確認します。
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
1. `deactivate` コマンドを使用して、仮想環境を終了できます。新しいセッションを開始するたびに、環境を再度アクティブ化する必要があります。
## AWS CLI のインストールエラーとアンインストールエラーのトラブルシューティング
AWS CLI をインストールまたはアンインストールした後に問題が発生した場合のトラブルシューティングステップについては、「[AWS CLI のエラーのトラブルシューティング](cli-chap-troubleshooting.md)」を参照してください。最も関連性の高いトラブルシューティングステップについては、「[コマンドが見つからないエラー](cli-chap-troubleshooting.md#tshoot-install-not-found)」、「[「`aws --version`」コマンドが、インストールしたのとは異なるバージョンを返す](cli-chap-troubleshooting.md#tshoot-install-wrong-version)」、および「[AWS CLI のアンインストール後に、「`aws --version`」コマンドがバージョンを返す](cli-chap-troubleshooting.md#tshoot-uninstall-1)」を参照してください。