aws-infra-free

AWS Infra LITE

通过AWS CLI执行基础只读查询,覆盖资源清单和健康检查两大场景.

参数说明

环境要求

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux

依赖项

API Key 配置

需要配置对应API Key，详见上文环境配置章节

可用性分类

• 分类: MD+EXEC（）

API Key配置方式:

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

功能能力

1. 资源清单查询 (Inventory)

• EC2实例清单: 查询当前区域的EC2实例ID、状态、类型 aws ec2 describe-instances --query 'Reservations[].Instances[].[InstanceId,State.Name,InstanceType]' --output table
• S3存储桶列表: 列出账户下所有S3存储桶名称和创建时间 aws s3api list-buckets --query 'Buckets[].[Name,CreationDate]' --output table
• RDS数据库实例: 查询RDS实例标识符、引擎类型和运行状态 aws rds describe-db-instances --query 'DBInstances[].[DBInstanceIdentifier,Engine,DBInstanceStatus]' --output table

2. 健康检查 (Health)

• EC2状态检查: 获取实例系统状态检查和实例状态检查结果 aws ec2 describe-instance-status --include-all-instances --query 'InstanceStatuses[].[InstanceId,InstanceStatus.Status,SystemStatus.Status]' --output table
• CloudWatch告警: 列出所有处于ALARM状态的CloudWatch告警 aws cloudwatch describe-alarms --state-value ALARM --query 'MetricAlarms[].[AlarmName,StateValue,MetricName]' --output table

升级提示: 安全审计(IAM/安全组检查)、成本分析(Cost Explorer)、变更追踪(CloudTrail)等高级功能仅在aws-infra付费版中提供.

应用场景

不适用于: 需要安全审计、成本分析、变更追踪的场景(请使用付费版),需要创建/修改/删除AWS资源的操作

使用指南

1. 验证身份与权限

aws sts get-caller-identity
# 确认当前账户和用户,确保有足够的只读权限

2. 确定目标区域

# 查看当前默认区域
aws configure get region
# ...
# 如需切换区域
aws configure set region us-west-2

3. 执行资源查询

根据运维需求选择对应能力:

1. 盘点资源 → 执行Inventory类命令(如describe-instances)
2. 检查健康 → 执行Health类命令(如describe-instance-status)

4. 格式化输出

# 表格格式 (适合人类阅读)
--output table
# ...
# JSON格式 (适合程序处理)
--output json

案例展示

案例1: 日常运维巡检 (EC2健康检查)

场景: 运维人员需要快速检查所有EC2实例的运行状态

# 查询所有实例的状态检查结果
aws ec2 describe-instance-status --include-all-instances \
  --query 'InstanceStatuses[].Status,SystemStatus.Status,AvailabilityZone]' \
  --output table

预期输出:

------------------------------------------------------------------------------------
|                             DescribeInstanceStatus                               |
+----------------------+-------------------+-----------------+--------------------+
|  i-0abc123def456789  |  ok               |  ok             |  us-east-1a        |
|  i-0def456ghi789123  |  impaired         |  ok             |  us-east-1b        |
|  i-0ghi789jkl123456  |  ok               |  insufficient   |  us-east-1c        |
+----------------------+-------------------+-----------------+--------------------+

分析: i-0def456ghi789123的实例状态为impaired,需要进一步检查;i-0ghi789jkl123456的系统状态为insufficient,可能需要重启或联系AWS支持.

案例2: 资源盘点 (S3存储桶列表)

场景: 开发者需要确认账户下有哪些S3存储桶

aws s3api list-buckets --query 'Buckets[].[Name,CreationDate]' --output table

预期输出:

------------------------------------------------------------
|                     ListBuckets                          |
+---------------------------+-----------------------------+
|  my-app-uploads           |  2024-01-15T10:30:00.000Z  |
|  cloudfront-logs          |  2024-02-20T14:15:00.000Z  |
|  backup-data              |  2024-03-10T09:00:00.000Z  |
+---------------------------+-----------------------------+

异常恢复指南

疑问解答

Q1: 如何切换查询的AWS区域?

A: 通过--region参数或修改默认区域:

# 方式1: 单次查询指定区域
aws ec2 describe-instances --region us-west-2
# ...
# 方式2: 修改默认区域
aws configure set region us-west-2

Q2: 如何查询运行中的EC2实例?

A: 使用--filters参数过滤:

aws ec2 describe-instances --filters Name=instance-state-name,Values=running \
  --query 'Reservations[].Instances[].[InstanceId,InstanceType,LaunchTime]' --output table

Q3: 免费版和付费版有什么区别?

A: 免费版(LITE)包含资源清单查询和健康检查两大基础功能。付费版(AWS Infra Inspector)额外提供:

• 安全审计(IAM用户、安全组规则、S3存储桶策略检查)
• 成本分析(Cost Explorer按服务/区域分组成本查询)
• 变更追踪(CloudTrail事件查询、Config配置历史)
• 更多案例展示(3个完整案例 vs 2个基础案例)
• 更详细的异常处理(8种AWS特定错误 vs 5种基础错误)

能力边界说明

输入限制

• 输入数据格式: 输入数据必须符合AWS CLI的格式要求，包括正确的参数名称和值。
• 参数值范围: 参数值必须在AWS CLI允许的范围内，例如实例类型、状态值等。
• 查询深度: 对于某些查询，如EC2实例状态，只能查询当前实例的状态，不支持查询历史状态。

性能边界

• 查询频率: 由于AWS API的限流机制，频繁执行查询可能会导致请求被拒绝。
• 数据量: 对于大量资源的查询，如所有S3存储桶的列表，可能会返回大量数据，影响处理速度。

兼容性约束

• AWS CLI版本: 必须使用AWS CLI版本2.0.53或更高版本。
• 操作系统: 支持Windows、macOS和Linux操作系统。
• AWS区域: 默认查询当前配置的AWS区域，不支持跨区域查询。

功能限制

• 只读模式: 该技能仅支持只读查询，不支持创建、修改或删除AWS资源。
• 高级功能: 安全审计、成本分析和变更追踪等高级功能需要升级至付费版。

其他限制

• API调用限制: AWS API有调用频率限制，大量查询时需要间隔执行。
• 输出格式: 输出格式仅支持表格和JSON，不支持其他格式。

诊断与修复

安全注意

技术创新

问答精选

Q1: AWS免费版支持哪些输入格式？

A1: 通过AWS CLI执行。支持文本指令和结构化参数输入，具体格式参考使用流程章节。

Q2: 需要配置API Key吗？

A2: 是的，部分功能需要配置对应平台的API Key。请在依赖说明章节查看具体要求，并通过环境变量安全配置。

Q3: 命令行执行失败怎么办？

A3: 检查命令参数是否正确，确认运行环境支持exec能力。如遇权限问题，请参照错误处理章节排查。

效率指标

优势对比

AWS免费版通用排查步骤

1. 检查输入参数: 确认所有必填参数已提供且格式正确
2. 查看日志输出: 定位具体错误行和异常类型
3. 验证环境配置: 确认依赖库版本和运行环境满足要求
4. 逐步调试: 缩小问题范围,隔离故障模块

用户咨询

异常处置

针对AWS免费版使用中可能遇到的常见问题,提供以下排查方案: