作るもの
全リージョンを回して、次のような表を作る。サービスごとに返ってくる項目は違うが、「リージョン・サービス・ID・名前・種類・状態・作成日時・タグ」の共通の列にそろえることで、1つの表として並べ替えや絞り込みができるようにする。
| region | service | id | name | type | state | created | env | owner |
|---|---|---|---|---|---|---|---|---|
| ap-northeast-1 | EC2 | i-0123… | web-01 | t3.micro | running | 2026-10-01 09:12 | prod | team-a |
| ap-northeast-1 | RDS | app-db | app-db | db.t4g.medium / postgres 16.4 | available | 2026-04-10 15:03 | prod | team-a |
| ap-northeast-1 | Lambda | report-daily | report-daily | python3.12 / 256MB | - | 2026-09-30 11:45 | ||
| us-east-1 | S3 | example-logs-bucket | example-logs-bucket | bucket | - | 2025-12-01 10:00 |
env・owner はタグ(Env・Owner)の値だ。自分の組織で使っているタグのキーに合わせて変えてほしい。
必要なIAMポリシー
このスクリプトが呼ぶAPIは5つだけなので、定期実行用のロールには次の最小ポリシーを付ければ足りる。
{
"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 は別に取得する。
"""全リージョンの 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()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 21つのリージョンで権限エラーが起きても全体は止まらず、最後に [skip] として表示される。SCP(サービスコントロールポリシー)で使わないリージョンを禁止している組織では、そのリージョンがここに並ぶ。
サービスごとのクセ
4つのサービスを1つの表にそろえるために、スクリプトの中でいくつか吸収している違いがある。別のサービスを追加するときにも同じ点でつまずきやすいので、整理しておく。
| 違い | EC2 | RDS | Lambda | S3 |
|---|---|---|---|---|
| 呼び出しの単位 | リージョン | リージョン | リージョン | アカウント全体で1回 |
| タグ | Tags(無ければキーごと無い) | TagList | 含まれない(list_tags が別に必要) | 含まれない(get_bucket_tagging が別に必要) |
| 作成日時 | LaunchTime(最後に起動した日時) | InstanceCreateTime | LastModified(文字列・最終更新) | CreationDate |
| 状態 | State.Name | DBInstanceStatus | 一覧では返らない(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 書き込みの記事 で解説しているので、ここでは棚卸しの表に必要な部分だけを示す。
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") を呼べばよい。
タグで集計する
棚卸しの表ができたら、タグが付いていないリソースを洗い出すのが次の一歩だ。「誰が作ったか分からないリソース」は、コスト削減でもセキュリティでも最初に確認すべき対象になる。
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 があったら
東京リージョンしか使っていないつもりでも、検証時に作ったリソースが別のリージョンに残っていることはよくある。全リージョンを回す棚卸しの価値は、まさにこうした「コンソールで東京リージョンだけを見ていると気付かないもの」を見つけられる点にある。
別のサービスを追加するには
サービスを追加するときは、次の順で考えると迷わない。
- 一覧のAPIを探す:PART 07 の一覧表、または boto3 リファレンスでサービス名を開き、
describe_/list_で始まるメソッドを探す - Paginator があるか確かめる:
client.can_paginate("メソッド名") - リージョン単位かアカウント全体かを確かめる:リージョン単位なら
collect_per_regionに追加、全体なら S3 と同じく別に呼ぶ - 共通の列に合わせる:
row()に渡す値を決める。タグが含まれないなら空の dict を渡しておく - IAMポリシーにアクションを追加する
✅ 次の記事では…
PART 05 では、リソースの一覧から一歩進んで、CloudWatch のメトリクス(CPU使用率など)と Cost Explorer のコストを取得する。