
【技術ブログ】AWS CLIでEC2インスタンスの情報を取得する方法
こんにちは。Turtleです。
今回は、表題の通りAWS CLIを用いてEC2インスタンスの情報を取得する方法をご紹介します。
既に多くの方が同内容を記事にされており、今更自分が記事にするまでもない内容ですが、自身のアウトプットとして残しておきたいと思い、今回記事にしました。ご一読いただけますと幸いです。
1. 準備
AWS CLIのインストール、およびコマンドの実行のために、以下情報を準備してください。
インストール対象の端末のOS
認証に使用するIAMユーザーのアクセスキーIDとシークレットアクセスキー
2. 実装
以下でAWS CLIのインストールからインスタンスの一覧を取得するまでを解説しています。
なお、筆者はWindows端末を使用しており、MacOS・Linuxとは表示が異なる場合がありますので予めご了承ください。
2-1. AWS CLIのインストール
まずはじめに、AWS CLIのインストールを行います。
インストーラーは以下のページから入手することができます。
対象となる端末のOSに合わせてダウンロードするようにしてください。
先ほど入手したインストーラーを起動し、インストールを開始します。
画面の指示に従ってインストールを進めてください。
完了後、ターミナルやコマンドプロンプトで「aws --version」と入力して実行し、バージョンが表示されたらインストールは完了となります。

2-2. 認証情報の設定
次に、「aws configure」と入力し実行することで認証情報を設定します。
画面の表示内容に従って以下を設定していきます。
AWS Access Key ID
AWS Secret Access Key ID
Default region name
Default output format

設定した内容は「aws configure list」で確認することができます。
ちなみに、作成したプロファイルはWindowsだと「C:\Users{ユーザー名}.aws\credentials」に保存されます。

2-3. インスタンスの一覧を取得
無事に認証情報を登録できたら、「aws ec2 describe-instances」を使って、インスタンスの一覧を取得することができます。
また、上記コマンドに様々なオプションを付与することによって、自分が取得したい情報に限定して出力することができます。例えば以下のような形です。
# 特定のリージョンのインスタンスを取得
aws ec2 describe-instances --region <リージョン名>
# 起動中のインスタンスのみ取得
aws ec2 describe-instances --filters "Name=instance-state-name,Values=running"
# インスタンスIDとインスタンスタイプのみ取得
aws ec2 describe-instances --query "Reservations[].Instances[].[InstanceId, InstanceType]"
# 出力結果をテキストファイルに出力する
aws ec2 describe-instances --output text > instances.txt 以下の公式サイトに、例も合わせて詳細な記載がありますので、ぜひご確認ください。
3. おわりに
今回は、AWS CLIを用いてEC2インスタンスの情報を取得する方法をご紹介しました。
インスタンスの数が少ないうちは、マネジメントコンソールから見て情報をまとめていけばよいのですが、数が多くなってくると骨が折れる作業になってきます。
担当しているプロジェクトでインスタンスの情報をまとめる必要があったのですが、インスタンスの数が1,000を超えており、マネジメントコンソール上でホスト名やインスタンスタイプなどの情報を整理していくのはほとんど不可能に近い状況だったので、AWS CLIを利用することにしました。
同じような状況の方はぜひ利用を一度検討してみてください。