一覧の見方
各表の列は次の意味だ。「範囲」がリージョンのものは、全体を知るには PART 03 の方法で全リージョンを回す必要がある。
- client:
session.client("ここ")に渡す名前 - 主なAPI:boto3 のメソッド名。★は Paginator がないもの
- IAMアクション:最小権限のポリシーを書くときに使う名前(メソッド名と違うものは太字)
- 範囲:リージョン単位か、アカウント全体(グローバル)か
メソッド名と必要なIAMアクションは、記事作成時点の boto3(1.43 系)とサービス認可リファレンスで確認している。サービスは頻繁に更新されるので、新しく使うときは公式のリファレンスもあわせて確認してほしい。
リソースの棚卸し
| サービス | client | 主なAPI | 取れる情報 | IAMアクション | 範囲 |
|---|---|---|---|---|---|
| EC2 | ec2 | describe_instances | インスタンスの種類・状態・IP・タグ・起動日時 | ec2:DescribeInstances | リージョン |
| EBS | ec2 | describe_volumes / describe_snapshots | ボリュームのサイズ・種類・アタッチ先、スナップショット | ec2:DescribeVolumes / ec2:DescribeSnapshots | リージョン |
| AMI | ec2 | describe_images(Owners=["self"]) | 自分のアカウントで作ったAMI | ec2:DescribeImages | リージョン |
| VPC | ec2 | describe_vpcs / describe_subnets / describe_security_groups | VPC・サブネット・セキュリティグループのルール | ec2:DescribeVpcs など | リージョン |
| Elastic IP | ec2 | describe_addresses ★ | 割り当て済みのIPと関連付け先 | ec2:DescribeAddresses | リージョン |
| ELB | elbv2 | describe_load_balancers / describe_target_health ★ | ALB・NLB、ターゲットの正常性 | elasticloadbalancing:Describe* | リージョン |
| RDS | rds | describe_db_instances / describe_db_clusters | DBのクラス・エンジン・状態・マルチAZ・タグ | rds:DescribeDBInstances など | リージョン |
| DynamoDB | dynamodb | list_tables / describe_table ★ | テーブル名、キー構成・容量モード・項目数(概算) | dynamodb:ListTables / dynamodb:DescribeTable | リージョン |
| Lambda | lambda | list_functions / get_function ★ | ランタイム・メモリ・タイムアウト、状態(get_function) | lambda:ListFunctions / lambda:GetFunction | リージョン |
| ECS | ecs | list_clusters / list_services / describe_services ★ | クラスター・サービス・実行中のタスク数 | ecs:List* / ecs:DescribeServices | リージョン |
| S3 | s3 | list_buckets | バケット名・作成日時・リージョン | s3:ListAllMyBuckets | グローバル |
| S3(設定) | s3 | get_bucket_encryption / get_public_access_block ★ | 暗号化設定、パブリックアクセスのブロック設定 | s3:GetEncryptionConfiguration / s3:GetBucketPublicAccessBlock | バケットごと |
| Route 53 | route53 | list_hosted_zones / list_resource_record_sets | ホストゾーンとレコード | route53:ListHostedZones など | グローバル |
| ACM | acm | list_certificates | 証明書のドメイン・状態・有効期限・使用中か | acm:ListCertificates | リージョン |
| Systems Manager | ssm | describe_instance_information | SSM に登録されたEC2とエージェントの状態 | ssm:DescribeInstanceInformation | リージョン |
監視・ログ
| サービス | client | 主なAPI | 取れる情報 | IAMアクション | 範囲 |
|---|---|---|---|---|---|
| CloudWatch | cloudwatch | get_metric_data / list_metrics | メトリクスの値(PART 05) | cloudwatch:GetMetricData / cloudwatch:ListMetrics | リージョン |
| CloudWatch アラーム | cloudwatch | describe_alarms | アラームの状態・しきい値・通知先 | cloudwatch:DescribeAlarms | リージョン |
| CloudWatch Logs | logs | describe_log_groups | ロググループ・保持期間・保存サイズ | logs:DescribeLogGroups | リージョン |
| Logs Insights | logs | start_query → get_query_results ★ | ログの検索・集計(非同期) | logs:StartQuery / logs:GetQueryResults | リージョン |
コスト
| サービス | client | 主なAPI | 取れる情報 | IAMアクション | 範囲 |
|---|---|---|---|---|---|
| Cost Explorer | ce | get_cost_and_usage ★ / get_cost_forecast ★ | 期間・サービス・タグ別のコスト、着地予測(PART 05) | ce:GetCostAndUsage / ce:GetCostForecast | グローバル(us-east-1)・有料 |
| Budgets | budgets | describe_budgets | 予算額と実績・予測 | budgets:ViewBudget | グローバル |
セキュリティ・監査
| サービス | client | 主なAPI | 取れる情報 | IAMアクション | 範囲 |
|---|---|---|---|---|---|
| IAM | iam | list_users / list_roles / list_access_keys | ユーザー・ロール・アクセスキー | iam:ListUsers など | グローバル |
| IAM | iam | get_access_key_last_used ★ | アクセスキーの最終使用日時とサービス | iam:GetAccessKeyLastUsed | グローバル |
| IAM 認証情報レポート | iam | generate_credential_report → get_credential_report ★ | 全ユーザーのパスワード・MFA・キーの状況(CSV) | iam:GenerateCredentialReport / iam:GetCredentialReport | グローバル |
| CloudTrail | cloudtrail | lookup_events | 直近90日の管理イベント(誰が・いつ・何をしたか) | cloudtrail:LookupEvents | リージョン |
| Security Hub | securityhub | get_findings | セキュリティのチェック結果 | securityhub:GetFindings | リージョン |
| GuardDuty | guardduty | list_detectors / list_findings / get_findings ★ | 脅威の検出結果 | guardduty:ListFindings など | リージョン |
CloudTrail の lookup_events は、1アカウント・1リージョンあたり毎秒2回までという厳しい呼び出し制限がある。長い期間を何度も検索する用途には向かないので、その場合は S3 に保存した証跡を Athena で検索する。
構成・アカウント管理
| サービス | client | 主なAPI | 取れる情報 | IAMアクション | 範囲 |
|---|---|---|---|---|---|
| Organizations | organizations | list_accounts | 組織のアカウント一覧(PART 06) | organizations:ListAccounts | グローバル(管理アカウント等のみ) |
| タグ付けAPI | resourcegroupstaggingapi | get_resources | タグが付いた(付いていた)リソースのARNとタグ | tag:GetResources | リージョン |
| Resource Explorer | resource-explorer-2 | search | 全リージョンのリソースを横断検索 | resource-explorer-2:Search | 集約インデックスで全リージョン |
| AWS Config | config | select_resource_config | 記録された構成をSQL風に検索 | config:SelectResourceConfig | リージョン |
| Service Quotas | service-quotas | get_service_quota / list_service_quotas | 上限値(vCPU数など) | servicequotas:GetServiceQuota など | リージョン |
| Trusted Advisor | support | describe_trusted_advisor_checks ★ | コスト・セキュリティ等の推奨事項 | support:DescribeTrustedAdvisorChecks | us-east-1・ビジネス以上のサポートプランが必要 |
逆引き:こういうことを知りたい
ここからは「知りたいこと」から使うAPIを引けるようにまとめる。どれも session = boto3.Session(profile_name="dev", region_name="ap-northeast-1") を作ったあとに続けて書く想定で、全リージョンを回す場合は PART 03 の run_per_region に関数として渡せばよい。
| 知りたいこと | 使うAPI | コード |
|---|---|---|
| 停止したまま放置されているEC2 | ec2.describe_instances | → |
| どこにもアタッチされていないEBS・使われていないElastic IP | ec2.describe_volumes / describe_addresses | → |
| 90日以上使われていないアクセスキー | iam.list_access_keys / get_access_key_last_used | → |
| 保持期間が「無期限」のロググループ | logs.describe_log_groups | → |
| 30日以内に期限が切れる証明書 | acm.list_certificates | → |
| 今アラーム状態のもの | cloudwatch.describe_alarms | → |
| セキュリティグループを変更したのは誰か | cloudtrail.lookup_events | → |
| パブリックアクセスのブロックが未設定のバケット | s3.get_public_access_block | → |
| ポートフォワードに使えるEC2(SSM登録済み) | ssm.describe_instance_information | → |
| 先月のサービス別コスト・CPUが低いEC2 | ce / cloudwatch | PART 05 |
停止したまま放置されているEC2
停止中のインスタンスも、EBS の料金はかかり続ける。StateTransitionReason に停止した日時が文字列で入っているので、それを表示して古いものを探す。
import boto3
session = boto3.Session(profile_name="dev", region_name="ap-northeast-1")
ec2 = session.client("ec2")
stopped = [{"Name": "instance-state-name", "Values": ["stopped"]}]
for inst in ec2.get_paginator("describe_instances").paginate(Filters=stopped).search("Reservations[].Instances[]"):
name = next((t["Value"] for t in inst.get("Tags", []) if t["Key"] == "Name"), "")
# 例: "User initiated (2026-03-02 08:15:43 GMT)"
print(inst["InstanceId"], name, inst.get("StateTransitionReason", ""))アタッチされていないEBS・使われていないElastic IP
import boto3
session = boto3.Session(profile_name="dev", region_name="ap-northeast-1")
ec2 = session.client("ec2")
# 状態が available = どのインスタンスにもアタッチされていない
for vol in ec2.get_paginator("describe_volumes").paginate(
Filters=[{"Name": "status", "Values": ["available"]}]).search("Volumes[]"):
print("EBS", vol["VolumeId"], f'{vol["Size"]}GiB', vol["VolumeType"], vol["CreateTime"].date())
# AssociationId が無い = 何にも関連付けられていない(料金がかかる)
for addr in ec2.describe_addresses()["Addresses"]:
if "AssociationId" not in addr:
print("EIP", addr["PublicIp"], addr.get("AllocationId"))90日以上使われていないアクセスキー
IAM はグローバルなサービスなので、リージョンを回す必要はない。一度も使われていないキーは LastUsedDate が返らない。
from datetime import datetime, timedelta, timezone
import boto3
session = boto3.Session(profile_name="dev")
iam = session.client("iam")
limit = datetime.now(timezone.utc) - timedelta(days=90)
for user in iam.get_paginator("list_users").paginate().search("Users[]"):
for key in iam.list_access_keys(UserName=user["UserName"])["AccessKeyMetadata"]:
last = iam.get_access_key_last_used(AccessKeyId=key["AccessKeyId"])["AccessKeyLastUsed"]
used = last.get("LastUsedDate")
if used is None or used < limit:
print(user["UserName"], key["AccessKeyId"], key["Status"],
"作成", key["CreateDate"].date(), "最終使用", used.date() if used else "なし")ユーザーが多い場合は、generate_credential_report で認証情報レポート(全ユーザー分のCSV)を作ってから get_credential_report で受け取るほうが、呼び出し回数が少なく済む。
保持期間が「無期限」のロググループ
保持期間を設定していないロググループは、ログが永久に残り、保存料金がかかり続ける。retentionInDays キーが無いものが無期限だ。
import boto3
session = boto3.Session(profile_name="dev", region_name="ap-northeast-1")
logs = session.client("logs")
for g in logs.get_paginator("describe_log_groups").paginate().search("logGroups[]"):
if "retentionInDays" not in g:
print(f'{g.get("storedBytes", 0) / 1024**3:8.2f} GiB {g["logGroupName"]}')30日以内に期限が切れる証明書
ACM の証明書はリージョンごとに管理される。CloudFront で使う証明書は us-east-1 にあるので、そのリージョンも忘れずに確認する。
from datetime import datetime, timedelta, timezone
import boto3
limit = datetime.now(timezone.utc) + timedelta(days=30)
session = boto3.Session(profile_name="dev")
for region in ("ap-northeast-1", "us-east-1"):
acm = session.client("acm", region_name=region)
for c in acm.get_paginator("list_certificates").paginate().search("CertificateSummaryList[]"):
if c.get("NotAfter") and c["NotAfter"] < limit:
print(region, c["DomainName"], c["NotAfter"].date(), c.get("Type"), "使用中" if c.get("InUse") else "未使用")今アラーム状態のもの
import boto3
session = boto3.Session(profile_name="dev", region_name="ap-northeast-1")
cw = session.client("cloudwatch")
for a in cw.get_paginator("describe_alarms").paginate(StateValue="ALARM").search("MetricAlarms[]"):
print(a["StateUpdatedTimestamp"], a["AlarmName"], a["StateReason"][:80])セキュリティグループを変更したのは誰か
lookup_events で検索できる条件(LookupAttributes)は1つだけで、イベント名・ユーザー名・リソース名などから選ぶ。詳細は CloudTrailEvent に JSON 文字列で入っている。エラーコード(errorCode)では検索できないので、拒否された呼び出しを探すときは、取得したあとに JSON の中身で絞り込む。
import json
from datetime import datetime, timedelta, timezone
import boto3
session = boto3.Session(profile_name="dev", region_name="ap-northeast-1")
ct = session.client("cloudtrail")
start = datetime.now(timezone.utc) - timedelta(days=7)
pages = ct.get_paginator("lookup_events").paginate(
LookupAttributes=[{"AttributeKey": "EventName", "AttributeValue": "AuthorizeSecurityGroupIngress"}],
StartTime=start,
)
for ev in pages.search("Events[]"):
detail = json.loads(ev["CloudTrailEvent"])
who = detail["userIdentity"].get("arn", "")
sg = detail.get("requestParameters", {}).get("groupId", "")
print(ev["EventTime"], who, sg, detail.get("sourceIPAddress"), detail.get("errorCode", "成功"))パブリックアクセスのブロックが未設定のバケット
設定がないバケットでは、get_public_access_block が NoSuchPublicAccessBlockConfiguration というエラーを返す。エラーを「未設定」という情報として扱う例だ。なお、アカウント全体でブロックを設定している場合は、s3control の get_public_access_block(AccountId=...) で確認できる。
import boto3
from botocore.exceptions import ClientError
session = boto3.Session(profile_name="dev")
s3 = session.client("s3")
for b in s3.get_paginator("list_buckets").paginate().search("Buckets[]"):
try:
conf = s3.get_public_access_block(Bucket=b["Name"])["PublicAccessBlockConfiguration"]
status = "OK" if all(conf.values()) else f"一部のみ {conf}"
except ClientError as e:
code = e.response["Error"]["Code"]
status = "未設定" if code == "NoSuchPublicAccessBlockConfiguration" else code
print(f'{b["Name"]:50} {status}')ポートフォワードに使えるEC2(SSM登録済み)
ポートフォワード PART 02 で中継に使うEC2が、SSM に登録されてオンラインになっているかを確認する。CLI の aws ssm describe-instance-information と同じ情報だ。
import boto3
session = boto3.Session(profile_name="dev", region_name="ap-northeast-1")
ssm = session.client("ssm")
for n in ssm.get_paginator("describe_instance_information").paginate().search("InstanceInformationList[]"):
print(n["InstanceId"], n["PingStatus"], n.get("AgentVersion"), n.get("PlatformName"))サービスごとに回さず、まとめて取る方法
サービスの数が増えると、PART 04 のようにサービスごとのAPIを並べるのは大変になる。AWS には、リソースを横断して探すためのサービスが3つある。
| 方法 | 得意なこと | 事前の準備 | 注意点 |
|---|---|---|---|
タグ付けAPIresourcegroupstaggingapi.get_resources | タグでの横断検索(「Env=prod のリソースすべて」) | 不要 | リージョンごとに呼ぶ。タグが一度も付いたことのないリソースは返らない。返るのはARNとタグだけ |
Resource Explorerresource-explorer-2.search | 全リージョンを1回の検索で横断。キーワードやタグ、リソースの種類で絞れる | インデックスとビューの作成(集約インデックスを1リージョンに置く) | 反映に少し時間がかかる。詳細な設定値までは返らない |
AWS Configconfig.select_resource_config | 構成の詳細を SQL 風に検索(「暗号化されていない EBS」など)。変更履歴も追える | Config の記録を有効にする(記録量に応じて有料) | リージョンごと。全リージョン・全アカウントは集約(アグリゲーター)を使う |
import boto3
session = boto3.Session(profile_name="dev", region_name="ap-northeast-1")
tagging = session.client("resourcegroupstaggingapi")
pages = tagging.get_paginator("get_resources").paginate(TagFilters=[{"Key": "Env", "Values": ["prod"]}])
for res in pages.search("ResourceTagMappingList[]"):
print(res["ResourceARN"])import boto3
session = boto3.Session(profile_name="dev", region_name="ap-northeast-1")
config = session.client("config")
query = """
SELECT resourceId, configuration.size, configuration.volumeType
WHERE resourceType = 'AWS::EC2::Volume' AND configuration.encrypted = false
"""
for page in config.get_paginator("select_resource_config").paginate(Expression=query):
for line in page["Results"]: # 1件ずつ JSON 文字列で返る
print(line)使い分けの目安は、「何があるか」をざっと知りたいなら Resource Explorer、「設定が規則どおりか」を確かめたいなら AWS Config、細かい項目を自由に表にしたいなら PART 04 のようにサービスごとのAPIだ。
なお、サービスごとの API の呼び分けやページネーション、リージョン・アカウントのループそのものを肩代わりさせる方法として、AWS の API を SQL のテーブルとして問い合わせる Steampipe もある。この記事と同じお題を SQL で書いた逆引きを Steampipe シリーズの付録にまとめたので、比べてみてほしい。
シリーズのまとめ
| やりたいこと | ポイント | 記事 |
|---|---|---|
| 仕組みとレスポンスの読み方を知る | client に統一、dict の入れ子と欠けるキーに注意 | PART 01 |
| 接続を確認する | 環境変数の残りに注意、get_caller_identity で確認 | PART 02 |
| 漏れなく・止まらずに取る | Paginator、Filters、ClientError、standard リトライ | PART 03 |
| 全リージョンの棚卸し | 共通の列にそろえて CSV / Excel | PART 04 |
| 使用率とコストを見る | get_metric_data でまとめて取得、Cost Explorer は有料なのでキャッシュ | PART 05 |
| 複数アカウント・エラー対処 | assume_role、手前から順に切り分け | PART 06 |
情報取得のスクリプトは、権限を読み取り専用に絞っておけば環境を壊す心配がなく、失敗しても何度でもやり直せる。まずは PART 04 の棚卸しを自分のアカウントで動かし、見覚えのないリソースがないか確かめるところから始めてみてほしい。