aws-support-case

AWS Support ケースマネージャー

概要

CLI を通じて AWS Support ケースを管理します。ケース作成時のサービス／カテゴリの自動検出、送信時の中国語から英語への翻訳、ケースのやり取りのバイリンガル表示（英語の原文に続けて中国語訳を表示）などの機能を備えています。

前提条件

• AWS CLI がデフォルトプロファイルで設定されていること
• AWS Support API へのアクセス（機能によっては Business または Enterprise サポートプランが必要です）
• すべてのコマンドで --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 を参照してください。