생성¶
POST /api/v1/logging_query_rule/add
개요¶
로그 액세스 규칙을 생성합니다.
호출 전 및 사용 단계¶
먼저 데이터 도메인, 역할, 소스, DQL 조건을 결정한 뒤 고유한 이름으로 생성합니다. 새 규칙은 status=0으로 즉시 활성화되며, 쓰기 성공이 소스에 데이터가 있거나 최종 멤버 권한이 예상과 일치함을 보장하지는 않습니다.
이 레거시 엔드포인트는 regionCode를 받지 않으며, 제공되지 않으면 빈 문자열로 저장되어 읽기/쿼리 시 현재 사이트 기준으로 해석됩니다. 명시적 소스 사이트를 유지해야 하는 규칙을 수정할 때는 이 엔드포인트를 사용하지 마십시오.
쓰기는 구성을 교체하고 데이터베이스에 커밋한 뒤 규칙 캐시를 지우고 감사 로그를 기록합니다. 사이트 간 검증은 리소스 정보를 읽거나 업데이트할 수도 있습니다. 단계가 단일 원자적 트랜잭션이 아니므로 500/타임아웃 발생 시 먼저 목록/상세에서 저장 여부를 확인하여 무작정 중복 생성하는 것을 피하십시오.
규칙 저장은 조건에 부합하는 이후 데이터 쿼리 범위/결과 마스킹에 영향을 주며, 원본 데이터를 수정, 삭제 또는 추가 수집하지 않고 역할의 기본 쿼리 권한을 새로 추가하지도 않습니다. 여러 역할과 규칙은 쿼리 측 정책에 따라 병합되므로 단일 규칙만으로 최종 권한을 추론할 수 없습니다. Owner는 예외이며, 관리자 및 공간의 "데이터 액세스 범위 제한" 설정은 일치하는 역할이 없을 때의 처리를 변경하므로 대표 멤버의 실제 쿼리로 검증해야 합니다. 저장 후에는 규칙 캐시가 무효화되지만 진행 중인 모든 쿼리가 즉시 전환됨을 보장하지는 않습니다.
요청 헤더¶
| 파라미터명 | 타입 | 필수 | 설명 |
|---|---|---|---|
| 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]+"}획득 또는 입력 방법: 각 객체가 하나의 마스킹 표현식을 정의합니다. |
|
| reExprs[*].name | string | 선택적 표시 이름이며 일치 표현식으로 사용되지 않고, 생략해도 정규식 일치에 영향을 주지 않습니다. 예시: token획득 또는 입력 방법: 업무에서 사용자 정의한 정규식 표시 이름입니다. |
|
| reExprs[*].enable | boolean | 명시적 불리언을 권장하며, 누락 시 미활성으로 처리됩니다. 비활성 정규식도 문법은 유효해야 합니다. 예시: true획득 또는 입력 방법: 적용이 필요하면 true, 임시 저장하고 적용하지 않으려면 false입니다. |
|
| reExprs[*].reExpr | string | 비어 있지 않은 정규식을 권장합니다. 현재 누락 시 빈 문자열로 검사되며, 서버가 유효한 표현식을 보완해 줄 것이라고 의존할 수 없습니다. 예시: tkn_[0-9A-Za-z]+획득 또는 입력 방법: 실제 민감 콘텐츠 패턴이며, JSON 문자열로 사용할 때는 역슬래시를 두 번 작성해야 합니다. |
|
| conditions | string | Y | 필터 표현식만 입력하고 전체 쿼리나 외부 중괄호는 입력하지 않습니다. 이 모듈은 필수 문자열로 선언되어 있습니다. 4048자를 넘지 않도록 권장합니다. keyevent는 Python 문자 수 ≤4048 및 E 쿼리 문법 파싱을 별도로 적용하며, 다른 유형은 저장 시 조건 의미를 전면 검증하지 않으므로 성공이 향후 쿼리 성공을 보장하지 않습니다. 이 규칙은 액세스가 허용되는 데이터 범위를 정의합니다. null 허용: False 예시: `env` = 'production'획득 또는 입력 방법: 대상 데이터의 실제 태그/필드로 DQL 필터 조건을 구성하고, 동일한 소스에서 먼저 쿼리로 검증합니다. |
| desc | string | 선택 사항이며 최대 256(위와 동일한 카운트 단위)이고, 누락/빈 문자열은 빈 값으로 정리됩니다. 수정 시 기존 값이 유지되지 않습니다. 빈 문자열 허용: True null 허용: False 최대 길이: 256 예시: 프로덕션 환경 데이터만 조회할 수 있습니다.획득 또는 입력 방법: 업무 담당자가 규칙 목적과 적용 대상을 작성합니다. |
|
| extend | json | 선택적 임의 JSON 표시 값이며 누락 시 {}입니다. 통일된 필수 하위 키나 단위가 없고, 서버가 여기서 conditions를 자동 생성하지 않으며, 수정 시 전체 교체됩니다. 자격 증명을 저장하지 마십시오. null 허용: False 예시: {}획득 또는 입력 방법: 클라이언트가 자체 편집기 요구에 따라 표시 구성을 저장하며, 필요 없으면 {}입니다. |
|
| indexes | array | Y | 로그 규칙은 명시적으로 제공해야 하며 이 모듈은 필수로 선언합니다. ["*"]는 사용 가능한 모든 로그 인덱스를 의미하며 *를 단독으로 사용할 것을 권장합니다. []는 전체가 아닙니다. keyevent는 []를 강제로 저장하고, 기타 비로그 유형은 보통 []를 사용합니다. 일반 인덱스 이름으로 UUID를 대체할 수 없고 권한이 자동 생성되지 않습니다. 저장 성공이 원격의 모든 리소스가 여전히 유효함을 보장하지 않습니다. null 허용: False 예시: ["default"]획득 또는 입력 방법: 로그 인덱스 목록에서 uuid를 가져오고, 기본 인덱스는 default를 사용합니다. 공간 간에는 권한이 부여된 소스 공간 UUID:인덱스 UUID를 사용합니다. |
| logic | string | Y | 호환 표시 필드이며 보통 and/or입니다. 추가 시 필수로 선언되고 수정 시 생략할 수 있습니다. 생략하면 빈 문자열로 저장됩니다. 실제 적용되는 필터는 conditions를 직접 사용하며, logic을 변경해도 조건이 재작성되지 않고, 다중 역할/다중 규칙 병합은 이 필드로 제어되지 않습니다. null 허용: False 예시: and획득 또는 입력 방법: 클라이언트 필터 편집기의 조건 결합 방식과 일치시킵니다. |
| maskFields | string | 선택 사항이며, 누락 시 빈 문자열로 이 규칙의 필드 마스킹을 구성하지 않습니다. 수정 시 생략하면 비워집니다. 필드를 선택했고 reExprs=[]이면 non-null 값은 필드 전체가 ***로 가려집니다. 비어 있지 않은 정규식 목록을 주면 활성화된 정규식만 적용되며, 모두 비활성화한 것과 필드 전체 마스킹은 같지 않습니다. 저장 컬럼에 맞게 256자 이하를 권장합니다. 빈 문자열 허용: True null 허용: False 예시: message획득 또는 입력 방법: 쿼리 결과의 실제 필드명에서 선택하고 여러 개는 영문 쉼표로 구분합니다(예: message,user_email). *로 전체를 선택할 때는 단독으로 사용해야 하며 구체적 필드와 섞지 않습니다. |
|
| name | string | 생략할 수 있습니다. 누락/빈 문자열이면 호출 신원의 표시 이름과 현재 Unix 초를 기준으로 생성을 시도하며, 수정 시에도 동일하게 재생성되고 기존 이름이 유지되지 않습니다. 최대 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와 함께 사용합니다. |
|
| roleUUIDs | array | Y | 필수 배열이며 ["*"]는 각 역할을 의미하고 Owner는 여전히 데이터 액세스 제한을 받지 않습니다. []는 역할과 일치하지 않으며 전체와 같지 않습니다. 이벤트 keyevent는 비어 있지 않은 문자열 배열이어야 하고 *는 단독으로만 나타날 수 있습니다. 다른 유형은 범위 내 역할 존재를 검증하지만 역할 status=0을 보장하지 않습니다. 기본 쿼리 권한은 별도로 갖추어야 합니다. null 허용: False 예시: ["role_example"]획득 또는 입력 방법: 역할 목록에서 본 공간 역할 uuid를 가져옵니다. 워크스페이스 멤버 목록으로 멤버의 실제 역할을 확인할 수 있습니다. |
파라미터 추가 설명¶
데이터 설명.*
1. 역할 권한 부여 액세스 설명 1. 지정된 역할은 지정된 쿼리 범위 내의 데이터만 쿼리할 수 있습니다. 2. 사용자에게 여러 역할이 있고 그중 규칙의 역할에 포함되지 않은 역할이 있으면 해당 데이터 액세스 규칙은 그 사용자에게 적용되지 않습니다. 즉 쿼리 범위를 제한하지 않습니다. 3. 한 공간의 여러 로그 데이터 액세스 규칙 간의 논리는 or 관계입니다.
2. 요청 파라미터 설명
| 파라미터명 | type | 필수 | 설명 |
|---|---|---|---|
| name | string | Y | 이름 |
| desc | String | N | 설명 |
| indexes | array | Y | 로그 인덱스 정보입니다. 본 공간이 아닌(공간 권한 부여 필수) 인덱스 권한인 경우 공간 UUID:인덱스 UUID를 사용합니다. 예: ["wksp_111:lgim_222", "wksp_333:lgim_444"] |
| 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"}] |
요청 예시¶
curl --request POST 'https://openapi.guance.com/api/v1/logging_query_rule/add' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json' \
--data-raw '{"name":"production_only","desc":"프로덕션 환경 데이터만 조회할 수 있습니다.","indexes":["default"],"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이며, 두 모듈이 엔터티와 식별자를 공유합니다. |
| 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 | 저장 값: 생략할 수 있습니다. 누락/빈 문자열이면 호출 신원의 표시 이름과 현재 Unix 초를 기준으로 생성을 시도하며, 수정 시에도 동일하게 재생성되고 기존 이름이 유지되지 않습니다. 최대 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=[]이면 non-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": null,
"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": "",
"createAt": 1785427200,
"updateAt": -1,
"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를 제공하십시오. |