AWS CLI でよく使うコマンド

概要

AWS CLI 利用時によく使いそうなものを記載する。

環境変数

設定ファイルの保存パス。

• Linux: ~/.aws/
• Windows: %USERPROFILE%\.aws\

設定確認コマンド

• プロファイル一覧の表示
  • aws configure list-profiles
• 設定内容の確認
  • aws configure list
  • aws configure list　--profile <name>

[Windows/Cmd]

set AWS_ACCESS_KEY_ID 
set AWS_SECRET_ACCESS_KEY 
set AWS_DEFAULT_REGION ap-northeast-1
set AWS_PROFILE 

• 恒久的な設定時は setx を使用(ユーザ環境変数に保存)。
  • setx - Windowsコマンド虎の巻
• 変数の参照は set か echo %XXX%。
• コマンドプロンプトでのエスケープは、^ を使う。

[Linux]

export AWS_ACCESS_KEY_ID=
export AWS_SECRET_ACCESS_KEY=
export AWS_DEFAULT_REGION=ap-northeast-1
export AWS_PROFILE=

[Windows/Powershell]

$Env:AWS_ACCESS_KEY_ID=""
$Env:AWS_SECRET_ACCESS_KEY=""
$Env:AWS_DEFAULT_REGION="ap-northeast-1"
$Env:AWS_PROFILE=""

• 一覧確認は、Get-Item -Path Env:。個別参照は、$Env:XXX。
  • 環境変数について - PowerShell | Microsoft Learn

• $Env は環境変数。普通の変数(自動変数)は $ で参照と設定が可能。

    $MyVariable = 1, 2, 3
    $MyVariable
  

  • 自動変数の一覧表示は、Get-Variable。
  • リテラルは明示的に "" で囲む(場合により、コマンドとして認識される)。
  • 変数について - PowerShell | Microsoft Learn
• PowerShell でのエスケープは ` を使う。

see

• AWS CLI を設定する環境変数 - AWS Command Line Interface

汎用

アカウント情報の表示

IAM の権限は不要(CLI の実行ができれば良い)。

aws sts get-caller-identity

#抜くとき
ACCOUNT=$(aws sts get-caller-identity --query Account --output text)

有効なリージョンの確認

[有効なリージョンの表示]

aws ec2 describe-regions --all-regions \
--filters "Name=opt-in-status,Values=opt-in*" \
--query "sort_by(Regions[].{Name:RegionName},&Name)" --output text

• 有効なリージョン
  • デフォルトで有効: "OptInStatus": "opt-in-not-required"
  • 追加で有効: "OptInStatus": "opted-in"
• 無効なリージョン
  • "OptInStatus": "not-opted-in"

[利用例]

下記のように変数に代入してオプションとして利用。

REGIONS=$(aws ec2 describe-regions --all-regions \
--filters "Name=opt-in-status,Values=opt-in*" \
--query "sort_by(Regions[].{Name:RegionName},&Name)" --output text)

see

• [AWS] アカウントの有効リージョンを AWS CLI で確認する – Inomaso Blog
• AWS リージョンの管理 - AWS 全般のリファレンス

--filters/--query オプション

• 【手順】AWS CLIのセットアップ - それ積んどく？(基本的なオプション)

CloudFormation

• AWS CloudFormation と和解せよ - それ積んどく？(CLI)
• AWS CloudFormation StackSets のまとめ - それ積んどく？(CLI)