変更¶
POST /api/v1/pipeline/{pl_uuid}/modify
概要¶
Pipeline 設定を全体変更し、履歴を保持します。
呼び出し前の確認と使用手順¶
まず詳細を読み取ってバックアップし、現在の configVersion と書き込み可能なすべてのフィールドを指定して送信します。このエンドポイントは全体を置換します。source、extend、asDefault、enableByLogBackup、testData、dataType を省略すると、空配列/オブジェクト、0、空文字列、line_protocol などのデフォルトになります。元の status は保持されます。実際の設定変更がある場合のみ元のバージョンをアーカイブしてインクリメントします。完全に同一の保存では新しいバージョンを作成しません。modify レスポンスの source はリレーション更新差分の要約にすぎず、削除されたソースを含み、保持された共通部分が漏れる可能性があります。再度 get した最終的な source の代わりには使用できません。
デフォルト競合時はまず HTTP 200 かつ content.confirm が空でない状態で返され、正常なエンティティはありません。手動確認後に同じ設定で isForce=true として再試行します。強制置換では元のデフォルトを非デフォルトに変更し、そのバージョンをアーカイブします。
保存時は同期的に構文を検証し、設定/バージョンを更新します。実際の収集または中央処理での有効化は、後続の設定取得とデータフローに依存します。履歴データは再実行せず、解析サンプル結果も返しません。変更前に詳細をバックアップし、エラー/タイムアウト後はまず現在のバージョンを読み戻してから再試行してください。
ルートパラメータ¶
| パラメータ名 | 型 | 必須 | 説明 |
|---|---|---|---|
| pl_uuid | string | Y | 現在のワークスペースの Pipeline UUID。履歴 UUID、名前、数値 id とは異なります。 例: pl_example取得または入力方法: Pipeline 一覧から uuid を取得します。 |
リクエストヘッダー¶
| パラメータ名 | 型 | 必須 | 説明 |
|---|---|---|---|
| DF-API-KEY | string | Y | ワークスペースの OpenAPI 認証情報。 例: <DF-API-KEY>取得または入力方法: 対象ワークスペースの API Key 管理から、この操作権限を持つ OpenAPI Key を取得します。 |
Body リクエストパラメータ¶
| パラメータ名 | 型 | 必須 | 説明 |
|---|---|---|---|
| source[*] | string | 空でない文字列を推奨。配列は項目ごとの厳密な検証を行わない。無関係なデータドメインを混在させないでください。 例: nginx取得または入力方法: 単一の実際のソース識別子、または収集側がサポートするワイルドカードパターン。 |
|
| extend.appID[*] | string | 空でない文字列を推奨。 例: appid_example取得または入力方法: アプリケーション設定から単一の appId を取得します。 |
|
| extend.measurement[*] | string | 空でない文字列を推奨。 例: view取得または入力方法: 実際の measurement の元の名前。 |
|
| asDefault | int | 任意、デフォルト 0。0/1 のみを指定することを推奨。既存のデフォルトがあり isForce 未指定の場合、HTTP 200 で confirm 配列を返し、今回の対象設定は保存されないため、作成/変更成功として扱わないでください。 null を許可: False 例: 0取得または入力方法: 同一 category/type のフォールバックルールとして使用する場合は 1、それ以外は 0。 |
|
| category | string | Y | 必須。lineage/logging/object/custom_object/network/tracing/rum/llm/agent_monitor/security/keyevent/metric/profiling/dialtesting/cloud_billing。billing は履歴互換値。変更時にカテゴリを変更可能だが、スクリプト、source、extend を合わせて確認する必要があります。 空文字列を許可: False null を許可: False 選択可能な値: ['lineage', 'logging', 'object', 'custom_object', 'network', 'tracing', 'rum', 'llm', 'agent_monitor', 'security', 'keyevent', 'metric', 'profiling', 'dialtesting', 'billing', 'cloud_billing', 'keyevent'] 例: logging取得または入力方法: 対象データドメインと収集設定に応じて選択します。 |
| configVersion | integer | 変更時は任意だが、1 以上の整数を渡すことを強く推奨。履歴復元時は現在のバージョンが必須。対象の履歴バージョンではありません。現在の値と一致しない場合は HTTP 409 を返すため、再読み取りして変更をマージしてから再送信してください。 null を許可: False $minValue: 1 例: 1取得または入力方法: 現在の詳細の content.configVersion、または履歴の初期画面 currentPipelineInfo.configVersion から取得します。 |
|
| content | string | Y | 必須の base64 文字列。新規追加時はデコード後に空でないこと。デコード後のスクリプト全体が UI 文字数 ≤1048576 と UTF-8 バイト数 ≤1048576 の両方を満たす必要があります。BMP の非 ASCII は 2、補助文字は 4 としてカウントします。いずれかが上限を超えると ft.ContextExceedLimit になります。保存時はサンプルなしで同期コンパイルを実行し、同一カテゴリで有効なスクリプト参照を確認します。成功は実データでのデバッグ通過や有効化を意味しません。 null を許可: False 例: YWRkX2tleSgiZW52IiwgInByb2R1Y3Rpb24iKQ==取得または入力方法: まず UTF-8 の Pipeline スクリプトを書き、その後標準 base64 エンコードを行います。例はデコードすると add_key("env", "production") になります。 |
| dataType | string | 任意、デフォルトは line_protocol。line_protocol/json/message をサポート。変更時に省略すると line_protocol に戻る。category ではありません。空文字列は互換性が宣言されているが、サポートされる値を明示的に選択すべきです。 空文字列を許可: True null を許可: False 選択可能な値: ['line_protocol', 'json', 'message'] 例: json取得または入力方法: testData のサンプルとスクリプト入力に応じて選択します。 |
|
| enableByLogBackup | int | 任意、デフォルト 0。0/1 を推奨。保存フラグは既存の転送データが自動再実行されることを保証しません。 null を許可: False 例: 0取得または入力方法: ルールで転送データを処理する必要がある場合は 1。実際のデータ転送チェーンでサポートを確認してください。 |
|
| extend | json | 任意、デフォルト {}。変更時は全体を置換し、マージしない。rum/llm は appID×measurement の組み合わせでソース関係を生成する。未知のサブフィールドは公開検証で拒否される。 null を許可: False 例: {"loggingIndex": "default"}取得または入力方法: カテゴリと既存の詳細に応じて、以下の宣言フィールドを構成します。 |
|
| extend.aiTargetStructure | string | 任意の文字列。保存して返却するのみ。本インターフェースはスクリプトを生成しない。 空文字列を許可: True null を許可: True 例: 取得または入力方法: AI 生成時の対象構造の説明。不要な場合は省略可能。 |
|
| extend.appID | array | rum/llm では measurement と同時に空でない配列を提供する必要がある。両方とも空の場合は専用ソースなしとできる。appID があり measurement がない場合はパラメータ不足エラーになる。 null を許可: True 例: ["appid_example"]取得または入力方法: 対応する RUM/LLM アプリケーション管理から実際の appId を取得します。 |
|
| extend.exampleSource | string | 任意の返却用。source の関連付けを代替しない。 空文字列を許可: True null を許可: True 例: nginx取得または入力方法: サンプルソースの表示値。実際の source と対応させる必要があります。 |
|
| extend.exampleType | string | 任意の返却用文字列。サーバー側で固定の列挙型は提供されない。 空文字列を許可: True null を許可: True 例: custom取得または入力方法: サンプルタイプの表示値。クライアントの業務で定義されます。 |
|
| extend.ifAiCreate | boolean | 任意の返却用。AI タスクをトリガーしない。 null を許可: True 例: false取得または入力方法: AI 支援で生成されたかどうかを記録する。このマーカーが不要な場合は省略可能。 |
|
| extend.loggingIndex | string | 任意のログインデックス返却用フィールド。デフォルトでは値を補完せず、変更時に省略すると extend とともにクリアされる。source 配列ではない。 null を許可: True 例: default取得または入力方法: ログインデックス一覧から適用可能なインデックス識別子を取得します。 |
|
| extend.measurement | array | rum/llm では appID と直積の組み合わせを作成する。measurement があり appID がない場合はパラメータ不足エラーになる。保存時に各アプリ/measurement にデータが存在することは検証しない。 null を許可: True 例: ["view"]取得または入力方法: そのアプリの実際のデータの measurement(RUM の view/action など)から取得し、実際のカテゴリに応じて入力します。 |
|
| isForce | boolean | 任意、デフォルト false。デフォルト競合の確認のみに使用し、構文、ソース、名前、バージョンなどの検証をスキップできない。強制置換では元のデフォルトを非デフォルトに変更し、そのバージョンをアーカイブする。 null を許可: False 例: false取得または入力方法: content.confirm を受信した後、元のデフォルト Pipeline の置換を確認してから true を設定します。 |
|
| name | string | Y | 必須。最大 256 カウント単位(ASCII/半角カタカナは 1、その他の文字は 2)。英数字、アンダースコア、中国語 U+4e00..9fa5、およびハイフンを許可。空でないことを推奨。同一 category では重複不可。local/central が異なる場合や旧項目が無効な場合でも同様。入力ログの source ではありません。 null を許可: False 最大長: 256 $notSearchRegExp: [^a-zA-Z0-9_\u4e00-\u9fa5-]+ 例: production_parser取得または入力方法: 業務で定義するファイル名。まず Pipeline 一覧で同一カテゴリの未削除名を確認します。 |
| source | array | 任意、デフォルト []。変更時に省略するとすべてのソース関係が削除される。* または ? を含むソースは厳密な一意性競合チェックの対象外であり、すべての一致が実行時に動作することを保証しない。通常の厳密なソースは、同一 category/type 内で他の未削除 Pipeline が占有できない。rum/llm の新規追加/変更ではこの配列を無視し、extend.appID と measurement を使用する。 null を許可: False 例: ["nginx"]取得または入力方法: 対応する収集データの source またはソースセレクターから値を取得する。Pipeline 名ではない。ログの場合は実際のログ source を参考にできます。 |
|
| testData | string | 宣言上は任意だが、新規追加時に省略すると controller が None をデコードして InvalidBase64 を返す場合があるため、常に W10= または空文字列を明示的に指定する必要がある。変更時に省略すると空文字列に戻る。公開 add/modify は空文字列、または厳密な base64 デコード後に空/JSON 配列となるもののみを受け付け、単一オブジェクトを直接エンコードすることはできない。配列メンバーは文字列またはオブジェクトを推奨。数値/null は履歴の項目別長さ検証で 500 を引き起こす可能性がある。各項目の履歴制限は約 20480(オブジェクトはシリアライズ後のオブジェクトメモリサイズ、文字列は履歴の重み付き長さ)であり、スクリプトの 1MiB 上限ではない。 空文字列を許可: True null を許可: False 例: W3sibWVzc2FnZSI6ImV4YW1wbGUgbG9nIn1d取得または入力方法: まずサンプル配列を JSON にシリアライズし、その後 UTF-8 エンコードして base64 にする。空配列 [] は W10=。 |
|
| type | string | Y | 必須。local/central。Synthetic テスト dialtesting の新規追加/変更は central のみ。ワークスペースのバージョンによって central が制限される場合がある。変更すると元の実行タイプが置換される。 null を許可: False 選択可能な値: ['local', 'central'] 例: local取得または入力方法: ローカルコレクターで処理する場合は local、プラットフォームの中央処理で処理する場合は central を選択し、実際のデータ入口を確認します。 |
パラメータ補足説明¶
同時変更保護¶
まず /api/v1/pipeline/<pl_uuid>/get を呼び出して現在の設定と configVersion を読み取り、既存の変更パラメータに configVersion を加えて送信することを推奨します。本インターフェースは configVersion のみを送信する部分更新インターフェースではないため、name、type、category、content などの必須パラメータは契約に従って提供する必要があります。
configVersion は任意の正の整数。送信しない場合は旧来の呼び出しと互換だが、バージョン番号の競合チェックは有効にならない。バージョンが一致し、設定に実際の変更がある場合は、旧設定をアーカイブして新しい設定バージョンを返す。同一設定の重複保存ではバージョンを生成しない。409 / ft.PipelineConfigVersionConflict を受信した場合は、設定を再読み取りして比較し、確認してから送信する必要があり、他者の変更を自動的に上書きしてはならない。
リクエストボディの例:{"name":"demo","type":"local","category":"logging","content":"YWRkX2tleShjaXR5LCAic2hhbmdoYWkiKQ==","testData":"W10=","source":["nginx"],"configVersion":3}。
レスポンスと再試行¶
成功レスポンスの content は現在の Pipeline オブジェクトであり、configVersion、configVersionAt、configVersionOperator、configVersionSource、configVersionAction、configVersionSourceInfo を含みます。時刻は Unix 秒単位のタイムスタンプです。content が {"confirm":["logging"]} の場合、デフォルト置換の確認が必要であり、今回の変更はまだ完了していません。isForce はデフォルト置換のみに使用し、名前/source またはバージョン競合の検証をスキップしません。
content と testData のリクエストフィールドはどちらも Base64 エンコードです。通常の OpenAPI 変更では、testData のデコード後が空または JSON 配列であるという制約が維持されます。タイムアウト後はまず現在の設定を照会して書き込み結果を確認し、無条件の重複送信を避けてください。
リクエスト例¶
curl --request POST 'https://openapi.guance.com/api/v1/pipeline/pl_example/modify' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json' \
--data-raw '{"name":"production_parser","type":"local","category":"logging","content":"YWRkX2tleSgiZW52IiwgInByb2R1Y3Rpb24iKQ==","testData":"W3sibWVzc2FnZSI6ImV4YW1wbGUgbG9nIn1d","dataType":"json","asDefault":0,"enableByLogBackup":0,"extend":{"loggingIndex":"default"},"source":["nginx"],"configVersion":1}'
レスポンス¶
HTTP 200、application/json。以下の例は直接読み取れる主要フィールドを示します。
| フィールド | 型 | 説明 |
|---|---|---|
| content.id | integer | データベース番号。操作には uuid を使用する。 |
| content.uuid | string | pl_ オブジェクトの UUID。 |
| content.workspaceUUID | string | 所属ワークスペース。システムテンプレートの場合は空文字列。 |
| content.isSysTemplate | string / integer / boolean | システムテンプレートかどうか。エンティティでは Text 列であり、文字列のマーカーを返す場合がある。実際のマーカーで解析し、文字列が空でないかだけで直接判断しないでください。 |
| content.isCustomSysTemp | integer または boolean | カスタムシステムテンプレートかどうか。 |
| content.language | string | テンプレート/設定の言語。空文字列の場合がある。 |
| content.status | integer | 0 有効、2 無効、3 削除。 |
| content.creator | string | 作成者。 |
| content.updator | string | 最終更新者。 |
| content.createAt | integer | 作成日時の Unix 秒。 |
| content.updateAt | integer | 更新日時の Unix 秒。 |
| content.deleteAt | integer | 削除日時の Unix 秒。未削除の場合は -1。 |
| content.name | string | 保存設定:必須。最大 256 カウント単位(ASCII/半角カタカナは 1、その他の文字は 2)。英数字、アンダースコア、中国語 U+4e00..9fa5、およびハイフンを許可。空でないことを推奨。同一 category では重複不可。local/central が異なる場合や旧項目が無効な場合でも同様。入力ログの source ではありません。 |
| content.type | string | 保存設定:必須。local/central。Synthetic テスト dialtesting の新規追加/変更は central のみ。ワークスペースのバージョンによって central が制限される場合がある。変更すると元の実行タイプが置換される。 |
| content.category | string | 保存設定:必須。lineage/logging/object/custom_object/network/tracing/rum/llm/agent_monitor/security/keyevent/metric/profiling/dialtesting/cloud_billing。billing は履歴互換値。変更時にカテゴリを変更可能だが、スクリプト、source、extend を合わせて確認する必要があります。 |
| content.source | array | 保存設定:任意、デフォルト []。変更時に省略するとすべてのソース関係が削除される。* または ? を含むソースは厳密な一意性競合チェックの対象外であり、すべての一致が実行時に動作することを保証しない。通常の厳密なソースは、同一 category/type 内で他の未削除 Pipeline が占有できない。rum/llm の新規追加/変更ではこの配列を無視し、extend.appID と measurement を使用する。 |
| content.source[] | string | 保存設定:空でない文字列を推奨。配列は項目ごとの厳密な検証を行わない。無関係なデータドメインを混在させないでください。 |
| content.content | string | 保存設定:必須の base64 文字列。新規追加時はデコード後に空でないこと。デコード後のスクリプト全体が UI 文字数 ≤1048576 と UTF-8 バイト数 ≤1048576 の両方を満たす必要があります。BMP の非 ASCII は 2、補助文字は 4 としてカウントします。いずれかが上限を超えると ft.ContextExceedLimit になります。保存時はサンプルなしで同期コンパイルを実行し、同一カテゴリで有効なスクリプト参照を確認します。成功は実データでのデバッグ通過や有効化を意味しません。 |
| content.testData | string | 保存設定:宣言上は任意だが、新規追加時に省略すると controller が None をデコードして InvalidBase64 を返す場合があるため、常に W10= または空文字列を明示的に指定する必要がある。変更時に省略すると空文字列に戻る。公開 add/modify は空文字列、または厳密な base64 デコード後に空/JSON 配列となるもののみを受け付け、単一オブジェクトを直接エンコードすることはできない。配列メンバーは文字列またはオブジェクトを推奨。数値/null は履歴の項目別長さ検証で 500 を引き起こす可能性がある。各項目の履歴制限は約 20480(オブジェクトはシリアライズ後のオブジェクトメモリサイズ、文字列は履歴の重み付き長さ)であり、スクリプトの 1MiB 上限ではない。 |
| content.dataType | string | 保存設定:任意、デフォルトは line_protocol。line_protocol/json/message をサポート。変更時に省略すると line_protocol に戻る。category ではありません。空文字列は互換性が宣言されているが、サポートされる値を明示的に選択すべきです。 |
| content.asDefault | integer | 保存設定:任意、デフォルト 0。0/1 のみを指定することを推奨。既存のデフォルトがあり isForce 未指定の場合、HTTP 200 で confirm 配列を返し、今回の対象設定は保存されないため、作成/変更成功として扱わないでください。 |
| content.enableByLogBackup | integer | 保存設定:任意、デフォルト 0。0/1 を推奨。保存フラグは既存の転送データが自動再実行されることを保証しません。 |
| content.extend | json | 保存設定:任意、デフォルト {}。変更時は全体を置換し、マージしない。rum/llm は appID×measurement の組み合わせでソース関係を生成する。未知のサブフィールドは公開検証で拒否される。 |
| content.extend.appID | array | 保存設定:rum/llm では measurement と同時に空でない配列を提供する必要がある。両方とも空の場合は専用ソースなしとできる。appID があり measurement がない場合はパラメータ不足エラーになる。 |
| content.extend.measurement | array | 保存設定:rum/llm では appID と直積の組み合わせを作成する。measurement があり appID がない場合はパラメータ不足エラーになる。保存時に各アプリ/measurement にデータが存在することは検証しない。 |
| content.extend.loggingIndex | string | 保存設定:任意のログインデックス返却用フィールド。デフォルトでは値を補完せず、変更時に省略すると extend とともにクリアされる。source 配列ではない。 |
| content.extend.ifAiCreate | boolean | 保存設定:任意の返却用。AI タスクをトリガーしない。 |
| content.extend.aiTargetStructure | string | 保存設定:任意の文字列。保存して返却するのみ。本インターフェースはスクリプトを生成しない。 |
| content.extend.exampleSource | string | 保存設定:任意の返却用。source の関連付けを代替しない。 |
| content.extend.exampleType | string | 保存設定:任意の返却用文字列。サーバー側で固定の列挙型は提供されない。 |
| content.extend.appID[] | string | 保存設定:空でない文字列を推奨。 |
| content.extend.measurement[] | string | 保存設定:空でない文字列を推奨。 |
| content.configVersion | integer | 現在の設定バージョン。初期値は 1。設定に実際の変更がある場合にインクリメントされる。有効/無効の切り替えは設定スナップショットのフィールドではない。 |
| content.configVersionAt | integer | この設定バージョンが有効になった記録時刻(Unix 秒)。 |
| content.configVersionOperator | string | このバージョンの操作者。 |
| content.configVersionSource | string | ソース。openapi/console/history/workspace_restore/legacy/system など。 |
| content.configVersionAction | string | create/modify/import/official_clone/current_clone/history_restore/history_clone/default_replace/baseline など。 |
| content.configVersionSourceInfo | object | ソースアクションの情報。ソースがない場合は {}。フィールドはアクションに応じて省略可能。 |
| content.configVersionSourceInfo.templateName | string | 公式クローンのソーステンプレート名。 |
| content.configVersionSourceInfo.pipelineUUID | string | ソース Pipeline UUID。 |
| content.configVersionSourceInfo.configVersion | integer | ソース設定のバージョン番号。 |
| content.configVersionSourceInfo.pipelineHistoryUUID | string | 履歴クローン/復元のソース履歴 UUID。 |
| content.configVersionSourceInfo.replacedByName | string | デフォルト置換をトリガーした新しいファイル名。 |
| content.configVersionSourceInfo.replacedByPipelineUUID | string | デフォルト置換をトリガーした Pipeline UUID。 |
| content.declaration | object | 共通宣言。 |
| content.confirm | array<string> |
デフォルト競合時に通常のエンティティの代わりに返され、置換確認が必要なカテゴリを列挙する。この分岐では今回の対象は保存されていない。 |
| content.confirm[] | string | 単一のカテゴリ。 |
| content.pl_errors | array<object> |
ft.PipelineSyntaxError エラー時の content でのみ返されるコンパイルエラー配列。 |
| content.pl_errors[].error | string | コンパイルエラーの説明。 |
| content.pl_errors[].pos_chain | array<object> |
参照/位置チェーン。 |
| content.pl_errors[].pos_chain[].file | string | ファイル名。 |
| content.pl_errors[].pos_chain[].ln | integer | 非負の位置インデックス。コンパイラによって定義される。元の値を保持して調査する。 |
| content.pl_errors[].pos_chain[].col | integer | 非負の位置インデックス。コンパイラによって定義される。元の値を保持して調査する。 |
| content.pl_errors[].pos_chain[].pos | integer | 非負の位置インデックス。コンパイラによって定義される。元の値を保持して調査する。 |
{
"code": 200,
"content": {
"id": 100,
"uuid": "pl_example",
"workspaceUUID": "wksp_example",
"name": "production_parser",
"type": "local",
"category": "logging",
"content": "YWRkX2tleSgiZW52IiwgInByb2R1Y3Rpb24iKQ==",
"testData": "W3sibWVzc2FnZSI6ImV4YW1wbGUgbG9nIn1d",
"dataType": "json",
"asDefault": 0,
"enableByLogBackup": 0,
"extend": {
"loggingIndex": "default"
},
"isSysTemplate": 0,
"isCustomSysTemp": 0,
"language": "",
"status": 0,
"creator": "wsak_example",
"updator": "wsak_example",
"createAt": 1785427200,
"updateAt": 1785427200,
"deleteAt": -1,
"configVersion": 2,
"configVersionAt": 1785427200,
"configVersionOperator": "wsak_example",
"configVersionSource": "openapi",
"configVersionAction": "modify",
"configVersionSourceInfo": {},
"source": [
"nginx"
],
"declaration": {}
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
デフォルト置換の確認待ち:
{
"code": 200,
"content": {
"confirm": [
"logging"
],
"declaration": {}
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
エラーレスポンス¶
認証、レート制限、共通リクエストエラーについては共通エラー定義を参照してください。
| HTTP ステータス | errorCode | 発生条件 | メッセージまたはレスポンス説明 | 対応方法 |
|---|---|---|---|---|
| 406 | ft.ParameterValidationFailed | リクエストフィールドの欠落、またはフィールド値が宣言された検証条件に違反 | パラメータ解析失敗 | パラメータの位置、フィールド名、型、値を確認してください。 |
| 400 | ft.RequestJsonFormatError | リクエスト JSON の構文が無効 | リクエスト JSON の形式エラー | content.reason、line、column に従って JSON を修正してください。 |
| 406 | ft.InvalidBase64 | スクリプト/テストサンプルがデコード可能な UTF-8 base64 ではない。新規追加時に testData を省略した場合も発生する可能性がある | 無効な base64 内容 | content と testData を完全に提供し、先に UTF-8 にしてから base64 にしてください。 |
| 406 | ft.ContextExceedLimit | スクリプトが UI 文字数または UTF-8 バイト数 1MiB を超えている、または add/modify の単一テストサンプルが履歴長を超えている | テキスト内容が制限を超えています。制限は{}文字です | スクリプト/単一サンプルを縮小し、message に示された単位を確認してください。 |
| 406 | ft.PipelineSyntaxError | 同期のサンプルなしコンパイルがスクリプトまたは参照の構文エラーを返した | Pipeline スクリプトの構文エラーです。エラー位置を確認してください | content.pl_errors の error と pos_chain に従って位置を特定して修正し、再試行してください。 |
| 400 | ft.PipelineNameExists | 同一ワークスペースの同一 category に未削除の同名スクリプトが存在する | 同名の Pipeline が既に存在します | 名前を変更するか、元の UUID を更新してください。 |
| 400 | ft.PipelineSourceExists | 同一 category/type で未削除のルールが同一の厳密な source を既に占有している | このタイプの Pipeline の source は既に存在します | ソースのバインドを確認し、適切なソースに変更してください。ワイルドカード項目はこのチェックの対象外です。 |
| 403 | ft.ForbiddenFreeEditionWorkspace | ワークスペースバージョンの Pipeline 実行タイプ制限でこの type が許可されていない | 無料プランのワークスペースはこの機能をサポートしていません。商用プランにアップグレードすると制限を解除できます | 管理者がワークスペースのバージョンとサポートされる実行方式を確認してください。 |
| 500 | ft.InternalServerError | 同期コンパイルサービスが利用不可/タイムアウト/形式異常(内部の PipelineValidationUnavailable が最終的に統一的にラップされる)、データベース、構造エラー、または送信後のフォーマット失敗 | 内部エラー | 後で再試行する前に現在の設定とバージョンを読み取り、保存済みかどうかを確認してください。継続的に失敗する場合は traceId を提供してください。 |
| 406 | ft.DialingPipelineOnlyCentral | dialtesting で local を選択 | Synthetic テスト Pipeline は central Pipeline 設定のみをサポートします | サポートされる central に変更し、ワークスペースのバージョンを確認してください。 |
| 406 | ft.MissingNeededParmeterAppID | rum/llm の appID と measurement の片方のみが提供されている | appID を指定する必要があります | 両方を同時に提供するか、両方とも空にしてください。変更時と新規追加時でエラーキーに履歴互換の差異があります。 |
| 404 | ft.NotFoundPipelineCfg | 本ワークスペースの Pipeline/履歴が存在しない、削除済み、またはその主設定が削除済み | 指定された Pipeline 設定が見つかりません | 現在の一覧/履歴一覧から UUID を再取得してください。 |
| 409 | ft.PipelineConfigVersionConflict | 送信された configVersion が現在の値と一致しない | Pipeline 設定は更新されています。更新してから再試行してください | 最新バージョンを再取得して変更をマージしてください。 |
| 406 | ft.InvalidPipelineTestData | 公開 testData のデコード結果が JSON 配列ではない | 無効な Pipeline testData。base64 デコード後は空または JSON 配列である必要があります | 配列または空文字列を使用してください。 |