aws-support-case

AWS Support 案例管理器

概述

通过 CLI 管理 AWS Support 案例，并使用智能功能：创建案例时自动检测服务和类别、将中文翻译成英文后提交，以及以双语格式显示案例沟通内容（先显示英文原文，再显示中文翻译）。

前提条件

• 已配置默认配置文件的 AWS CLI
• 可访问 AWS Support API（某些功能需要 Business 或 Enterprise Support 计划）
• 所有命令都必须使用 --region us-east-1（Support API 仅在此区域提供）

核心工作流

1. 列出案例

列出最近 2 周的案例：

aws support describe-cases \
  --region us-east-1 \
  --after-time "$(date -u -v-14d '+%Y-%m-%dT%H:%M:%SZ' 2>/dev/null || date -u -d '14 days ago' '+%Y-%m-%dT%H:%M:%SZ')" \
  --include-resolved-cases \
  --output json

仅列出未解决的案例：

aws support describe-cases \
  --region us-east-1 \
  --no-include-resolved-cases \
  --output json

**显示格式：**以清晰的表格呈现案例，列包括：案例 ID | 主题 | 状态 | 创建时间 | 严重程度

2. 查看案例详情（双语显示）

查看包含沟通内容的案例：

aws support describe-communications \
  --region us-east-1 \
  --case-id "case-XXXXXXXX" \
  --output json

**双语显示格式：**显示案例沟通内容时，将每条消息格式化如下：

---
[Sender] | [Timestamp]
---

> Original English text line 1
> 中文翻译第一行

> Original English text line 2
> 中文翻译第二行

---

翻译指南：

• 逐句／逐段翻译，先显示英文原文，并在前面加上 > 前缀
• 中文翻译紧接着显示在下一行，并在前面加上 > 前缀
• 保留技术术语（服务名称、错误代码、ARN），不作翻译
• 两种语言都保持原有格式（项目符号、编号列表）

3. 创建新案例

步骤 1：查询可用的服务和类别

aws support describe-services --region us-east-1 --output json

步骤 2：自动检测服务和类别

分析用户的描述（中文或英文），识别：

• 服务代码：将关键词匹配到 AWS 服务（例如，“EC2实例” → amazon-ec2，“S3存储桶” → amazon-s3）
• 类别代码：匹配问题类型（例如，“性能慢” → performance，“无法连接” → connectivity，“配额提升” → limits）

步骤 3：翻译并创建

如果用户提供中文描述：

1. 翻译成专业、地道的英文
2. 适当使用 AWS 技术术语
3. 保留特定标识符（账户 ID、资源 ARN、错误代码），不作更改

aws support create-case \
  --region us-east-1 \
  --subject "Translated English subject" \
  --communication-body "Translated English description with full details" \
  --service-code "detected-service" \
  --category-code "detected-category" \
  --severity-code "low|normal|high|urgent|critical" \
  --language "en"

严重程度选择指南：

严重程度	适用情况
low	一般问题、非紧急咨询
normal	生产系统出现轻微问题
high	生产系统受到明显影响
urgent	生产系统受到严重影响
critical	生产系统宕机（仅限 Enterprise）

4. 回复案例

步骤 1：按需翻译

如果用户提供中文回复，将其翻译成专业英文，同时保留：

• 技术细节和标识符
• 具体错误消息或日志
• 资源名称和 ARN

步骤 2：发送回复

aws support add-communication-to-case \
  --region us-east-1 \
  --case-id "case-XXXXXXXX" \
  --communication-body "Translated English reply"

5. 处理附件

上传附件：

# First, base64 encode the file
BASE64_DATA=$(base64 -i /path/to/file)

# Add to attachment set
aws support add-attachments-to-set \
  --region us-east-1 \
  --attachments fileName="filename.ext",data="$BASE64_DATA"

这会返回一个 attachmentSetId，用于回复时：

aws support add-communication-to-case \
  --region us-east-1 \
  --case-id "case-XXXXXXXX" \
  --communication-body "Please see the attached file" \
  --attachment-set-id "ATTACHMENT_SET_ID"

下载附件：

aws support describe-attachment \
  --region us-east-1 \
  --attachment-id "attachment-id"

6. 关闭／解决案例

aws support resolve-case \
  --region us-east-1 \
  --case-id "case-XXXXXXXX"

服务检测关键词

关键词（中文／英文）	服务代码
EC2、实例、虚拟机	amazon-ec2
S3、存储桶、对象存储	amazon-s3
RDS、数据库、MySQL、PostgreSQL	amazon-rds
Lambda、函数、无服务器	aws-lambda
VPC、网络、子网、安全组	amazon-vpc
ECS、容器、Docker	amazon-ecs
EKS、Kubernetes、K8s	amazon-eks
CloudFront、CDN、分发	amazon-cloudfront
Route53、DNS、域名	amazon-route53
IAM、权限、角色、策略	aws-iam
账单、费用、billing	aws-billing
账户、账号、account	account-management

类别检测关键词

关键词（中文／英文）	类别代码
咨询、指导、如何、how to	general-guidance
慢、性能、延迟、performance、latency	performance
连接、访问、超时、connect、timeout	connectivity
安全、漏洞、security	security
配置、设置、configuration	configuration
限额、配额、提升、limit、quota	limits

资源

完整的 CLI 命令参考和其他选项，请参阅 references/aws-support-cli-reference.md。