変更¶
POST /api/v1/objc_cfg/{objc_name}/modify
概要¶
リソースカタログの表示とレポート送信フィールド設定を更新または追加作成します。
呼び出し前と使用手順¶
本インターフェースでは、API Key に infrastructure.setManage 権限が必要です。
パス objc_name で実際の分類を特定し、sourceType でタイプを選択します。対象が存在しない場合はローカル設定を作成します。厳密に更新のみを行うわけではありません。templateInfo.main[0].source.key による名前変更はできません。templateInfo を省略した場合、ほとんどの表示フィールドは維持されますが、objcGroupUUID を省略すると空のグループになります。維持する場合は元の値を明示的に設定してください。
変更時は、外側またはテンプレートで実際に null 以外の fields が指定された場合にのみ、配列に name が含まれ、重複がないことを検証します。外側が優先されます。両方とも省略した場合、既存の対象は元のフィールドを維持します。対象が存在しない場合は fields=[] を追加作成し、name チェックは実行せず、下流のフィルタールールも更新しません。実際にフィールドを送信する場合は下流のレポート送信フィルターを同期します。必須フィールドが欠けているデータは破棄される可能性があるため、変更前に収集側と確認してください。object タイプの作成でも、送信後に custom_object フィルター同期を呼び出します。同名のカスタムオブジェクトカタログのレポート送信フィルターに影響する可能性があります。変更時に fields を渡した場合も同様に処理および同期されます。システム object を作成する前に、同名の custom_object とその必須フィールドを確認してください。システム object の表示のみを変更する場合は、fields(テンプレート内の fields を含む)を送信しないでください。
テンプレートで空でない main が指定された場合、source.name を省略すると別名がクリアされ、groups/fills を省略すると [] に設定されます。filters/columns/views を省略すると変更前の値が維持され、[] を指定するとクリアされます。アイコン設定は全体として保存されます。テンプレートの groupCfg.name でグループの作成を試行できますが、同名グループが既に存在する場合の互換分岐で 500 になる可能性があります。本ワークスペースの objcGroupUUID を明示的に設定することを推奨します。空文字列は明確にグループなしを意味します。
まずローカル設定を送信し、その後で下流のフィルターを同期します。同期に失敗すると 500 が返る可能性がありますが、ローカルには保存済みです。まず一覧/エクスポートで確認してから再試行してください。成功レスポンスは設定エンティティであり、ブラックリストや完全なテンプレートではありません。本ページでは収集データが送信済みであること/ページがレンダリング済みであることは確認しません。
ルートパラメータ¶
| パラメータ名 | 型 | 必須 | 説明 |
|---|---|---|---|
| objc_name | string | Y | 削除では Body 必須。パスによるエクスポート/変更では同じ分類名を使用し、名前はレポート送信 class と一致させ、パスを URL エンコードします。別名は表示のみを制御し、対象名としては使用しません。 例: example_resources取得または入力方法: リソースカタログ一覧 の content[].name から分類コードを取得します。objc_ 設定 UUID や alias ではありません。 |
リクエストヘッダー¶
| パラメータ名 | 型 | 必須 | 説明 |
|---|---|---|---|
| DF-API-KEY | string | Y | ワークスペースの OpenAPI 認証情報。 例: <DF-API-KEY>取得または入力方法: 対象ワークスペースの API Key 管理から、この操作権限を持つ OpenAPI Key を取得します。 |
リクエスト Body パラメータ¶
| パラメータ名 | 型 | 必須 | 説明 |
|---|---|---|---|
| fields[*] | json | 推奨オブジェクト。業務側は name を読み取ります。項目ごとの型検証は行わず、不正な形状の場合は整った業務エラーではなく 500 になる可能性があります。表示用の拡張フィールドを含めることができますが、サーバー側でその消費効果を一律に検証するわけではありません。 例: {"name": "name", "alias": "资源名称"}取得または入力方法: 実際のレポート送信フィールドを 1 つ定義します。 |
|
| fields[*].name | string | 空でないこと。^[a-zA-Z]+[0-9a-zA-Z_]+$ に一致します。先頭は英字、以降は数字/英字/_ で、最低 2 文字です。同じ配列内で重複できません。ドット、中国語、1 文字はサポートされません。 例: name取得または入力方法: フィールド名はレポート送信キーと完全に一致させ、少なくとも name を含めます。 |
|
| fields[*].alias | string | 省略可能な表示用拡張です。サーバー側で一律の厳格な検証は行いません。省略しても name キーの必須性には影響しません。 例: 资源名称取得または入力方法: 顧客が選択したフィールド表示別名、または元のエクスポート値。 |
|
| templateInfo.title | string | 省略可能です。現在の作成/変更ではこの入力は保存されません。ローカル設定のエクスポート時の title は alias/name から合成され、この値を変更しても分類名、別名、エクスポートタイトルは変わりません。 例: 示例资源目录取得または入力方法: 元のエクスポートテンプレートのタイトル。 |
|
| templateInfo.summary | string | 省略可能です。現在の作成/変更ではリソースカタログエンティティの説明として保存されません。200 応答だけで保存済みと判断しないでください。 例: 取得または入力方法: 元のエクスポートテンプレートの概要。 |
|
| templateInfo.iconSet | json | 作成時のデフォルトは {} です。変更時に省略すると維持され、{} でクリアされます。動的オブジェクトはテンプレート/UI に従って消費され、アイコン URL の有効性は一律に検証されません。 例: {}取得または入力方法: 元のエクスポートアイコン設定、または業務で選択した有効なアイコン情報。 |
|
| templateInfo.iconSet.icon | string | 省略可能な例示キーです。任意の列挙値がサポートされるわけではありません。実際の UI アイコンに従って選択してください。 例: database取得または入力方法: 既存テンプレートでサポートされているアイコン識別子。 |
|
| templateInfo.iconSet.url | string | 省略可能です。サーバー側ではここでリクエストを送信して検証することはありません。認証情報を含む URL を指定しないでください。 例: https://example.com/resource-icon.svg取得または入力方法: 顧客がアクセス可能な正当なアイコンリソース URL。 |
|
| templateInfo.main | array | 作成時は業務上少なくとも 1 項目が必要です。先頭項目のみ有効で、複数分類を一括作成しません。変更時に指定しない場合、ほとんどの表示フィールドは維持されますが、指定後はデフォルトのクリア動作を確認する必要があります。 例: [{}]取得または入力方法: エクスポートテンプレートの main 配列全体からバックアップします。 |
|
| templateInfo.main[*] | json | インデックス 0 のみが消費されます。1 項目のみを推奨します。 例: {}取得または入力方法: 単一のリソースカタログテンプレート。 |
|
| templateInfo.main[*].class | string | 作成時の実際のソースタイプです。省略時は custom_object がデフォルトです。公開動的テンプレートでは列挙値の一律検証を行わないため、他の値は保存失敗により 500 になる可能性があります。変更時はこの値は無視され、実際のタイプは外側の sourceType を使用します。 例: custom_object取得または入力方法: 外側の sourceType および実際のデータタイプと一致させます。 |
|
| templateInfo.main[*].source | json | 作成時は有効なオブジェクトが必須です。変更時は source.name を別名として読み取るのみで、パスの分類コードは変更しません。旧システムテンプレートの文字列 source を直接設定せず、先にオブジェクトへ変換してください。 例: {"key": "example_resources", "name": "示例资源目录"}取得または入力方法: 元のレポート送信 class コードと表示したい別名を取得します。 |
|
| templateInfo.main[*].source.key | string | 作成時は業務上、空でない文字列が必須で、先頭と末尾の空白は除去されます。名前の保存列は 256 で、公開仕様に一律の長さ宣言はありませんが、256 を超えないことを推奨します。変更時にこれで名前変更はできず、パス objc_name によってのみ特定されます。 例: example_resources取得または入力方法: オブジェクトのレポート送信 class と完全に一致する分類名。 |
|
| templateInfo.main[*].source.name | string | 作成時のデフォルトは空文字列です。変更時に空でない main を指定して source.name を省略すると別名は空に設定され、維持されません。列は 256 なので長さを制御することを推奨します。 例: 示例资源目录取得または入力方法: 顧客が表示用別名を選択し、元のテンプレート/一覧の alias から取得します。 |
|
| templateInfo.main[*].groupCfg | json | 外側の objcGroupUUID を省略した場合、name によってグループを検索または作成しようとします。{} はグループなしです。現在、同名グループが既に存在する場合の互換分岐で 500 になる可能性があるため、安定した操作には既存 UUID の明示的な設定を推奨します。 例: {}取得または入力方法: エクスポート内の業務グループ情報を取得するか、優先的に objcGroupUUID を明示します。 |
|
| templateInfo.main[*].groupCfg.name | string | 省略可能で、空白は除去されます。省略時はグループなしです。表示情報だけでなく、新しいグループの作成を試行します。既存グループがある場合は外側の UUID を優先します。 例: 业务分组取得または入力方法: 既存のグループ名、または顧客が作成予定のグループ名から取得します。 |
|
| templateInfo.main[*].fields | array | 外側の fields と同じ構造です。外側の fields が存在する場合はこの値を上書きします。作成時は最終的に name を含める必要があります。変更時に両方とも省略した場合、既存の対象は維持され、対象がない場合は fields=[] を追加作成でき、name の検証は行わず、下流同期も行いません。 例: [{"name": "name"}]取得または入力方法: 実際のレポート送信で必ず含まれるフィールド、またはエクスポートした main[0].fields。 |
|
| templateInfo.main[*].fields[*] | json | 推奨オブジェクト。 例: {"name": "name", "alias": "名称"}取得または入力方法: 単一フィールド定義で、外側の fields と一致します。 |
|
| templateInfo.main[*].fields[*].name | string | ルールは fields[*].name と同じで、最終的に name を含み、重複しない必要があります。 例: name取得または入力方法: レポート送信フィールドキー。 |
|
| templateInfo.main[*].fields[*].alias | string | 省略可能で、name の代わりにはなりません。 例: 名称取得または入力方法: このフィールドの表示別名。 |
|
| templateInfo.main[*].filters | array | 作成時のデフォルトは [] です。変更時にテンプレートでこのフィールドが指定されない場合は維持され、[] でクリアされ、空でない場合は全体が置換されます。 例: [{"key": "env"}]取得または入力方法: 元テンプレートのショートカットフィルター設定で、フィールドは実際のオブジェクトデータに由来します。 |
|
| templateInfo.main[*].filters[*] | json | 動的表示オブジェクトで、サーバー側では保存時にクエリを実行して検証しません。 例: {"key": "env"}取得または入力方法: 単一のショートカットフィルター項目。 |
|
| templateInfo.main[*].filters[*].key | string | 空でない実際のキーを推奨し、タイトルは入力しません。 例: env取得または入力方法: 実際のオブジェクト属性フィールド名。 |
|
| templateInfo.main[*].groups | array | 動的表示配列です。作成時のデフォルトは [] で、変更時に空でない main を指定して groups を省略しても [] にクリアされます。カタログの業務グループ objcGroupUUID とは異なります。 例: []取得または入力方法: 元のエクスポートされたグループ表示設定から保持します。 |
|
| templateInfo.main[*].groups[*] | JSON | 元のテンプレートに従って完全に保持し、構造/列挙値の一律の厳格な検証は行いません。 例: env取得または入力方法: 既存の UI 設定でサポートされているグループ項目。 |
|
| templateInfo.main[*].fills | array | 動的配列です。作成時のデフォルトは [] で、変更時に空でない main を指定して fills を省略すると [] にクリアされます。サーバー側で一律に必須となるサブ構造はありません。 例: []取得または入力方法: 元のエクスポートされた fills 表示設定から保持します。 |
|
| templateInfo.main[*].fills[*] | JSON | 元の消費構造に従って保持し、デフォルトルールを勝手に構築しません。 例: {}取得または入力方法: 既存の UI テンプレートで実際に使用されている fills 設定項目。 |
|
| templateInfo.main[*].table | json | 省略可能なオブジェクトです。作成時のデフォルトは空の設定で、変更時に対応するサブフィールドが指定されない場合はその値を維持します。 例: {}取得または入力方法: 元テンプレートの一覧および詳細表示設定からコピーします。 |
|
| templateInfo.main[*].table.columns | array | 作成時のデフォルトは [] です。変更時に省略すると維持され、[] でクリアされます。fields の収集フィルターとは異なります。 例: [{"key": "name"}]取得または入力方法: 一覧に表示する実際のオブジェクトフィールド。 |
|
| templateInfo.main[*].table.columns[*] | json | 動的列オブジェクトで、これ以上の表示属性は一律に検証しません。 例: {"key": "name"}取得または入力方法: 単一の一覧表示列。 |
|
| templateInfo.main[*].table.columns[*].key | string | 列を特定するフィールドで、別名/タイトルではありません。 例: name取得または入力方法: 実際のレポート送信フィールド名。 |
|
| templateInfo.main[*].table.detail | json | 省略可能なオブジェクトです。実際の views は table.detail.views 内に置く必要があり、main.detail.views ではありません。 例: {}取得または入力方法: 元テンプレートの詳細ページ設定。 |
|
| templateInfo.main[*].table.detail.views | array | 作成時のデフォルトは [] です。変更時に省略すると維持され、[] でクリアされます。UI の消費に従って保存され、現在のインターフェースではページ/ビューの存在や権限を検証しません。 例: []取得または入力方法: 元のリソースカタログのタブ設定、または組み込みページ/組み込みビュー名から取得します。 |
|
| templateInfo.main[*].table.detail.views[*] | json | 元の表示プロトコルです。サーバー側では保持するのみで、即時にレンダリングしたりページをテストしたりしません。 例: {"viewType": "component", "viewName": "base", "title": "详情", "required": false, "keys": {}, "timerange": "default"}取得または入力方法: 単一の詳細タブ設定。 |
|
| templateInfo.main[*].table.detail.views[*].title | string | 省略可能な表示テキスト。 例: 详情取得または入力方法: 呼び出し元が指定するタブ表示タイトル。 |
|
| templateInfo.main[*].table.detail.views[*].viewType | string | camelCase の viewType を使用します。旧説明の view_type はここでは自動変換されません。 例: component取得または入力方法: 実際にサポートされている組み込みページ component、または組み込みビュー dashboard。 |
|
| templateInfo.main[*].table.detail.views[*].viewName | string | 任意の外部サイト URL やダッシュボード UUID を名前の代わりに入力することはできません。保存時に存在は検証されず、表示可能であることも保証されません。 例: base取得または入力方法: component はサポート済みの組み込みページ相対パスを取得し、dashboard は既存の組み込みビュー名を取得します。 |
|
| templateInfo.main[*].table.detail.views[*].required | boolean | 表示の取り決めとして、false はデフォルトで表示し、true は keys の一致によって表示を決定します。実際の JSON ブール値を使用し、文字列 "false" は使用しません。本インターフェースでは一致を即時に検証しません。 例: false取得または入力方法: keys の一致に応じてタブを表示するかどうかの UI オプション。 |
|
| templateInfo.main[*].table.detail.views[*].keys | json | required=true と連動します。フィールドキーのマッピングで "*" はそのフィールドの存在を要求し、具体的な値は等値条件を表します。{} は UI のデフォルトに従い、API 認可の役割は果たしません。 例: {}取得または入力方法: 表示対象オブジェクトのデータフィールドと値条件。 |
|
| templateInfo.main[*].table.detail.views[*].keys.字段名 | JSON | 既存のデータ値または存在マーカー * を使用できます。実際の UI のマッチング機能に従って使用します。 例: *取得または入力方法: 実際のオブジェクト属性キー/マッチング値。 |
|
| templateInfo.main[*].table.detail.views[*].timerange | string または 文字列配列 | 表示の取り決めとして、default はプラットフォームの時間ウィジェットに従います(15m に固定されません)。15m/1h/1d、または [前オフセット, 後オフセット](例: [5m,30m])を指定してデータ time と連動できます。保存時に式の検証やクエリの実行は行いません。 例: default取得または入力方法: 詳細の関連クエリ要件に応じて時間範囲を選択します。 |
|
| templateInfo.main[*].table.detail.views[*].timerange[*] | string | m/h/d 単位を使用し、ミリ秒の timeRange Query とは異なります。 例: 15m取得または入力方法: 2 要素のオフセット配列における前/後の期間。 |
|
| fields | array | 宣言上は省略可能ですが、作成時/変更時に渡す場合は業務上 name を含み、重複しない必要があります。外側の fields はテンプレート内の同名設定より優先されます。変更時に両方とも省略した場合、対象が既に存在すればフィールドを維持し、対象が存在しなければ fields=[] を追加作成し、name の検証は行わず、下流フィルターも同期しません。テンプレートで指定されている場合はテンプレートを使用します。明示的な [] は name がないため拒否されます。フィールドは下流のレポート送信フィルタールールに同期され、これらの必須フィールドが欠けているデータは破棄される可能性があるため、事前に収集側と確認してください。 null を許可: False 例: [{"name": "name", "alias": "资源名称"}]取得または入力方法: 実際のレポート送信で必ず含まれるフィールド名を取得します。エクスポートした main[0].fields をバックアップしてから調整します。 |
|
| objcGroupUUID | string | 省略可能です。作成/変更時に明示的な空文字列を指定するとグループをクリアします。省略時はテンプレートの groupCfg.name を試行し、名前がない場合は空文字列になります。変更時は元のグループを維持するわけではありません。空でない場合は本ワークスペースにグループが存在する必要があります。一覧ではこのフィールドが宣言されていますが、現在の実装ではこれによる絞り込みは行わないため、結果を絞り込むために依存しないでください。 空文字列を許可: True null を許可: False 最大長: 64 例: 取得または入力方法: 現在のワークスペースのリソースカタロググループ管理、または一覧項目の objcGroupUUID から objcg_ 識別子を取得します。 |
|
| sourceType | string | Y | 公開仕様では必須で、object/custom_object のみです。共有内部関数の *_history はサポートされません。作成時は実際に templateInfo.main[0].class を使用するため、必ずこのフィールドと一致させてください。変更/読み取りでは設定タイプの選択に使用します。削除の公開仕様では custom_object のみで、コントローラーもこのタイプに固定されています。 null を許可: False 選択可能な値: ['object', 'custom_object'] 例: custom_object取得または入力方法: システムオブジェクトは object、カスタムリソースオブジェクトは custom_object を選択し、実際のレポート送信データソースを取得します。 |
| templateInfo | json | 動的テンプレートオブジェクトです。作成時は有効で空でない main が必要で、先頭項目に source.key を含める必要があります(外側では業務上の必須宣言はありませんが、省略すると 500 になる可能性があります)。main[0] のみを消費し、後続項目は無視します。変更時は省略または {} でほとんどの設定を維持できますが、グループは本ページの個別ルールに従って処理されます。 null を許可: False 例: {}取得または入力方法: 優先的にリソースカタログのエクスポートの content 設定オブジェクトを基礎として使用し、統一レスポンス全体を再設定しません。 |
パラメータ補足説明¶
テンプレート設定では templateInfo.main[0] を使用し、テーブル詳細のパスは table.detail.views、フィールド名は viewType です。パラメータ表で項目ごとに展開済みです。テンプレートの動的表示情報は、保存時にページレンダリングやクエリ検証を実行しません。
リクエスト例¶
curl --request POST 'https://openapi.guance.com/api/v1/objc_cfg/example_resources/modify' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json' \
--data-raw '{"sourceType":"custom_object","objcGroupUUID":"","fields":[{"name":"name","alias":"资源名称"}],"templateInfo":{"main":[{"class":"custom_object","source":{"key":"example_resources","name":"示例资源目录"},"groupCfg":{},"fields":[{"name":"name","alias":"资源名称"}],"filters":[{"key":"env"}],"groups":[],"fills":[],"table":{"columns":[{"key":"name"}],"detail":{"views":[]}}}],"title":"示例资源目录","summary":"","iconSet":{}}}'
レスポンス¶
HTTP 200、application/json。以下の例は直接読み取れる主要フィールドを示します。
| フィールド | 型 | 説明 |
|---|---|---|
| content.id | integer または null | ローカル設定レコード番号。新規作成の送信前に構築されたレスポンスでは null になることがあります。 |
| content.uuid | string | ローカルの objc_ 設定 UUID で、分類名ではありません。 |
| content.workspaceUUID | string | 所属ワークスペース。 |
| content.sourceType | string | object/custom_object。 |
| content.name | string | 実際の分類コード。 |
| content.alias | string | 表示別名。 |
| content.objcGroupUUID | string | 業務グループ UUID。グループなしの場合は空文字列。 |
| content.dashboardBindSet | array | 履歴のバインドデータです。このエンドポイントではこの構造を個別に解析/更新しません。 |
| content.dashboardBindSet[] | JSON | 元々保存されている動的バインド項目。 |
| content.fields | オブジェクト配列 | フィールド定義です。対象が存在せず、すべての fields を省略した場合は [] になることがあり、この分岐では下流フィルターを更新しません。 |
| content.fields[].name | string | 実際のレポート送信フィールド名です。name を必ず含み、重複せず、フィールド命名規則に従います。 |
| content.fields[].alias | string | 省略可能な表示別名。 |
| content.extend | object | 実際に保存された表示設定。 |
| content.extend.iconSet | object または null | アイコンの動的設定です。履歴/エクスポートでは null になることがあります。 |
| content.extend.iconSet.icon | string | 条件付きアイコン識別子。 |
| content.extend.iconSet.url | string | 条件付きアイコン URL。 |
| content.extend.filters | オブジェクト配列 | ショートカットフィルター項目。 |
| content.extend.filters[].key | string | フィルターフィールド。 |
| content.extend.groups | array | 動的表示グループ。 |
| content.extend.groups[] | JSON | 単一の動的グループ項目。 |
| content.extend.fills | array | 動的な fills 設定。 |
| content.extend.fills[] | JSON | 単一の動的 fills 項目。 |
| content.extend.columns | オブジェクト配列 | 一覧表示列。 |
| content.extend.columns[].key | string | 単一列のフィールドキー。 |
| content.extend.tableDetailViews | オブジェクト配列 または object | 詳細タブです。テンプレート未設定の分岐では {} になることがあります。 |
| content.extend.tableDetailViews[].title | string | タブタイトル。 |
| content.extend.tableDetailViews[].viewType | string | component/dashboard。 |
| content.extend.tableDetailViews[].viewName | string | 組み込みページパスまたは組み込みビュー名。 |
| content.extend.tableDetailViews[].required | boolean | keys に応じて表示するかどうか。 |
| content.extend.tableDetailViews[].keys | object | 動的マッチングフィールド/値。 |
| content.extend.tableDetailViews[].keys.字段名 | JSON | マッチング値/存在マーカー *。 |
| content.extend.tableDetailViews[].timerange | string または 文字列配列 | default/相対期間/前後オフセット配列。 |
| content.extend.tableDetailViews[].timerange[] | string | 単一の前/後オフセット期間。 |
| content.status | integer | 正常 0、削除 3。 |
| content.creator | string | 作成主体。 |
| content.updator | string | 更新主体。 |
| content.createAt | integer | 作成 Unix 秒。 |
| content.updateAt | integer または number | 更新 Unix 秒。履歴では小数値との互換性がある場合があります。 |
| content.deleteAt | integer | 未削除は -1。 |
| content.declaration | object | 共通宣言。 |
{
"code": 200,
"content": {
"id": null,
"uuid": "objc_example",
"workspaceUUID": "wksp_example",
"sourceType": "custom_object",
"name": "example_resources",
"alias": "示例资源目录",
"objcGroupUUID": "",
"dashboardBindSet": [],
"fields": [
{
"name": "name",
"alias": "资源名称"
}
],
"extend": {
"iconSet": {},
"columns": [
{
"key": "name"
}
],
"filters": [
{
"key": "env"
}
],
"groups": [],
"fills": [],
"tableDetailViews": []
},
"status": 0,
"creator": "wsak_example",
"updator": "wsak_example",
"createAt": 1785427200,
"updateAt": 1785427200,
"deleteAt": -1,
"declaration": {}
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
エラーレスポンス¶
認証、レート制限、共通リクエストエラーについては共通エラー定義を参照してください。
変更/エクスポートできるのは、現在の API Key のワークスペースの設定のみです。一覧は認可された対象ワークスペースをカウントできますが、その表示設定は引き続き現在のワークスペースのものです。インターフェースには freeEdition バージョン宣言がありますが、共通 OpenAPI 認証はこのルートでそのバージョンチェックを実行しないため、バージョン自体を固定の 403 として記載しません。上流の 4xx は実際の Kodo/権限マッピングに従います。通常の 5xx は最終的に 500 ft.InternalServerError になります。
| HTTP ステータス | errorCode | 発生条件 | メッセージまたはレスポンスの説明 | 対処方法 |
|---|---|---|---|---|
| 406 | ft.ParameterValidationFailed | リクエストフィールドが欠落しているか、フィールド値が宣言された検証条件に違反しています | パラメータ解析失敗 | パラメータの位置、フィールド名、型、値を確認してください。 |
| 400 | ft.RequestJsonFormatError | リクエスト JSON の構文が無効です | リクエスト JSON の形式エラー | content.reason、line、column に従って JSON を修正してください。 |
| 400 | ft.JsonFormatError | Body のトップレベルが JSON オブジェクトではありません | 一部の json ファイルの形式エラー | 本ページのフィールドを含むオブジェクトを送信してください。 |
| 400 | ft.InvalidFieldName | 最終的な fields のいずれかのフィールド名が正規表現に一致しません | 無効なフィールド名(英字で始まり、英字とアンダースコアのみで構成) | 英字で始まり 2 文字以上の英字/数字/_ の名前を使用し、文字列ではなくオブジェクトを送信してください。 |
| 400 | ft.MissingFiledName | 明示的な外側またはテンプレートの fields に name が欠けています(明示的な [] を含む)。両方とも省略した場合はこのチェックは発生しません | name フィールドを含める必要があります |
name と、実際のレポート送信で必ず含まれるすべてのフィールドを保持してください。変更前に完全な定義をバックアップしてください。 |
| 400 | ft.UnsupportRepeatfield | fields に重複名が存在します | 重複フィールドは使用できません | フィールドは name で重複排除し、別名の違いを異なるフィールドとして扱わないでください。 |
| 406 | ft.InvalidObjcSetClassName | 分類名が空、または形式が無効です | オブジェクト分類名 {} は無効です |
既存の分類一覧から name を取得し、作成時は templateInfo.main[0].source.key を空でなくし、先頭/末尾の空白を避けてください。 |
| 404 | ft.NotFoundObjcGroupObj | 明示的な空でない objcGroupUUID が、現在のワークスペースの未削除グループに存在しません | 指定されたリソース分類グループが見つかりません | 実際のグループ UUID を使用し、グループをクリアする場合は明示的な空文字列を使用してください。 |
| 500 | ft.InternalServerError | 動的テンプレート/フィールド要素の形状、保存長、既存グループの互換分岐、または送信後のフィルター同期に失敗しました | 内部エラー | まず一覧/エクスポートを読み取って設定および下流フィルターの状態を確認してください。既に保存されている可能性があるため、盲目的に再作成しないでください。既存グループがある場合は UUID を明示的に設定してください。 |