一覧の見方

各表の列は次の意味だ。「範囲」がリージョンのものは、全体を知るには PART 03 の方法で全リージョンを回す必要がある。

  • client:session.client("ここ") に渡す名前
  • 主なAPI:boto3 のメソッド名。★は Paginator がないもの
  • IAMアクション:最小権限のポリシーを書くときに使う名前(メソッド名と違うものは太字)
  • 範囲:リージョン単位か、アカウント全体(グローバル)か

メソッド名と必要なIAMアクションは、記事作成時点の boto3(1.43 系)とサービス認可リファレンスで確認している。サービスは頻繁に更新されるので、新しく使うときは公式のリファレンスもあわせて確認してほしい。

リソースの棚卸し

サービスclient主なAPI取れる情報IAMアクション範囲
EC2ec2describe_instancesインスタンスの種類・状態・IP・タグ・起動日時ec2:DescribeInstancesリージョン
EBSec2describe_volumes / describe_snapshotsボリュームのサイズ・種類・アタッチ先、スナップショットec2:DescribeVolumes / ec2:DescribeSnapshotsリージョン
AMIec2describe_images(Owners=["self"])自分のアカウントで作ったAMIec2:DescribeImagesリージョン
VPCec2describe_vpcs / describe_subnets / describe_security_groupsVPC・サブネット・セキュリティグループのルールec2:DescribeVpcs などリージョン
Elastic IPec2describe_addresses ★割り当て済みのIPと関連付け先ec2:DescribeAddressesリージョン
ELBelbv2describe_load_balancers / describe_target_health ★ALB・NLB、ターゲットの正常性elasticloadbalancing:Describe*リージョン
RDSrdsdescribe_db_instances / describe_db_clustersDBのクラス・エンジン・状態・マルチAZ・タグrds:DescribeDBInstances などリージョン
DynamoDBdynamodblist_tables / describe_table ★テーブル名、キー構成・容量モード・項目数(概算)dynamodb:ListTables / dynamodb:DescribeTableリージョン
Lambdalambdalist_functions / get_function ★ランタイム・メモリ・タイムアウト、状態(get_function)lambda:ListFunctions / lambda:GetFunctionリージョン
ECSecslist_clusters / list_services / describe_services ★クラスター・サービス・実行中のタスク数ecs:List* / ecs:DescribeServicesリージョン
S3s3list_bucketsバケット名・作成日時・リージョンs3:ListAllMyBucketsグローバル
S3(設定)s3get_bucket_encryption / get_public_access_block ★暗号化設定、パブリックアクセスのブロック設定s3:GetEncryptionConfiguration / s3:GetBucketPublicAccessBlockバケットごと
Route 53route53list_hosted_zones / list_resource_record_setsホストゾーンとレコードroute53:ListHostedZones などグローバル
ACMacmlist_certificates証明書のドメイン・状態・有効期限・使用中かacm:ListCertificatesリージョン
Systems Managerssmdescribe_instance_informationSSM に登録されたEC2とエージェントの状態ssm:DescribeInstanceInformationリージョン

監視・ログ

サービスclient主なAPI取れる情報IAMアクション範囲
CloudWatchcloudwatchget_metric_data / list_metricsメトリクスの値(PART 05)cloudwatch:GetMetricData / cloudwatch:ListMetricsリージョン
CloudWatch アラームcloudwatchdescribe_alarmsアラームの状態・しきい値・通知先cloudwatch:DescribeAlarmsリージョン
CloudWatch Logslogsdescribe_log_groupsロググループ・保持期間・保存サイズlogs:DescribeLogGroupsリージョン
Logs Insightslogsstart_query → get_query_results ★ログの検索・集計(非同期)logs:StartQuery / logs:GetQueryResultsリージョン

コスト

サービスclient主なAPI取れる情報IAMアクション範囲
Cost Explorerceget_cost_and_usage ★ / get_cost_forecast ★期間・サービス・タグ別のコスト、着地予測(PART 05)ce:GetCostAndUsage / ce:GetCostForecastグローバル(us-east-1)・有料
Budgetsbudgetsdescribe_budgets予算額と実績・予測budgets:ViewBudgetグローバル

セキュリティ・監査

サービスclient主なAPI取れる情報IAMアクション範囲
IAMiamlist_users / list_roles / list_access_keysユーザー・ロール・アクセスキーiam:ListUsers などグローバル
IAMiamget_access_key_last_used ★アクセスキーの最終使用日時とサービスiam:GetAccessKeyLastUsedグローバル
IAM 認証情報レポートiamgenerate_credential_report → get_credential_report ★全ユーザーのパスワード・MFA・キーの状況(CSV)iam:GenerateCredentialReport / iam:GetCredentialReportグローバル
CloudTrailcloudtraillookup_events直近90日の管理イベント(誰が・いつ・何をしたか)cloudtrail:LookupEventsリージョン
Security Hubsecurityhubget_findingsセキュリティのチェック結果securityhub:GetFindingsリージョン
GuardDutyguarddutylist_detectors / list_findings / get_findings ★脅威の検出結果guardduty:ListFindings などリージョン

CloudTrail の lookup_events は、1アカウント・1リージョンあたり毎秒2回までという厳しい呼び出し制限がある。長い期間を何度も検索する用途には向かないので、その場合は S3 に保存した証跡を Athena で検索する。

構成・アカウント管理

サービスclient主なAPI取れる情報IAMアクション範囲
Organizationsorganizationslist_accounts組織のアカウント一覧(PART 06)organizations:ListAccountsグローバル(管理アカウント等のみ)
タグ付けAPIresourcegroupstaggingapiget_resourcesタグが付いた(付いていた)リソースのARNとタグtag:GetResourcesリージョン
Resource Explorerresource-explorer-2search全リージョンのリソースを横断検索resource-explorer-2:Search集約インデックスで全リージョン
AWS Configconfigselect_resource_config記録された構成をSQL風に検索config:SelectResourceConfigリージョン
Service Quotasservice-quotasget_service_quota / list_service_quotas上限値(vCPU数など)servicequotas:GetServiceQuota などリージョン
Trusted Advisorsupportdescribe_trusted_advisor_checks ★コスト・セキュリティ等の推奨事項support:DescribeTrustedAdvisorChecksus-east-1・ビジネス以上のサポートプランが必要

逆引き:こういうことを知りたい

ここからは「知りたいこと」から使うAPIを引けるようにまとめる。どれも session = boto3.Session(profile_name="dev", region_name="ap-northeast-1") を作ったあとに続けて書く想定で、全リージョンを回す場合は PART 03 の run_per_region に関数として渡せばよい。

知りたいこと使うAPIコード
停止したまま放置されているEC2ec2.describe_instances→
どこにもアタッチされていないEBS・使われていないElastic IPec2.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が低いEC2ce / cloudwatchPART 05

停止したまま放置されているEC2

停止中のインスタンスも、EBS の料金はかかり続ける。StateTransitionReason に停止した日時が文字列で入っているので、それを表示して古いものを探す。

stopped_ec2.py
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

orphan_resources.py
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 が返らない。

stale_access_keys.py
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 キーが無いものが無期限だ。

log_retention.py
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 にあるので、そのリージョンも忘れずに確認する。

expiring_certs.py
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 "未使用")

今アラーム状態のもの

alarms.py
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 の中身で絞り込む。

who_changed_sg.py
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=...) で確認できる。

s3_public_block.py
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 と同じ情報だ。

ssm_nodes.py
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つある。

方法得意なこと事前の準備注意点
タグ付けAPI
resourcegroupstaggingapi.get_resources
タグでの横断検索(「Env=prod のリソースすべて」)不要リージョンごとに呼ぶ。タグが一度も付いたことのないリソースは返らない。返るのはARNとタグだけ
Resource Explorer
resource-explorer-2.search
全リージョンを1回の検索で横断。キーワードやタグ、リソースの種類で絞れるインデックスとビューの作成(集約インデックスを1リージョンに置く)反映に少し時間がかかる。詳細な設定値までは返らない
AWS Config
config.select_resource_config
構成の詳細を SQL 風に検索(「暗号化されていない EBS」など)。変更履歴も追えるConfig の記録を有効にする(記録量に応じて有料)リージョンごと。全リージョン・全アカウントは集約(アグリゲーター)を使う
tagging_api.py
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"])
config_query.py
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 / ExcelPART 04
使用率とコストを見るget_metric_data でまとめて取得、Cost Explorer は有料なのでキャッシュPART 05
複数アカウント・エラー対処assume_role、手前から順に切り分けPART 06

情報取得のスクリプトは、権限を読み取り専用に絞っておけば環境を壊す心配がなく、失敗しても何度でもやり直せる。まずは PART 04 の棚卸しを自分のアカウントで動かし、見覚えのないリソースがないか確かめるところから始めてみてほしい。

関連記事:ポートフォワード(プライベートなEC2・RDSへの接続)/アーキテクチャ > AWS > 監視