using-cloud-cli

クラウド CLI のパターン

認証情報は事前に設定されています。構文については、--help または Context7 を使用してください。

BigQuery

# Always estimate cost first
bq query --dry_run --use_legacy_sql=false 'SELECT ...'

# Run query
bq query --use_legacy_sql=false --format=json 'SELECT ...'

# List tables
bq ls project:dataset

# Get table schema
bq show --schema --format=json project:dataset.table

コストへの注意：スキャンしたバイト数に応じて課金されます。--dry_run を使用し、テーブルをパーティション分割して、列を指定してください。

GCP（gcloud）

# List resources
gcloud compute instances list --format=json

# Describe resource
gcloud compute instances describe INSTANCE --zone=ZONE --format=json

# Create with explicit project
gcloud compute instances create NAME --project=PROJECT --zone=ZONE

# Use --quiet for automation
gcloud compute instances delete NAME --quiet

AWS

# List resources
aws ec2 describe-instances --output json

# With JMESPath filtering
aws ec2 describe-instances --query 'Reservations[].Instances[].InstanceId' --output text

# Explicit region
aws s3 ls s3://bucket --region us-west-2

# Dry run where available
aws ec2 run-instances --dry-run ...

参考資料

• GCP.md - GCP のサービスパターンと一般的なコマンド
• AWS.md - AWS のサービスパターンと一般的なコマンド
• scripts/ - 一般的な操作に使うヘルパースクリプト

---

注意点

• gcloud auth login と gcloud auth application-default login では認証情報が異なります — ユーザーの環境では動作するスクリプトでも、CI では後者しかないため 401 エラーになることがあります。
• AWS CLI v1 と v2 では設定形式が異なります — 両方がインストールされている場合があります。aws --version で、デフォルトの aws バイナリのバージョンを確認できます。
• BigQuery のコスト見積もりには --dry_run が必要です — これを指定しないと、無料だと思って 100 ドルのクエリを実行してしまう可能性があります。必ず事前に見積もってください。
• 優先順位：AWS_PROFILE、--profile フラグ、AWS_ACCESS_KEY_ID の直接指定には、順序に依存する 3 者間の優先順位があり、ほとんど文書化されていません。
• --impersonate-service-account による gcloud のなりすましチェーンでは、各段階で IAM のトークン作成者権限が必要です — いずれかの段階で権限が不足すると、曖昧な「permission denied」メッセージとともに 403 が返されます。
• aws sts get-caller-identity は、実際にどの認証情報を使用しているかを確認する最も手軽な方法です — まず必ず確認してください。