このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版 を参照してください。以下のフラグは
difyctl の各コマンドで使用できます。-v と -h は共通で、-o と --http-retry はほとんどのコマンドで使用できますが、すべてではありません。コマンドが受け付けるフラグは、そのコマンドの リファレンス を確認してください。
| フラグ | 機能 |
|---|---|
-o, --output <format> | 出力形式を選択します：json、yaml、name、wide、text。 |
-v, --verbose | stderr に詳細な診断情報を出力します。 |
--http-retry <n> | 冪等リクエストのリトライ回数を設定します。 |
-h, --help | コマンドを実行せず、ヘルプを表示します。 |
フラグは常にコマンドの後に置きます。
difyctl get app -o json は動作しますが、difyctl -o json get app は不明なコマンドとして扱われます。出力形式
コマンドが 5 つの形式のうちどれをサポートするかは、その--help またはリファレンスページのフラグ表で確認します。フラグを繰り返した場合は、最後の値が優先されます。
-o は失敗時の表示も変えます。-o json では、エラーは機械可読な JSON オブジェクトとして stderr に出力されます。
各形式のスキーマ、デフォルト値、チャネルのルールについては、出力形式と終了コード を参照してください。
export studio-app では、-o は形式の指定ではなく出力ファイルのパスを表します。詳細モード
-v は stderr に詳細な HTTP ログを追加し、エラー出力に raw_response フィールド（bearer token をマスクしたサーバーの生レスポンス）を含めます。
リクエストが失敗し、通常のエラーでは原因がわからないときに使用します。
HTTP リトライ
difyctl は、一時的な障害が発生した冪等リクエスト（GET、PUT、DELETE）をリトライします。対象はネットワークエラーと、HTTP 408、413、500、502、503、504 のレスポンスです。POST リクエストはリトライされません。429（レート制限）は別途処理され、このリトライ回数には含まれず、終了コード 7 で終了します。
デフォルトのリトライ回数は 3 回で、指数バックオフ（300 ms から開始し、毎回 2 倍、上限 30 s）を行います。リトライを無効にするには --http-retry 0 を使用します。
DIFYCTL_HTTP_RETRY 環境変数も同じ回数を設定します。両方を設定した場合は、フラグが優先されます。