difyctl はエラーが発生すると、メッセージを stderr に書き込みます。-o json を有効にすると、エラーも単一行の JSON として出力され、安定した code フィールドと対処可能な hint が含まれます。
終了コードの完全な一覧表とエラーオブジェクトの構造については、出力形式と終了コード を参照してください。
バージョン互換性
version_skew(difyctl とサーバーのバージョンが一致しない)
difyctl は Dify の各リリースとともに提供され、特定のサーバーバージョンに対応しています。そのため、どちらか一方のバージョンが変わると、両者が一致しなくなることがあります。この状態は次の 2 つの形で現れ、いずれも終了コード 6 で終了します。
- Dify サーバーがアップグレードされた ため、既存の
difyctlが古くなっています。サーバーは HTTP426でリクエストを拒否し、アップグレードを促すメッセージを表示します。 difyctlがサーバーより新しい ため、リクエストを送信する前に停止し、サーバーがサポート対象より古いことを報告します。
-
バージョンの不一致であることを確認します。
Compatibility: incompatible …行、またはアップグレードを促すメッセージが表示されれば、バージョンの不一致です。 -
サーバーに合わせて
difyctlを再インストールします。DIFY_VERSIONにサーバーの Dify リリースタグを設定し(サーバーが最新リリースを実行している場合は省略できます)、インストールスクリプトを再実行します。詳しくは difyctl のインストール を参照してください。
6。
認証エラー
auth_expired
セッションが期限切れになり、difyctl は認証済みリクエストを実行できなくなりました。
-
再認証します。
- 失敗したコマンドを再実行します。
4。
not_logged_in
要求されたホストに対する有効なセッションがありません。
-
サインインします。
- 失敗したコマンドを再実行します。
4。
access_denied
サインインリクエストを拒否したか、承認前にキャンセルしたため、何も認可されていません。
再実行してリクエストを承認します。
4。
アプリエラー
アプリが見つからない(HTTP 404)
指定したアプリ ID が存在しないか、お使いの token ではアクセスできません。server_4xx_other として、HTTP ステータス 404 で表示されます。
-
アクセスできるアプリを一覧表示します。
- ID を確認して再実行します。
1。
サービス API が無効(サーバーから HTTP 403)
アプリは存在しますが、そのサービス API が Dify コンソールでオフになっています。アプリのオーナーが有効にする必要があります。403 はserver_4xx_other として表示されます。
終了コード:1。
アプリへのアクセスが許可されていない(HTTP 403、user_not_allowed_for_private_app)
アプリは存在し、そのサービス API も有効ですが、アクセスが制限されており、お使いの ID が許可リストに含まれていません。import studio-app で DSL からインポートしたアプリはデフォルトでプライベートになるため、インポート直後のアプリはアクセスが開放されるまでこのエラーを返します。
Dify コンソールで、そのアプリの Web アプリへのアクセスを公開に設定するか、管理者に依頼して許可メンバーに自分を追加してもらいます。その後、再実行します。
終了コード:1。
ワークフローエラー
ワークフローの検証エラー(HTTP 422)
Workflow アプリが入力を拒否しました。エラーメッセージには、不足している、または無効な必須入力が一覧表示されます。-
アプリの入力 schema を確認します。
-
--inputsの JSON を一致するように更新します。
1。
接続エラー
ホストに接続できない
コマンドが認証の前に失敗するか、difyctl version のサーバープローブがバージョンを読み取れません。ホストが誤っているか、デプロイが difyctl 接続を受け入れるように設定されていないかのいずれかです。
--hostがデプロイのコンソール API URL(CONSOLE_API_URL)であり、Web URL ではないことを確認します。- ホストが正しいのに
difyctlが接続できない場合は、管理者に依頼してデプロイ上でdifyctlアクセスを有効にしてもらいます。
1。