【AWS Lambda】describe_instancesの使い方を簡単解説！

今回は、boto3関数のdescribe_instancesについて解説します。
「どうやって使うの？」の解説からパラメータを入力したら自動でコード作成までお手伝いします。

目次

• 利用目的
• 権限
• コード生成
• 仕様

EC2を検索し、対象インスタンスの情報を取得します。

フィルター条件を設定しない場合は、全EC2をリストアップします。
各種フィルターが用意されているため、特定条件に合致するインスタンスを抽出することが可能です。

フィルター条件が多数用意されているため、本サイトで全てのフィルターのご用意ができません。
本ページのフィルター条件だけでは不足する場合は、以下のサイトより使用するフィルターを選定下さい。
　EC2(describe_instances)— Boto3 Docs

削除したEC2についても削除後約1時間程度までは検索可能ですが、それを超えると情報を取得することができません。

Lambdaに付与するIAMロールに「ec2:DescribeInstances」の権限を付与してください。

パラメータを入力することで、コピーすればすぐに使えるLambdaコードを生成できます。
「*」のついている物は必須パラメータで、ついていないものはオプションです。

import boto3

ec2_client = boto3.client('ec2')
def lambda_handler(event, context):
    response = ec2_client.describe_instances(
    )
    
    print(response)
    return 0

CloudWatchLogs(describe_instances)— Boto3 Docs

LambdaでEC2のタグに指定した時間で自動起動・自動停止する

長期間使用されていないIAMユーザーをリストアップする