Classmethod Claude Enterprise Compliance API Bigquery
Claude Enterprise Compliance API のアクティビティフィードをBigQueryに日次で自動収集する
- URL: https://dev.classmethod.jp/articles/claude-enterprise-compliance-api-activity-feed-bigquery-daily-sync/
- 日付: 2026-06-09
- Tier: Tier 3
- 要旨: Anthropic が 2026 年 5 月に正式リリースした Compliance API を Google Cloud（Cloud Scheduler → Cloud Run Functions → BigQuery）で日次収集するアーキテクチャの設計・実装解説。BigQuery のコスト特性（バッチ load 無料・90 日でロングタームストレージ）と Compliance API の 6 年保持期間の組み合わせで監査ログを安価に長期蓄積できる。
詳細
Compliance API の主要仕様
- Claude Enterprise プランのみ利用可能（公共部門を除く）
- ベース URL:
https://api.anthropic.com/v1/compliance/* - データ鮮度: イベント発生から 1 分以内にクエリ可能
- 保持期間: 6 年間
- レート制限: 600 req/min / 親組織
- 最大取得件数: 1 リクエストあたり 5,000 件、カーソル方式（
after_id/last_id）
取得できるイベント（一部）
- 認証:
sso_login_initiated,sso_login_succeeded,user_logged_out - ユーザー管理:
claude_user_settings_updated,org_iam_seat_tier_assignment_toggled - チャット:
claude_chat_created - API アクセス:
compliance_api_accessed
Google Cloud アーキテクチャ（Cloud Scheduler → Cloud Run Functions → BigQuery）
| コンポーネント | 役割 |
|---|---|
| Cloud Scheduler | 毎日 9:00 JST に OIDC トークン付き HTTP POST で起動 |
| Cloud Run Functions | Compliance API からページネーション取得し BigQuery にロード |
| Secret Manager | Compliance API キーを安全保管 |
| Cloud Storage | カーソル（last_id）を保存して途中失敗時に再開可能 |
| BigQuery | バッチ load ジョブ（無料）で追記 |
BigQuery スキーマ設計
- 型付きカラム（
id,type,created_at）+raw JSONカラムで新イベントタイプに対応 created_atでパーティション化、typeでクラスタリング → 特定期間・特定イベント種別クエリのコスト最小化
コスト上の優位点
- バッチ load ジョブは BigQuery 無料
- 90 日更新なしのパーティションは約 50% 引きのロングタームストレージへ自動移行
- 6 年保持の監査ログは 3 ヶ月超でほぼ全パーティションが自動的に安価なストレージへ
運用設計の注意点
- Cloud Scheduler の自動リトライは無効化（
retry_count = 0）: 二重起動による BigQuery への重複書き込み防止 - Cloud Run Functions のタイムアウトは最大 60 分（Gen1 の 9 分制限を回避するため Gen2 必須）