用途:对百度智能云私有网络 VPC 相关网络资源做只读盘点与审计,输出资源清单、关联拓扑、采集覆盖率和异常引用报告,供人工复核与整改参考。
主要能力:查询 VPC、子网、路由表、安全组、企业安全组、ACL 与弹性网卡;按地域和 VPC 聚合资源;梳理关联拓扑;检查子网地址范围、可用 IP 余量与网段重叠;查找悬空、缺失或关联异常的资源;验证只读权限并报告查询覆盖率。
使用方式:先确认巡检地域,缺少地域时需先询问,不猜测也不扫描全部地域。凭证可通过环境变量 BCE_ACCESS_KEY_ID、BCE_SECRET_ACCESS_KEY 及使用 STS 时的 BCE_SESSION_TOKEN 提供,不要回显变量值;也可在 Skill 目录外建仅当前用户可读的 JSON 凭证文件,字段为 accessKeyId、secretAccessKey 和可选 sessionToken,chmod 600 后经 --credentials-file 指定,凭证值不得放入命令参数。运行采集脚本示例:python3 scripts/vpc_inventory_audit.py --regions bj,gz --output-dir /absolute/path/to/audit-output;使用受限凭证文件时加 --credentials-file;仅有导出 JSON 时用 --input 离线模式。输出 inventory.json 作原始快照、report.md 作可读报告,每条发现给出地域、VPC ID、资源 ID、规则编号和证据字段。本地自检:python3 scripts/vpc_inventory_audit.py --self-test,以及用 examples/sample-inventory.json 离线验证。
限制与边界:仅执行 HTTPS GET 及本地文件读取和报告生成,禁止 POST、PUT、PATCH、DELETE,禁止调用含 create、update、delete、bind、unbind、attach、detach、authorize、revoke、operate 的云 API 或 SDK 方法,账号权限更高也不放宽。仅输出发现、证据与人工建议,不实施整改。不写入或回显 AK、SK、STS Token。查询失败时结论标记为不完整,不把未查询到当作资源不存在;单地域核心 VPC 列表失败则标记该地域失败,不生成虚假空拓扑。401 检查凭证与系统时间,403 列出失败类型和所需只读策略并保留成功结果,404 核对地域 Endpoint 与 API 版本,429 或 5xx 允许相同 GET 请求退避重试。报告为空只能说在已成功查询范围内未发现问题。
适用场景:按地域盘点 VPC 网络资源、梳理拓扑关联、排查网段重叠与异常引用、验证只读盘点权限覆盖情况。其他细节暂未提供。