メインコンテンツまでスキップ
このページは機械翻訳であり、十分なレビューを経ていません。英語の原文が正となります。セキュリティ、プライバシー、データの取り扱い、コンプライアンス、ライセンスに関する記述は、技術レビューが完了するまで英語のまま掲載しています。 英語の原文を読む

Control Zero エラーコードリファレンス

Control Zero の SDK と CLI がユーザーに表示するすべてのエラーには、安定した E#### コードが付いています。各コードには、このサイトに専用のページがあります。エラーメッセージ内のコードをクリックすると、正式な対処方法のページに移動します。

SDK のコードは、共有のエラーカタログ（sdks/error-catalog/error_codes.yaml）で一度だけ定義されており、Python SDK と Node SDK で同じ意味を持ちます。

コードは領域ごとに整理されています。

範囲領域
E1000-E1099セキュリティとシークレット管理
E1100-E1199認証と登録
E1200-E1299ポリシーの読み込み / 検証 / バンドル
E1300-E1399キャッシュとローカルディスクのレイアウト
E1400-E1499ネットワークとリモートバックエンド
E1500-E1599承認ゲート、フックのサブプロセス、エージェントインテグレーション
E1600-E1699SDK ランタイム（guard / audit / close）
E1700-E1799HITL（ヒューマンインザループ）承認とシークレット
E2000-E2099認証情報の漏えい検知
E3000-E3299プラットフォームバックエンド（API / SSO）
E4000-E4099ガバナンスゲートウェイ

セキュリティとシークレット (E10xx)​

認証と登録 (E11xx)​

ポリシーの読み込み / 検証 / バンドル (E12xx)​

キャッシュとローカルディスクのレイアウト (E13xx)​

ネットワークとリモートバックエンド (E14xx)​

承認ゲートとフックのサブプロセス (E15xx)​

SDK ランタイム (E16xx)​

HITL 承認とシークレット (E17xx)​

承認（ヒューマンインザループ）フローは Beta であり、ホスト型（SaaS）プランを含むすべてのデプロイメントで利用できます。承認はデフォルトでオフで、管理者がスコープごとに有効にします。提供状況については承認ワークフローを、切り替え方法については承認のセットアップを参照してください。

認証情報の漏えい検知 (E20xx)​

プラットフォームバックエンド (E3xxx)​

Control Zero プラットフォーム API が、構造化されたエラー本文 { "error": { "code", "reason_code", "request_id", ... } } で返します。reason_code は安定した E#### です。エラーをログまで追跡できるように、サポートには request_id をお伝えください。

コード意味
E3000内部サーバーエラー
E3001リクエストの検証に失敗しました
E3002リソースが見つかりません
E3003権限がありません
E3004認証が必要、または認証に失敗しました
E3005レートまたは使用量の上限を超えました
E3006上流の依存先が利用できません
E3007状態の競合 / すでに存在します
E3008整合性 / テナント間の違反
E3009サービスを利用できません
E3010リクエストの形式が正しくありません
E3011CSRF トークンがない、または無効です
E3012リクエスト本文がサイズ上限を超えています
E3200この組織では SSO が設定されていません
E3201SSO は設定されていますが、無効です
E3202アイデンティティプロバイダーに到達できません
E3203SSO state missing, expired, or tampered
E3204SSO のトークン / アサーションが拒否されました
E3205ロールのマッピングがない、またはプランがそのロールを許可していません
E3206アカウントが停止中、または無効です

ガバナンスゲートウェイ (E4xxx)​

英語の原文 -- 翻訳は技術レビュー待ちです

Returned by the governance gateway. Enforcement-path failures fail closed: if the gateway cannot complete its policy / DLP / auth checks it denies the request rather than forwarding it.

コード意味
E4000ゲートウェイの内部エラー（適用経路以外）
E4001Governance evaluation failed; request denied (fail-closed)
E4002リクエストの形式が正しくありません
E4003レート制限を超えました
E4004認証が必要、または無効です
E4005ガバナンスゲートウェイが初期化されていません

見つけた新しいエラーを報告する​

controlzero doctor が報告したコードのページが見つからない場合、そのページはまだ公開されていません。github.com/controlzero/control_zero/issues で issue を作成し、エラーメッセージの全文と、controlzero env-dump の出力（--show-secrets は OFF のまま）を添えてください。