수정¶
POST /api/v1/logging_query_rule/{logging_query_rule_uuid}/modify
개요¶
로그 액세스 규칙을 전체 수정합니다.
호출 전 및 사용 단계¶
먼저 상세 정보를 읽고, 백업한 뒤 쓰기 가능한 전체 필드를 다시 채웁니다. 이 API는 전체 교체 방식이므로 desc/indexes/sources/conditions/extend/logic/maskFields/reExprs를 생략하면 각각 빈 문자열/[]/{} 등의 기본값으로 복원됩니다. 이름만 제출하고 다른 구성이 변경되지 않기를 기대할 수 없습니다. regionCode를 전달하지 않으면 빈 문자열이 저장됩니다. 유형은 원본 레코드를 따르며, 이 Body로 변경할 수 없습니다.
이 레거시 엔드포인트는 regionCode를 허용하지 않으며, 제공하지 않으면 빈 문자열이 저장되고 읽기/쿼리 시 현재 사이트에 따라 해석됩니다. 명시적 소스 사이트를 유지해야 하는 규칙을 수정할 때는 이 엔드포인트를 사용하지 마세요.
쓰기는 구성을 교체하고 데이터베이스에 커밋한 뒤 규칙 캐시를 지우고 감사 로그를 기록합니다. 사이트 간 검증은 리소스 정보를 읽거나 업데이트할 수도 있습니다. 단계가 단일 원자적 트랜잭션이 아니므로 500/타임아웃 후에는 목록/상세에서 먼저 저장 여부를 확인하여 무작정 반복 생성하지 마세요.
규칙 저장은 이후 조건에 맞는 ID의 데이터 쿼리 범위/결과 마스킹에 영향을 주며, 원본 데이터를 수정, 삭제 또는 보충 수집하지 않고 역할의 기본 쿼리 권한도 새로 추가하지 않습니다. 여러 역할 및 규칙은 쿼리 측 정책에 따라 병합되므로 단일 규칙만으로 최종 권한을 추론할 수 없습니다. Owner는 예외이며, 관리자 및 워크스페이스의 "데이터 액세스 범위 제한" 설정은 일치하는 역할이 없을 때의 처리를 변경하므로 대표 멤버로 실제 쿼리하여 검수해야 합니다. 저장 후 규칙 캐시가 무효화되지만, 모든 진행 중인 쿼리가 즉시 전환됨을 보장하지는 않습니다.
경로 파라미터¶
| 파라미터 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| logging_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]+"}가져오기 또는 입력 방법: 각 객체는 하나의 마스킹 표현식을 정의합니다. |
|
| 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 | 호환 표시 필드로 일반적으로 and/or입니다. 신규 추가 시 필수로 선언되지만 수정 시 생략할 수 있습니다. 생략하면 빈 문자열이 저장되며, 실제 적용되는 필터는 conditions를 직접 사용합니다. logic을 변경해도 조건이 다시 작성되지 않고, 다중 역할/다중 규칙 병합은 이 필드로 제어되지 않습니다. null 허용: False 예: and가져오기 또는 입력 방법: 클라이언트 필터 편집기의 조건 결합 방식과 일치하게 유지합니다. |
|
| maskFields | string | 선택 사항이며, 누락 시 빈 문자열로 이 규칙의 필드 마스킹을 구성하지 않습니다. 수정 시 생략하면 비워집니다. 필드를 선택했고 reExprs=[]이면 non-null 값의 전체 필드가 ***로 마스킹됩니다. 비어 있지 않은 정규식 목록을 주면 활성화된 정규식만 적용되며, 모두 비활성화해도 전체 필드 마스킹과 같지 않습니다. 저장 컬럼에 맞게 ≤256자를 권장합니다. 빈 문자열 허용: True null 허용: False 예: message가져오기 또는 입력 방법: 쿼리 결과의 실제 필드 이름에서 선택하고 여러 개는 영문 쉼표로 구분합니다. 예: message,user_email. *로 전체를 선택할 때는 단독으로 사용해야 하며 구체적 필드와 혼용하지 않습니다. |
|
| name | string | 생략할 수 있으며, 누락/빈 문자열이면 호출 ID의 표시 이름과 현재 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/lqrl_example/modify' \
-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 | 생성 ID입니다. |
| content.updator | string | 최근 업데이트 ID이며 초기에는 비어 있을 수 있습니다. |
| content.createAt | integer | 생성 Unix 초입니다. |
| content.updateAt | integer | 업데이트 Unix 초이며 업데이트되지 않았으면 -1입니다. |
| content.deleteAt | integer | 삭제 Unix 초이며 삭제되지 않았으면 -1입니다. |
| content.name | string | 저장 값: 생략할 수 있으며, 누락/빈 문자열이면 호출 ID의 표시 이름과 현재 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 | 공용 선언이며, 쓰기 응답에는 소스/역할/ID 요약이 자동으로 추가되지 않습니다. |
{
"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를 제공하세요. |
| 404 | ft.NotFoundDataQueryRuleCfg | 이 워크스페이스의 대상 규칙이 존재하지 않거나 삭제됨, 로그 엔드포인트는 logging으로도 제한됨 | 지정된 로그 쿼리 규칙 구성을 찾을 수 없음 | 올바른 모듈 목록에서 UUID를 다시 가져오세요. |