単一のデータアクセスルールを変更¶
POST /api/v1/data_query_rule/{query_rule_uuid}/modify
概要¶
データアクセスルールを全体置換で変更します(v2 の旧宣言)。
呼び出し前の準備と使用手順¶
まず詳細を取得し、バックアップしたうえで書き込み可能なフィールドをすべて回填してください。この API は全体を置換します。desc/indexes/sources/conditions/extend/logic/maskFields/reExprs を省略すると、それぞれ空文字列/[]/{} などのデフォルトに戻ります。名前だけを送信して他の設定が変わらないことを期待することはできません。regionCode を送信しない場合は空文字列が保存されます。タイプは元のレコードを引き継ぎ、この Body では変更できません。
イベント keyevent の作成には add_v2 を使用し、現在のサイトの regionCode を明示することを推奨します。旧 add/modify で regionCode を省略すると空文字列としてクロスサイト認可の検証が行われ、通常はリージョンエラーが返されます。また v2 の変更は旧ルートに隠蔽されるため、現在の公開された変更操作ではイベントルール/クロスサイトルールのサイトを確実に保持できません。このような変更はコンソールから行い、実際に有効になっていることを確認してください。
現在の v2 宣言は旧インターフェースと Method および URL が同一で、実際の HTTP リクエストは先に旧エントリにマッチします。regionCode を送信すると未知の Body フィールドとして ft.ParameterValidationFailed が返されます。本ページの宣言表にある regionCode は過去の v2 契約を反映したものであり、現在これに基づいてクロスサイト機能を呼び出すことはできません。以下の実行可能な例では、同一パスの旧エントリで有効なフィールドを使用し、regionCode は送信しません。レスポンスも旧エントリの保存結果です。サイトを明示する機能が必要な場合は、到達可能な汎用作成インターフェース data_query_rule.add_v2 またはコンソールを使用し、架空の /v2 パスを追加しようとしないでください。
書き込みは設定を置換してデータベースにコミットした後、ルールキャッシュをクリアして監査を記録します。クロスサイト検証ではリソース情報の読み取り/更新も発生する場合があります。手順は単一のアトミックトランザクションではないため、500/タイムアウト後はまず一覧/詳細で保存済みかどうかを確認し、むやみに重複して新規作成することを避けてください。
ルールの保存は、以降に条件を満たすアイデンティティに対するデータクエリ範囲/結果のマスキングに影響します。元データの変更、削除、再収集は行わず、ロールの基本クエリ権限も追加しません。複数のロールおよびルールはクエリ側のポリシーに従ってマージされるため、単一のルールだけで最終的な権限を推測することはできません。Owner は免除され、管理者およびワークスペースの「データアクセス範囲制限」設定は一致するロールがない場合の処理を変更します。代表メンバーで実際にクエリして受け入れてください。保存後はルールキャッシュが無効化されますが、すべての実行中クエリが即座に切り替わることは保証されません。
ルートパラメータ¶
| パラメータ名 | 型 | 必須 | 説明 |
|---|---|---|---|
| query_rule_uuid | string | Y | パス用のルール UUID。名前やロール UUID は使用できません。読み取り/変更は現在のワークスペースの未削除項目のみが対象です。 例: lqrl_example取得・入力方法: データアクセスルール一覧 の content.data[].uuid から取得します。 |
リクエストヘッダー¶
| パラメータ名 | 型 | 必須 | 説明 |
|---|---|---|---|
| DF-API-KEY | string | Y | ワークスペースの OpenAPI 認証情報。 例: <DF-API-KEY>取得・入力方法: 対象ワークスペースの API Key 管理から、この操作権限を持つ OpenAPI Key を取得します。 |
Body リクエストパラメータ¶
| パラメータ名 | 型 | 必須 | 説明 |
|---|---|---|---|
| indexes[*] | string | 配列の要素には空でない文字列を推奨します。元の宣言では項目ごとの強制はなく、誤った型は 500 の原因になります。 例: default取得・入力方法: 単一のログインデックス uuid/default、または認可済みの wksp_ ソース:lgim_ インデックス。 |
|
| roleUUIDs[*] | string | 有効なロールを使用してください。アカウント UUID は使用しないでください。 例: role_example取得・入力方法: 本ワークスペースで利用可能なロール uuid、または単独の *。 |
|
| extend.カスタムキー | any | 任意のシリアライズ可能な JSON 値。追加で有効になる条件ではありません。 例: production取得・入力方法: 呼び出し側が定義する表示/編集用のコンテキストで、実際の conditions と一致させます。 |
|
| reExprs[*] | json | name/enable/reExpr のみを使用することを推奨します。配列要素は元の宣言で構造が強制されておらず、オブジェクト以外は 500 になる場合があります。 例: {"name": "token", "enable": true, "reExpr": "tkn_[0-9A-Za-z]+"}取得・入力方法: 各オブジェクトが 1 つのマスキング式を定義します。 |
|
| reExprs[*].name | string | 任意の表示用名称で、マッチング式としては使用されません。省略しても正規表現のマッチングに影響しません。 例: token取得・入力方法: 業務で独自に定義する正規表現の表示名。 |
|
| reExprs[*].enable | boolean | 明示的な真偽値を推奨します。省略時は未有効として扱われます。無効化した正規表現も構文が正しい必要があります。 例: true取得・入力方法: 適用する場合は true、一時保存して適用しない場合は false。 |
|
| reExprs[*].reExpr | string | 空でない正規表現を推奨します。現在は省略時に空文字列として検査されるため、サーバー側が有効な式を補完することは期待できません。 例: tkn_[0-9A-Za-z]+取得・入力方法: 実際の機密コンテンツのパターン。JSON 文字列で使用する場合、バックスラッシュは二重に記述します。 |
|
| sources[*] | string | 上位の type に従って解釈される単一のソース。空でない文字列を推奨します。 例: monitor取得・入力方法: 対応するデータクエリ結果/ソース一覧から実際の識別子を取得します。イベントの source にはイベント ID やモニター UUID を入力しないでください。 |
|
| conditions | string | フィルタ式のみを入力し、クエリ全体や外側の中括弧は入力しません。任意で、デフォルトは空文字列です。空文字列では追加の絞り込みを行いません。 4048 文字以下を推奨します。keyevent は特に Python の文字数 ≤4048 で E クエリ構文を解析します。他のタイプは保存時に条件のセマンティクスを全面的に検証しないため、成功しても将来のクエリ成功を保証しません。このルールはアクセスを許可するデータ範囲を定義します。 空文字列を許可: True null を許可: False 例: `env` = 'production'取得・入力方法: 対象データの実際のタグ/フィールドから DQL フィルタ条件を構築します。まず同じソースでクエリして検証してください。 |
|
| desc | string | 任意で、最大 256(上記と同じカウント単位)。省略/空文字列は空にクリアされます。変更時は元の値を保持しません。 空文字列を許可: True null を許可: False 最大長: 256 例: 仅允许查看生产环境数据。取得・入力方法: 業務側がルールの目的と適用対象を記入します。 |
|
| extend | json | 任意の JSON を表示用に保存できます。省略時は {}。統一された必須サブキーや単位はなく、サーバーがこれから conditions を自動生成することはありません。変更時は全体を置換します。認証情報は保存しないでください。 null を許可: False 例: {}取得・入力方法: クライアントが自身のエディタの必要に応じて表示用設定を保存します。不要な場合は {}。 |
|
| indexes | array | ログルールでは明示的に指定する必要があります。宣言上は任意ですが、ログクエリには有効なインデックス範囲が必要で、省略時の [] が自動的にすべてに変わることはありません。 ["*"] は利用可能なすべてのログインデックスを意味します。* は単独で使用することを推奨します。[] はすべてではありません。keyevent は [] を強制保存し、その他の非ログタイプは通常 [] を使用します。通常のインデックス名で UUID を代替することはできず、認可が自動的に作成されることもありません。保存成功はリモートのすべてのリソースが依然有効であることを証明しません。 null を許可: False 例: ["default"]取得・入力方法: ログインデックス一覧 から uuid を取得します。デフォルトインデックスは default を使用します。クロスワークスペースでは認可済みのソースワークスペース UUID:インデックス UUID を使用します。 |
|
| logic | string | 互換表示用のフィールドで、通常は and/or です。任意です。 省略時は空文字列を保存します。実際に有効なフィルタは conditions を直接使用し、logic を変更しても条件は書き換えられません。複数ロール/複数ルールのマージはこのフィールドでは制御されません。 null を許可: False 例: and取得・入力方法: クライアントのフィルタエディタにおける条件の組み合わせ方式と一致させます。 |
|
| maskFields | string | 任意です。省略時は空文字列で、このルールのフィールドマスキングは設定されません。変更時に省略するとクリアされます。フィールドを選択し reExprs=[] の場合、非 null 値はフィールド全体が *** でマスクされます。空でない正規表現リストを指定した場合は有効な正規表現のみが適用され、すべて無効化してもフィールド全体のマスクとは異なります。ストレージ列に合わせて 256 文字以下を推奨します。 空文字列を許可: True null を許可: False 例: message取得・入力方法: クエリ結果の実際のフィールド名から選択し、複数は半角カンマで区切ります(例: message,user_email)。* で全選択する場合は単独で使用し、具体的なフィールドと混在させないでください。 |
|
| name | string | Y | 宣言上は必須で、空でなく一意な名称を推奨します。空文字列でも自動命名の分岐に入る可能性がありますが、この互換動作に依存しないでください。 最大 64 カウント単位(ASCII/半角カタカナ 1、その他の文字 2)。有効および無効の同タイプルールがすべて重複名チェックの対象です。 空文字列を許可: False null を許可: False 最大長: 64 例: production_only取得・入力方法: 業務側が命名します。まずデータアクセスルール一覧で同タイプの既存名称を確認してください。 |
| reExprs | array | 任意で、省略時は []。変更時は全体を置換します。保存時に各正規表現(enable=false の項目を含む)を検証します。誤った正規表現は ft.ErrorRegularExpression を返します。任意の文字列を単独の * で表さず、.* を使用してください。選択したフィールドに正規表現がない場合はフィールド全体が *** になります。正規表現は文字列内容のマッチした部分のみを処理し、マッチした内容を *** に置換します。保存時の検証と実行エンジンには差異があるため、保存成功後も代表的なクエリで検証してください。 null を許可: False 例: [{"name": "token", "enable": true, "reExpr": "tkn_[0-9A-Za-z]+"}]取得・入力方法: 機密値の形式に合わせて Python re で実行可能な正規表現を作成し、マスキングサンプルで先に検証します。maskFields と組み合わせて使用します。 |
|
| regionCode | string | Y | v2 宣言上の必須項目であるソースサイトコード。同一ルールのログインデックスは同一サイトに属し、この値と一致する必要があります。旧エントリはこのフィールドを受け付けません。データアクセスルールはクロスサイト/クロスワークスペースの認可の代替にはなりません。イベントのクロスサイトには keyevent または * を含む有効な認可が必要です。下記の重複ルートに関する実際の到達可能性の説明に注意してください。 空文字列を許可: False null を許可: False 例: example-region取得・入力方法: 対象のソースサイトおよび有効なクロスワークスペース認可一覧から実際の regionCode を確認します。現在のサイトも正式なコードを使用し、例のリテラル値は入力しないでください。 |
| roleUUIDs | array | Y | 必須の配列で、["*"] は各ロールを表し、Owner は依然としてデータアクセス制限を受けません。[] はどのロールにも一致せず、すべてと等しくありません。イベント keyevent は空でない文字列配列が必須で、* は単独でのみ指定できます。その他のタイプはスコープ内のロールの存在を検証しますが、ロールの status=0 は保証しません。基本クエリ権限は別途必要です。 null を許可: False 例: ["role_example"]取得・入力方法: ロール一覧 から本ワークスペースのロール uuid を取得します。ワークスペースメンバー一覧 でメンバーの実際のロールを確認できます。 |
| sources | array | 非ログ範囲の配列で、["*"] は利用可能なすべてのソースを表します。省略時の [] はすべてを意味しません。logging は [] を強制保存します。rum/lineage は認可済みワークスペース UUID:ソース識別子で限定できます。tracing/metric/keyevent は元のソース文字列を使用します。keyevent は空でない文字列配列が必須で、wksp_:ソースは受け付けず、* を他の値と混在させることもできません。rum は現在の regionCode を明示した場合にのみアプリの存在をクエリして確認します。その他のソースは保存に成功しても実際にデータがあることは証明されません。 null を許可: False 例: ["*"]取得・入力方法: 非ログは実際のデータソースに従って入力します。rum は RUM アプリ一覧 の appId、tracing は service、metric はメジャーメント名、lineage は実際のログソース source、keyevent は monitor などのイベント source を使用します。 |
パラメータ補足説明¶
1. リクエストパラメータの説明
| パラメータ名 | type | 必須 | 説明 |
|---|---|---|---|
| name | string | Y | 名称 |
| desc | String | N | 説明 |
| indexes | array | Y | type が logging の場合は必須。本ワークスペース以外(ワークスペース認可が必要)のインデックス認可の場合は、ワークスペース UUID:インデックス UUID を使用します。例: ["wksp_111:lgim_222", "wksp_333:lgim_444"] |
| sources | array | Y | type が非 logging の場合は必須。type が rum の場合はアプリの appId リスト、type が tracing の場合はサービス名リスト、type が metric の場合はメジャーメントリストです |
| roleUUIDs | array | Y | ロール UUID のリスト |
| conditions | string | N | 実際に使用するデータ範囲のフィルタ条件。例: "device IN ['PC'] and session_has_replay IN ['1']" |
| extend | dict | Y | 拡張フィールド。conditions の構造内容を格納し、フロントエンド画面の表示に使用します。例: {"device": [ "PC"], "session_has_replay": [1]} |
| logic | string | N | 論理フィールド(and/or)。フィルタ条件の結合に使用します |
| maskFields | string | N | マスキング対象フィールド。複数のフィールドはカンマで区切ります |
| reExprs | array | N | 正規表現。例: [{"name":"1111","enable":true,"reExpr":"tkn_[\da-z]*"},{"name":"liuyltest","enable":true,"reExpr":"test"}] |
| regionCode | string | Y | サイトコード(workspace/website/list インターフェースで取得可能) |
リクエスト例¶
curl --request POST 'https://openapi.guance.com/api/v1/data_query_rule/lqrl_example/modify' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json' \
--data-raw '{"name":"production_only","desc":"仅允许查看生产环境数据。","indexes":["default"],"sources":[],"roleUUIDs":["role_example"],"conditions":"`env` = '"'"'production'"'"'","extend":{},"logic":"and","maskFields":"message","reExprs":[{"name":"token","enable":true,"reExpr":"tkn_[0-9A-Za-z]+"}]}'
レスポンス¶
HTTP 200、application/json。以下の例は直接読み取れる主要なフィールドを示しています。
| フィールド | 型 | 説明 |
|---|---|---|
| content.id | integer または null | レコード番号。作成時はコミット前のスナップショットを返すため null になる場合があり、以降の操作には uuid を使用します。 |
| content.uuid | string | lqrl_ ルール UUID。2 つのモジュールがエンティティと識別子を共有します。 |
| content.workspaceUUID | string | このルールが属するワークスペース。ソースワークスペースとは区別されます。 |
| content.status | integer | 0 有効、2 無効、3 削除。本モジュールの読み取りは未削除のもののみ対象です。 |
| content.creator | string | 作成したアイデンティティ。 |
| content.updator | string | 最後に更新したアイデンティティ。初期状態では空の場合があります。 |
| content.createAt | integer | 作成日時の Unix 秒。 |
| content.updateAt | integer | 更新日時の Unix 秒。未更新の場合は -1。 |
| content.deleteAt | integer | 削除日時の Unix 秒。未削除の場合は -1。 |
| content.name | string | 保存値: 宣言上は必須で、空でなく一意な名称を推奨します。空文字列でも自動命名の分岐に入る可能性がありますが、この互換動作に依存しないでください。 最大 64 カウント単位(ASCII/半角カタカナ 1、その他の文字 2)。有効および無効の同タイプルールがすべて重複名チェックの対象です。 |
| content.desc | string | 保存値: 任意で、最大 256(上記と同じカウント単位)。省略/空文字列は空にクリアされます。変更時は元の値を保持しません。 |
| content.indexes | array | 保存値: ログルールでは明示的に指定する必要があります。宣言上は任意ですが、ログクエリには有効なインデックス範囲が必要で、省略時の [] が自動的にすべてに変わることはありません。 ["*"] は利用可能なすべてのログインデックスを意味します。* は単独で使用することを推奨します。[] はすべてではありません。keyevent は [] を強制保存し、その他の非ログタイプは通常 [] を使用します。通常のインデックス名で UUID を代替することはできず、認可が自動的に作成されることもありません。保存成功はリモートのすべてのリソースが依然有効であることを証明しません。 |
| content.indexes[] | string | 保存値: 配列の要素には空でない文字列を推奨します。元の宣言では項目ごとの強制はなく、誤った型は 500 の原因になります。 |
| content.roleUUIDs | array | 保存値: 必須の配列で、["*"] は各ロールを表し、Owner は依然としてデータアクセス制限を受けません。[] はどのロールにも一致せず、すべてと等しくありません。イベント keyevent は空でない文字列配列が必須で、* は単独でのみ指定できます。その他のタイプはスコープ内のロールの存在を検証しますが、ロールの status=0 は保証しません。基本クエリ権限は別途必要です。 |
| content.roleUUIDs[] | string | 保存値: 有効なロールを使用してください。アカウント UUID は使用しないでください。 |
| content.conditions | string | 保存値: フィルタ式のみを入力し、クエリ全体や外側の中括弧は入力しません。任意で、デフォルトは空文字列です。空文字列では追加の絞り込みを行いません。 4048 文字以下を推奨します。keyevent は特に Python の文字数 ≤4048 で E クエリ構文を解析します。他のタイプは保存時に条件のセマンティクスを全面的に検証しないため、成功しても将来のクエリ成功を保証しません。このルールはアクセスを許可するデータ範囲を定義します。 |
| content.extend | json | 保存値: 任意の JSON を表示用に保存できます。省略時は {}。統一された必須サブキーや単位はなく、サーバーがこれから conditions を自動生成することはありません。変更時は全体を置換します。認証情報は保存しないでください。 |
| content.extend.カスタムキー | any | 保存値: 任意のシリアライズ可能な JSON 値。追加で有効になる条件ではありません。 |
| content.logic | string | 保存値: 互換表示用のフィールドで、通常は and/or です。任意です。 省略時は空文字列を保存します。実際に有効なフィルタは conditions を直接使用し、logic を変更しても条件は書き換えられません。複数ロール/複数ルールのマージはこのフィールドでは制御されません。 |
| content.maskFields | string | 保存値: 任意です。省略時は空文字列で、このルールのフィールドマスキングは設定されません。変更時に省略するとクリアされます。フィールドを選択し reExprs=[] の場合、非 null 値はフィールド全体が *** でマスクされます。空でない正規表現リストを指定した場合は有効な正規表現のみが適用され、すべて無効化してもフィールド全体のマスクとは異なります。ストレージ列に合わせて 256 文字以下を推奨します。 |
| content.reExprs | array | 保存値: 任意で、省略時は []。変更時は全体を置換します。保存時に各正規表現(enable=false の項目を含む)を検証します。誤った正規表現は ft.ErrorRegularExpression を返します。任意の文字列を単独の * で表さず、.* を使用してください。選択したフィールドに正規表現がない場合はフィールド全体が *** になります。正規表現は文字列内容のマッチした部分のみを処理し、マッチした内容を *** に置換します。保存時の検証と実行エンジンには差異があるため、保存成功後も代表的なクエリで検証してください。 |
| content.reExprs[] | json | 保存値: name/enable/reExpr のみを使用することを推奨します。配列要素は元の宣言で構造が強制されておらず、オブジェクト以外は 500 になる場合があります。 |
| content.reExprs[].name | string | 保存値: 任意の表示用名称で、マッチング式としては使用されません。省略しても正規表現のマッチングに影響しません。 |
| content.reExprs[].enable | boolean | 保存値: 明示的な真偽値を推奨します。省略時は未有効として扱われます。無効化した正規表現も構文が正しい必要があります。 |
| content.reExprs[].reExpr | string | 保存値: 空でない正規表現を推奨します。現在は省略時に空文字列として検査されるため、サーバー側が有効な式を補完することは期待できません。 |
| content.sources | array | 保存値: 非ログ範囲の配列で、["*"] は利用可能なすべてのソースを表します。省略時の [] はすべてを意味しません。logging は [] を強制保存します。rum/lineage は認可済みワークスペース UUID:ソース識別子で限定できます。tracing/metric/keyevent は元のソース文字列を使用します。keyevent は空でない文字列配列が必須で、wksp_:ソースは受け付けず、* を他の値と混在させることもできません。rum は現在の regionCode を明示した場合にのみアプリの存在をクエリして確認します。その他のソースは保存に成功しても実際にデータがあることは証明されません。 |
| content.sources[] | string | 保存値: 上位の type に従って解釈される単一のソース。空でない文字列を推奨します。 |
| content.type | string | 保存値: 新規作成時は logging/rum/tracing/metric/lineage/keyevent が必須です。宣言上は null を許可していますが、無効なタイプでは正常なクエリルールを形成できないため、常に上記の文字列を送信してください。変更時は type を受け付けず、保存済みのタイプを引き継ぎます。 |
| content.regionCode | string | 保存値: v2 宣言上の必須項目であるソースサイトコード。同一ルールのログインデックスは同一サイトに属し、この値と一致する必要があります。旧エントリはこのフィールドを受け付けません。データアクセスルールはクロスサイト/クロスワークスペースの認可の代替にはなりません。イベントのクロスサイトには keyevent または * を含む有効な認可が必要です。下記の重複ルートに関する実際の到達可能性の説明に注意してください。 |
| content.declaration | object | 共通宣言。書き込みレスポンスにはソース/ロール/アイデンティティのサマリーが自動的に追加されません。 |
{
"code": 200,
"content": {
"id": 100,
"uuid": "lqrl_example",
"workspaceUUID": "wksp_example",
"name": "production_only",
"desc": "仅允许查看生产环境数据。",
"type": "logging",
"indexes": [
"default"
],
"sources": [],
"roleUUIDs": [
"role_example"
],
"conditions": "`env` = 'production'",
"extend": {},
"logic": "and",
"maskFields": "message",
"reExprs": [
{
"name": "token",
"enable": true,
"reExpr": "tkn_[0-9A-Za-z]+"
}
],
"regionCode": "",
"status": 0,
"creator": "wsak_example",
"updator": "wsak_example",
"createAt": 1785427200,
"updateAt": 1785427300,
"deleteAt": -1,
"declaration": {}
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
エラーレスポンス¶
認証、レート制限、共通リクエストエラーについては共通エラー定義を参照してください。
| HTTP ステータス | errorCode | 発生条件 | メッセージまたはレスポンスの説明 | 対応方法 |
|---|---|---|---|---|
| 406 | ft.ParameterValidationFailed | リクエストフィールドの欠落、またはフィールド値が宣言された検証条件に違反 | パラメータの解析に失敗しました | パラメータの位置、フィールド名、型、値を確認してください。 |
| 400 | ft.RequestJsonFormatError | リクエスト JSON の構文が無効 | リクエスト JSON の形式エラー | content.reason、line、column に従って JSON を修正してください。 |
| 404 | ft.NoInitOtherNodeCfg | リモートのインデックス/RUM アプリのメタデータを読み取りまたは検証する際に、利用可能なソースサイトアドレスが見つからない | 他のノード設定が未初期化です | 管理者がソースサイト設定、アクセス可能なアドレス、有効なクロスワークスペース認可を確認し、修正後に再試行してください。 |
| 400 | ft.NameRepeat | 本ワークスペースの同タイプに未削除の同名ルールが存在 | 名前は既に存在します | 名前を変更するか、確認したうえで既存 UUID を更新してください。 |
| 400 | ft.ErrorRegularExpression | 無効化された項目を含むいずれかの正規表現が無効 | 正規表現に誤りがあります | すべての reExpr を修正してから送信してください。単独の * は使用しないでください。 |
| 400 | ft.InvalidRoleUUID | ロールがワークスペーススコープに存在しない、または keyevent のロール配列が無効 | 無効なロール UUID: {} | 本ワークスペースのロール一覧から有効な識別子を取得してください。イベントの * は単独で使用します。 |
| 400 | ft.InvalidLoggingIndex | 解析された現在のサイトのソースワークスペースの通常インデックスが存在しない/削除済み | 無効なインデックス:{} | 有効なインデックス UUID/default を使用し、認可を確認してください。 |
| 400 | ft.InvalidRegionDataQueryRuleIndex | ログインデックスが複数サイトにまたがる、またはサイトが一致しない。イベントのクロスサイトに有効な認可がない | {}サイトのインデックス情報が無効です | サイトごとにルールを作成し、認可記録からソースとターゲットを確認してください。 |
| 500 | ft.InternalServerError | 配列要素の形状不一致、フィールドがストレージ長を超過、下流の一般的な 5xx、データベースまたはコミット後のキャッシュ失敗 | 内部エラー | 本文の構造と長さを確認し、現在の設定を読み取って保存済みかどうかを確認してから再試行を判断し、traceId を提供してください。 |
| 400 | ft.InvalidSources | keyevent のソース構造が無効、または現在のサイトを明示した rum ソースのアプリが存在しない | 無効なリソース情報:{} | イベントは空でない source 文字列配列を指定し、* は単独で使用します。RUM は有効なアプリから appId を取得してください。 |
| 406 | ft.InvalidParameter | keyevent の conditions が文字列でない、または長さが 4048 文字を超過 | パラメータ {} が無効です |
長さが規定内の DQL 条件文字列を使用してください。 |
| 406 | ft.DqlParseError | keyevent の条件を解析できない | dql parser 解析失敗: {} | イベントクエリでフィルタ条件を検証し、元のエラーと traceId を保持してください。 |
| 404 | ft.NotFoundDataQueryRuleCfg | 本ワークスペースの対象ルールが存在しないか削除済み。ログエントリはさらに logging に限定 | 指定されたログクエリルール設定が見つかりません | 正しいモジュールの一覧から UUID を再取得してください。 |