**このドキュメントはバージョン 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/)を参照してください。

# macOS での AWS CLI バージョン 1 のインストール、更新、アンインストール
<a name="install-macos"></a>

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)

## 前提条件
<a name="install-macosos-prereq"></a>

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 のインストール、更新、アンインストール
<a name="install-macosos-bundled"></a>

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 のインストール
<a name="install-macosos-bundled-sudo"></a>

次の手順では、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 のインストール
<a name="install-macosos-bundled-no-sudo"></a>

`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 のバンドルされたインストーラのアンインストール
<a name="install-macosos-bundled-uninstall"></a>

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 のインストール、更新、アンインストール
<a name="awscli-install-osx-pip"></a>

`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 をインストールします。
<a name="awscli-install-osx-pip-pip"></a>

`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 のインストールと更新
<a name="awscli-install-osx-pip-install"></a>

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 の実行可能ファイルの追加
<a name="awscli-install-osx-path"></a>

`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 をアンインストールする
<a name="awscli-install-osx-pip-uninstall"></a>

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 のインストールエラーとアンインストールエラーのトラブルシューティング
<a name="awscli-install-osx-tshoot"></a>

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)」を参照してください。