> ## Documentation Index
> Fetch the complete documentation index at: https://dify-6c0370d8-docs-new-agent-experience.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# グローバルフラグ

> これらのフラグを difyctl コマンド全体で使用し、出力形式、詳細度、リトライ動作を制御

> このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、[英語版](/en/cli/reference/global-flags) を参照してください。

以下のフラグは `difyctl` の各コマンドで使用できます。`-v` と `-h` は共通で、`-o` と `--http-retry` はほとんどのコマンドで使用できますが、すべてではありません。コマンドが受け付けるフラグは、そのコマンドの [リファレンス](/ja/cli/reference/command-index) を確認してください。

| フラグ                                    | 機能                                             |
| :------------------------------------- | :--------------------------------------------- |
| [`-o, --output <format>`](#出力形式)       | 出力形式を選択します：`json`、`yaml`、`name`、`wide`、`text`。 |
| [`-v, --verbose`](#詳細モード)              | stderr に詳細な診断情報を出力します。                         |
| [`--http-retry <n>`](#http-リトライ)       | 冪等リクエストのリトライ回数を設定します。                          |
| [`-h, --help`](/ja/cli/reference/help) | コマンドを実行せず、ヘルプを表示します。                           |

<Note>
  フラグは常にコマンドの後に置きます。`difyctl get app -o json` は動作しますが、`difyctl -o json get app` は不明なコマンドとして扱われます。
</Note>

## 出力形式

コマンドが 5 つの形式のうちどれをサポートするかは、その `--help` またはリファレンスページのフラグ表で確認します。フラグを繰り返した場合は、最後の値が優先されます。

`-o` は失敗時の表示も変えます。`-o json` では、エラーは機械可読な JSON オブジェクトとして stderr に出力されます。

各形式のスキーマ、デフォルト値、チャネルのルールについては、[出力形式と終了コード](/ja/cli/reference/output-formats-and-exit-codes) を参照してください。

<Note>
  [`export studio-app`](/ja/cli/reference/apps#アプリをエクスポート) では、`-o` は形式の指定ではなく出力ファイルのパスを表します。
</Note>

## 詳細モード

`-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`](/ja/cli/reference/environment-variables) 環境変数も同じ回数を設定します。両方を設定した場合は、フラグが優先されます。

## `--workspace` はグローバルではありません <Badge color="blue">Cloud</Badge>

`--workspace <id>` はコマンドごとに有効です。ワークスペースのデータを対象とするコマンドに現れ、その呼び出しにのみ適用されます。

このフラグが優先順位（フラグ、環境変数、保存されたデフォルト値）のどこに位置するかは、[difyctl がワークスペースを選択する仕組み](/ja/cli/reference/workspaces#difyctl-がワークスペースを選択する仕組み) を参照してください。