mirror of
https://github.com/langgenius/dify-docs.git
synced 2026-07-22 20:36:31 -04:00
Riskey
2f88f0f7d2
* docs: add Human Input file inputs and Service API to Cloud docs Port the Phase 2 Human Input docs (file inputs and the Service API integration flow) to the Cloud docs, mirroring the self-host pages. - human-input.mdx (en/zh/ja): add the Single File / File List field type and the file-handling notes; the upload-limit callout states Cloud's fixed limits (documents 15 MB, images 10 MB, audio 50 MB, video 100 MB, up to 10 files) instead of self-host env vars. - hitl-api-integration-flow.mdx (en/zh/ja): new; identical to self-host since the Service API is the same. - docs.json: nest the integration-flow under the Human Input group in all three navs. - zh/ja reuse the self-host translations; only the callout and the /self-host/ links changed. * docs: rewrite Cloud model providers around AI Credits * docs: rewrite Cloud subscription management for 1.15.0 * docs: update Cloud code node limits and XLSX image extraction note * docs: rewrite Cloud team members management for 1.15.0 * docs: apply the 1.15.0 Integrations redesign to Cloud docs * docs: fix workflow API reference for run-level logs and streaming * docs: sync self-host use-dify pages and fix translation debt * docs: align shared tutorials and quick start with 1.15.0 * docs: refine difyctl install examples and workspace reference * docs: rewrite hotkeys page to match current shortcuts * fix: correct broken anchor links for badged headings and tabs * fix: correct env link and Human Input resume identifier * feat: handle heading badges in link-checker slugs * fix: repoint publish-mcp cross-links to the merged MCP section * docs: rename plugin dev CLI to Dify Plugin CLI * docs: refine CLI reference readability and expand --agent * feat: stop format checkers flagging indented list-item content * fix: correct zh/ja custom-endpoint spacing and a list blank line * docs: clarify Cloud model provider install and AI Credits coverage
52 lines
3.9 KiB
Plaintext
52 lines
3.9 KiB
Plaintext
---
|
|
title: グローバルフラグ
|
|
description: これらのフラグを 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-がワークスペースを選択する仕組み) を参照してください。
|