作るもの

全リージョンを回して、次のような表を作る。サービスごとに返ってくる項目は違うが、「リージョン・サービス・ID・名前・種類・状態・作成日時・タグ」の共通の列にそろえることで、1つの表として並べ替えや絞り込みができるようにする。

regionserviceidnametypestatecreatedenvowner
ap-northeast-1EC2i-0123…web-01t3.microrunning2026-10-01 09:12prodteam-a
ap-northeast-1RDSapp-dbapp-dbdb.t4g.medium / postgres 16.4available2026-04-10 15:03prodteam-a
ap-northeast-1Lambdareport-dailyreport-dailypython3.12 / 256MB-2026-09-30 11:45
us-east-1S3example-logs-bucketexample-logs-bucketbucket-2025-12-01 10:00

env・owner はタグ(Env・Owner)の値だ。自分の組織で使っているタグのキーに合わせて変えてほしい。

必要なIAMポリシー

このスクリプトが呼ぶAPIは5つだけなので、定期実行用のロールには次の最小ポリシーを付ければ足りる。

IAMポリシー(JSON)
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "InventoryReadOnly",
      "Effect": "Allow",
      "Action": [
        "ec2:DescribeRegions",
        "ec2:DescribeInstances",
        "rds:DescribeDBInstances",
        "lambda:ListFunctions",
        "s3:ListAllMyBuckets"
      ],
      "Resource": "*"
    }
  ]
}

S3 の list_buckets に必要なアクション名が s3:ListAllMyBuckets であるように、boto3 のメソッド名とIAMのアクション名が一致しないことがある。ポリシーを書くときは、サービス認可リファレンス(Service Authorization Reference)で確認する。

完成したスクリプト

PART 03 の awsutil.py を同じフォルダに置いて使う。リージョン単位で取得する3サービス(EC2・RDS・Lambda)は並列に、アカウント全体で1回だけ呼べばよい S3 は別に取得する。

inventory.py
"""全リージョンの EC2 / RDS / Lambda / S3 を1つの表にまとめて CSV に出力する。

使い方: python inventory.py --profile dev --out inventory.csv
"""
import argparse
import csv
import sys
from collections import Counter

from awsutil import CONFIG, enabled_regions, make_session, paginate, run_per_region, tags_to_dict

COLUMNS = ["region", "service", "id", "name", "type", "state", "created", "env", "owner"]


def fmt_time(dt):
    """datetime(UTC)を日本時間の文字列にする。"""
    from datetime import timedelta, timezone
    return dt.astimezone(timezone(timedelta(hours=9))).strftime("%Y-%m-%d %H:%M") if dt else ""


def row(region, service, rid, name, rtype, state, created, tags):
    return {"region": region, "service": service, "id": rid, "name": name, "type": rtype,
            "state": state, "created": created, "env": tags.get("Env", ""), "owner": tags.get("Owner", "")}


def collect_ec2(session, region):
    ec2 = session.client("ec2", config=CONFIG)
    rows = []
    for page in ec2.get_paginator("describe_instances").paginate():
        for r in page["Reservations"]:
            for i in r["Instances"]:
                tags = tags_to_dict(i.get("Tags"))
                rows.append(row(region, "EC2", i["InstanceId"], tags.get("Name", ""), i["InstanceType"],
                                i["State"]["Name"], fmt_time(i.get("LaunchTime")), tags))
    return rows


def collect_rds(session, region):
    rds = session.client("rds", config=CONFIG)
    rows = []
    for db in paginate(rds, "describe_db_instances", "DBInstances"):
        tags = tags_to_dict(db.get("TagList"))
        rtype = f'{db["DBInstanceClass"]} / {db["Engine"]} {db.get("EngineVersion", "")}'
        rows.append(row(region, "RDS", db["DBInstanceIdentifier"], db["DBInstanceIdentifier"], rtype,
                        db["DBInstanceStatus"], fmt_time(db.get("InstanceCreateTime")), tags))
    return rows


def collect_lambda(session, region):
    lam = session.client("lambda", config=CONFIG)
    rows = []
    for fn in paginate(lam, "list_functions", "Functions"):
        runtime = fn.get("Runtime") or fn.get("PackageType", "")   # コンテナイメージは Runtime が無い
        rtype = f'{runtime} / {fn.get("MemorySize", "")}MB'
        # LastModified は "2026-09-30T02:45:00.000+0000" 形式の文字列で返る
        # list_functions は State を返さない(必要なら get_function を関数ごとに呼ぶ)
        rows.append(row(region, "Lambda", fn["FunctionName"], fn["FunctionName"], rtype,
                        "-", fn.get("LastModified", "")[:16].replace("T", " "), {}))
    return rows


def collect_per_region(session, region):
    return collect_ec2(session, region) + collect_rds(session, region) + collect_lambda(session, region)


def collect_s3(session):
    s3 = session.client("s3", config=CONFIG)
    rows = []
    for b in paginate(s3, "list_buckets", "Buckets"):
        region = b.get("BucketRegion")
        if not region:   # 古いSDK・一部の環境向けのフォールバック
            loc = s3.get_bucket_location(Bucket=b["Name"])["LocationConstraint"]
            region = loc or "us-east-1"   # us-east-1 は None で返る
        rows.append(row(region, "S3", b["Name"], b["Name"], "bucket", "-", fmt_time(b["CreationDate"]), {}))
    return rows


def main():
    ap = argparse.ArgumentParser()
    ap.add_argument("--profile", default=None)
    ap.add_argument("--out", default="inventory.csv")
    args = ap.parse_args()

    session = make_session(args.profile)
    regions = enabled_regions(session)
    print(f"{len(regions)} regions: {', '.join(regions)}", file=sys.stderr)

    rows, errors = run_per_region(session, regions, collect_per_region)
    rows += collect_s3(session)
    rows.sort(key=lambda r: (r["service"], r["region"], r["name"]))

    # Excel で開いても文字化けしないよう、BOM 付き UTF-8 で書く
    with open(args.out, "w", newline="", encoding="utf-8-sig") as f:
        w = csv.DictWriter(f, fieldnames=COLUMNS)
        w.writeheader()
        w.writerows(rows)

    print(f"{len(rows)} resources -> {args.out}", file=sys.stderr)
    for (svc, reg), n in sorted(Counter((r["service"], r["region"]) for r in rows).items()):
        print(f"  {svc:7} {reg:16} {n:4}", file=sys.stderr)
    for region, code in errors:
        print(f"  [skip] {region}: {code}", file=sys.stderr)


if __name__ == "__main__":
    main()
実行例(PowerShell)
PS> python inventory.py --profile dev --out inventory.csv
17 regions: ap-northeast-1, ap-northeast-2, ap-northeast-3, ap-south-1, ...
42 resources -> inventory.csv
  EC2     ap-northeast-1     12
  EC2     us-east-1           2
  Lambda  ap-northeast-1     18
  RDS     ap-northeast-1      3
  S3      ap-northeast-1      5
  S3      us-east-1           2

1つのリージョンで権限エラーが起きても全体は止まらず、最後に [skip] として表示される。SCP(サービスコントロールポリシー)で使わないリージョンを禁止している組織では、そのリージョンがここに並ぶ。

サービスごとのクセ

4つのサービスを1つの表にそろえるために、スクリプトの中でいくつか吸収している違いがある。別のサービスを追加するときにも同じ点でつまずきやすいので、整理しておく。

違いEC2RDSLambdaS3
呼び出しの単位リージョンリージョンリージョンアカウント全体で1回
タグTags(無ければキーごと無い)TagList含まれない(list_tags が別に必要)含まれない(get_bucket_tagging が別に必要)
作成日時LaunchTime(最後に起動した日時)InstanceCreateTimeLastModified(文字列・最終更新)CreationDate
状態State.NameDBInstanceStatus一覧では返らない(get_function で取得)なし
入れ子Reservations[].Instances[]DBInstances[]Functions[]Buckets[]
  • EC2 の LaunchTime は作成日時ではない:停止と起動を繰り返すと、最後に起動した日時に更新される。最初に作った日時が必要なら、ルートボリュームの AttachTime(BlockDeviceMappings の中)を使うのが一般的だ
  • Lambda の日時は文字列:多くのサービスは datetime 型で返すが、Lambda の LastModified は "2026-09-30T02:45:00.000+0000" のような文字列だ。そのため上のスクリプトでは UTC のまま切り出している
  • Lambda のタグを取るには関数ごとに呼び出しが必要:lam.list_tags(Resource=fn["FunctionArn"]) を関数の数だけ呼ぶことになる。数百の関数があると時間がかかるので、タグで横断的に探したいなら PART 07 で紹介するタグ付けAPI(resourcegroupstaggingapi)のほうが効率がよい
  • S3 のリージョン:list_buckets のレスポンスには BucketRegion が含まれる。含まれない場合に備えて get_bucket_location にフォールバックしているが、こちらは us-east-1 のバケットで None を返すという古い仕様が残っている

Excel に出力する

CSV のままでも Excel で開けるが、毎回フィルターや列幅を設定するのは手間だ。openpyxl を使えば、見出しの固定・オートフィルター・列幅まで設定した状態で出力できる。openpyxl の基本は Excel 書き込みの記事 で解説しているので、ここでは棚卸しの表に必要な部分だけを示す。

to_excel.py
from openpyxl import Workbook
from openpyxl.styles import Font, PatternFill


def write_excel(rows, columns, path):
    wb = Workbook()
    ws = wb.active
    ws.title = "inventory"
    ws.append(columns)
    for r in rows:
        ws.append([r[c] for c in columns])

    for cell in ws[1]:                                  # 見出し行
        cell.font = Font(bold=True, color="FFFFFF")
        cell.fill = PatternFill("solid", fgColor="1F4E78")
    ws.freeze_panes = "A2"                              # 見出しを固定
    ws.auto_filter.ref = ws.dimensions                  # オートフィルター
    for col in ws.columns:                              # 列幅をおおまかに合わせる
        width = max(len(str(c.value or "")) for c in col)
        ws.column_dimensions[col[0].column_letter].width = min(width + 2, 50)
    wb.save(path)

inventory.py の CSV 出力の代わりに write_excel(rows, COLUMNS, "inventory.xlsx") を呼べばよい。

タグで集計する

棚卸しの表ができたら、タグが付いていないリソースを洗い出すのが次の一歩だ。「誰が作ったか分からないリソース」は、コスト削減でもセキュリティでも最初に確認すべき対象になる。

tag_report.py
import csv
from collections import Counter

with open("inventory.csv", encoding="utf-8-sig") as f:
    rows = list(csv.DictReader(f))

# サービス × Env タグの件数
counts = Counter((r["service"], r["env"] or "(未設定)") for r in rows)
for (svc, env), n in sorted(counts.items()):
    print(f"{svc:7} {env:10} {n:4}")

# Owner タグが無い EC2 / RDS(タグを一覧で取れるサービスだけを対象にする)
print("\nOwner タグが未設定:")
for r in rows:
    if r["service"] in ("EC2", "RDS") and not r["owner"]:
        print(f'  {r["service"]} {r["region"]} {r["id"]} {r["name"]}')
出力例
EC2     dev           6
EC2     prod          5
EC2     (未設定)      3
Lambda  (未設定)     18
RDS     prod          3
S3      (未設定)      7

Owner タグが未設定:
  EC2 ap-northeast-1 i-0fedcba9876543210 batch-01
  EC2 us-east-1 i-0aaaaaaaaaaaaaaaa

💡 us-east-1 に見覚えのない EC2 があったら

東京リージョンしか使っていないつもりでも、検証時に作ったリソースが別のリージョンに残っていることはよくある。全リージョンを回す棚卸しの価値は、まさにこうした「コンソールで東京リージョンだけを見ていると気付かないもの」を見つけられる点にある。

別のサービスを追加するには

サービスを追加するときは、次の順で考えると迷わない。

  1. 一覧のAPIを探す:PART 07 の一覧表、または boto3 リファレンスでサービス名を開き、describe_ / list_ で始まるメソッドを探す
  2. Paginator があるか確かめる:client.can_paginate("メソッド名")
  3. リージョン単位かアカウント全体かを確かめる:リージョン単位なら collect_per_region に追加、全体なら S3 と同じく別に呼ぶ
  4. 共通の列に合わせる:row() に渡す値を決める。タグが含まれないなら空の dict を渡しておく
  5. IAMポリシーにアクションを追加する

✅ 次の記事では…

PART 05 では、リソースの一覧から一歩進んで、CloudWatch のメトリクス(CPU使用率など)と Cost Explorer のコストを取得する。

→ PART 05 — 実践:CloudWatch メトリクスと Cost Explorer のコストを取得するへ