エラーコード

CLI が 오류 [code] … の形式で出力するエラーコードの一覧です。プログラムでは code で処理し、message は表示用にのみ使用してください。

このページの基準ソースは cp/internal/public、cp/internal/core、node/internal/front、node/internal/agent の Go ソースです。ドキュメントのビルド時にそのソースから内容を生成します。

エラー応答の読み方

失敗した API 応答はすべて同じ構造を使用します。

{ "error": { "code": "database_required", "message": "먼저 데이터베이스를 생성하세요" } }

CLI はこの応答を 오류 [database_required] … の形式で出力し、終了コード 1 で終了します。自動化スクリプトでは code で分岐してください。message はユーザー向けの説明であるため、いつでも変更される可能性があります。

同じ code が状況によって複数の HTTP ステータスコードで返ることがあります。該当する場合はステータス列にすべて表示します。

오류 코드 목록 (76)

コード	HTTP ステータス	説明
`access_denied`	401	アクセス制御のバイパスシークレットが正しくありません。
`access_exchange_failed`	502	アクセス権限の確認を完了できませんでした。しばらくしてからもう一度お試しください。
`access_required`	401	このデプロイにはアクセス制御が設定されているため、ログインが必要です。
`access_unavailable`	503	アクセス権限を確認できなかったため、リクエストを処理しませんでした。
`already_member`	409	ユーザーはすでに組織のメンバーです。ロールは別のコマンドで変更してください。
`already_pro`	409	이미 프로 요금제다
`backend`	—	バックエンドサービスがリクエストを処理できませんでした。
`backup_failed`	503	データベースのバックアップ作成に失敗しました。
`bad_request`	400	リクエストの形式が正しくありません。
`bad_signature`	403	웹훅 서명이 맞지 않는다
`billing_off`	501	결제가 설정되지 않았다
`billing_unavailable`	502	결제 서비스가 응답하지 않는다
`bundle_too_large`	—	バンドルのサイズがアップロードの上限を超えました。
`cold`	503	コールド状態のプロジェクトをバックアップから復元しています。しばらくしてからもう一度お試しください。
`compatibility_date_unsupported`	400	compatibilityDate … はこのランタイムの最大値 … を超えています — runlot.json の値を … 以下に下げてください
`confirm_mismatch`	400	確認文字列がプロジェクト名と一致しません。
`cron_limit`	400	… プランでは組織あたり定期実行は … 個までです（現在 … 個、このデプロイが … 個を追加します）
`drain_incomplete`	503	既存のリクエストの処理が終わっていないため、安全に切り替えできません。
`email_failed`	503	…
`email_not_declared`	409	…
`email_rate_limited`	429	…
`export_failed`	502 · 503	データベース診断のエクスポートに失敗しました。
`forbidden`	403	認証済みのユーザーですが、この操作を実行する権限がありません。
`front_not_ready`	503	トラフィックフロントエンドの初期同期がまだ完了していません。
`front_unacked`	503	トラフィックフロントエンドが構成の変更を確認していません。
`git_unavailable`	503	リポジトリのブラウズが有効になっていません
`git_unreachable`	503	リポジトリを読み取れませんでした
`github_token`	502	GitHub トークンの交換に失敗しました。
`github_user`	502	GitHub のユーザー情報を取得できませんでした。
`grant_failed`	500	デプロイ権限の更新に失敗しました。
`hostname_taken`	409	このホスト名はすでに別のプロジェクトで使用されています。
`internal`	500	サーバー内部エラーが発生しました。しばらくしてからもう一度お試しください。
`invite_expired`	409	만료된 초대입니다 — 관리자에게 다시 보내 달라고 요청해 주세요
`invite_revoked`	409	취소된 초대입니다 — 관리자에게 다시 요청해 주세요
`invite_used`	409	이미 수락된 초대입니다
`last_admin`	409	組織の最後の管理者です。ロールを変更すると、組織を管理できるユーザーがいなくなります。
`no_core`	503	コントロールプレーンのコアサービスのアドレスが設定されていません。
`no_email`	501	このノードはメールを受信できません
`no_host`	400	リクエストに Host ヘッダーがありません。
`no_log_buffer`	503	管理者 API にログソースが設定されていません。
`no_placement`	503	プロジェクトがまだノードに配置されていません。
`no_ses_hook`	501	SES の webhook が無効です
`no_wake`	501	このノードはアイドル状態のプロジェクトを起動できません。
`no_writable_state`	501	このノードには、そのデータベース操作を実行できるストレージがありません。
`node_unreachable`	502	ノードに接続できません。しばらくしてからもう一度お試しください。
`not_a_member`	403	ユーザーはこの組織のメンバーではありません。
`not_found`	404	要求された組織、プロジェクトまたはデプロイが見つかりません。
`not_here`	404	要求されたプロジェクトはこのノードでは処理できません。
`not_pro`	409	프로 요금제가 아니다
`not_ready`	503	初期構成の同期がまだ完了していません。
`op_conflict`	409	同じ操作 ID が別の操作ですでに使用されています。
`op_in_flight`	503 · 409	同じ操作がすでに進行中です。
`org_slug_taken`	409	この組織 slug はすでに使用されています。
`project_name_taken`	409	このプロジェクト名はすでに使用されています。
`rate_limited`	—	リクエストの上限を超えました。しばらくしてからもう一度お試しください。
`repo_exists`	409	リポジトリ … はすでに存在します
`reserved_name`	400	予約された名前のため使用できません。
`restore_busy`	429	同時に処理できる復元作業の数を超えました。
`restore_failed`	500	データベースの復元に失敗しました。
`restore_stalled`	503	データベースの復元作業が中断されました。サポートまでお問い合わせください。
`restore_too_large`	429	復元作業がノードの復元容量の上限を超えました。
`restoring`	503	データベースを復元しています。完了後にもう一度お試しください。
`revoked`	403	この配置に対する権限が取り消されました。
`seal_failed`	503	データベースの最終世代の保存に失敗しました。
`ssh_key_exists`	409	すでに登録済みの公開鍵です
`suspended`	403 · 409	プロジェクトは一時停止されています。
`unauthorized`	401	トークンがないか期限切れです。`runlot login` をもう一度実行してください。
`unknown`	—	runlot サーバーではなく、中間プロキシなどが応答しました。
`unknown_hostname`	404	このノードでは、そのホスト名に接続されたプロジェクトが見つかりません。
`unknown_node`	503	プロジェクトのホームノードのアドレスを確認できませんでした。
`unknown_state`	503	認識できない配置状態です。
`unsupported`	—	現在のストレージバックエンドでは、この機能をサポートしていません。
`upstream_unreachable`	—	デプロイされたワーカーに接続できません。デプロイの状態を確認してください。
`user_not_found`	404	このアカウントでログインした記録がありません。まず一度ログインしてください。
`wake_failed`	503	アイドル状態のプロジェクトを起動できませんでした。
`workerd_unchecked`	503 · 500	ワーカーのコミット経路の状態を確認できませんでした。

本番サービスが返すエラー (55)

配置、復元、リース管理のような runlot 内部の処理が失敗すると、該当するエラーコードが返されます。多くはしばらくしてから再試行すると解決します。同じエラーが続く場合はサポートまでお問い合わせください。

コード	HTTP ステータス	説明
`already_done`	409	要求された作業はすでに完了しています。
`cas_conflict`	409	リソースの状態が変更されたため、リクエストを適用できません。最新の状態を確認してからもう一度お試しください。
`cert_generation`	403	リクエストに使用した証明書の世代が破棄されました。
`claimed`	409	別のインスタンスがこのデータベースを使用中です。しばらくしてからもう一度お試しください。
`cname_conflict`	409	同じ DNS 名に CNAME レコードと他の種類のレコードを同時に置くことはできません。
`database_required`	409	先にデータベースが必要です。`runlot.json` に `"database": true` を書いてデプロイしてください。
`db_rewound`	409	メタデータ DB が以前の状態に復元されたため、リースの発行を停止しました。運用者による復旧対応が必要です。
`dek_unwrap_failed`	500	プロジェクトデータの暗号化キーを復号できませんでした。
`dns_not_configured`	503	ネームサーバーの設定が完了していないため、ドメインを購入できません。
`dnssec_off`	409	ドメインゾーンの DNSSEC が無効になっています。先に有効化してください。
`domain_taken`	409	すでに登録されているドメインです。
`domain_unavailable`	409	登録できないドメインです。
`email_address_taken`	409	アドレス … は別のプロジェクトが使っています
`email_unavailable`	409	この環境にはメールドメインがありません (RUNLOT_MAIL_DOMAIN) — メールを有効にできません
`era_ahead`	409	リクエストの状態バージョン (era) が、コントロールプレーンに保存されたバージョンより高い値です。
`era_write_failed`	500	状態バージョン (era) を保存できませんでした。
`identity_mismatch`	403	証明書のホスト名とリクエスト本文のホスト名が一致しません。
`invalid_provider`	400	サポートしていない認証プロバイダーです。
`last_node_unavailable`	503	最終のデータベース世代を保持しているノードを利用できません。
`lease_alive`	409	既存のリースがまだ有効なため、リクエストを処理できません。
`lease_drain_pending`	409	既存のリースは終了処理中です。しばらくしてからもう一度お試しください。
`lease_quarantine`	409	リースが隔離状態のため、リクエストを処理できません。
`lease_seq_ahead`	409	リクエストのリース順序番号が、コントロールプレーンが認識している状態より先行しています。
`lifecycle_disabled`	503	ライフサイクル操作が無効になっています。
`managed_rrset`	409	runlot が管理する DNS レコードのため、直接編集できません。
`master_key_version`	503	現在のコントロールプレーンは、リクエストに必要なマスターキーのバージョンを保持していません。
`no_access_key`	503	アクセス制御クッキーを作成するためのキーが設定されていません。
`no_database`	409	このプロジェクトにはデータベースが接続されていません。
`no_home_node`	503 · 409	プロジェクトのホームノードのアドレスを確認できませんでした。
`no_last_node`	503	最終のデータベース世代を保持していたノードを確認できませんでした。
`no_master_key`	503	コントロールプレーンのマスターキーが設定されていません。
`no_node`	503	配置できるノードがありません。
`no_node_admin`	503	ノード管理者 API のアドレスが設定されていません。
`no_session_key`	503	ログインセッションの連携に必要なキーが設定されていません。
`no_slot`	503	利用可能な容量がありません。しばらくしてからもう一度お試しください。
`node_not_active`	409	このノードは現在、配置作業を実行できる状態ではありません。
`not_abortable`	409	作業が取り消せない段階に達したため、中断できません。
`not_active`	409	現在の状態では、この操作を実行できません。
`not_cold`	409	プロジェクトがコールド状態ではないため、再有効化の作業を開始できません。
`not_granted`	404	このプロジェクトには認証サービスが接続されていません。
`not_home`	403 · 409	このノードは、要求されたプロジェクト世代のホームノードではありません。
`not_quarantined`	409	リースが隔離状態ではないため、有効化できません。
`not_terminal`	409	作業がまだ終了状態ではありません。
`op_stalled`	409	作業が中断された状態です。原因を解決してから再度開始してください。
`payment_failed`	402	決済が承認されませんでした。お支払い方法をご確認ください。
`registrar_error`	502	ドメインレジストラがエラーを返しました。
`registrar_not_configured`	503	ドメインレジストラがまだ接続されていません。
`registrar_rejected`	422	この名前の以前の購入は拒否されました: …
`saga_incomplete`	502	ドメイン購入の作業が完了しませんでした。同じリクエストを再送すると、続きから処理します。
`stale_epoch`	409	以前のプロジェクト世代のリクエストです。最新の状態でもう一度お試しください。
`storage_unavailable`	409	このプロジェクトが配置されたノードにファイルストレージのバックエンドがありません — 運用者がノードにバックエンドを接続する必要があります
`too_large`	—	原文が … バイトを超えています
`user_rrset`	409	ユーザーが作成した DNS レコードのため、管理レコードで上書きできません。
`witness_unavailable`	503	メタデータ DB の状態を検証する witness 情報を読み取れなかったため、リースの発行や有効化を保留しました。
`zone_taken`	409	この DNS ゾーンはすでに存在します。

エラー応答の読み方

오류 코드 목록 (76)

本番サービスが返すエラー (55)

このページの目次