콘텐츠로 이동

조회



GET /api/v1/logging_query_rule/{logging_query_rule_uuid}/get

개요

지정한 액세스 규칙의 전체 저장 구성과 소스/역할 정보를 읽습니다.

호출 전 및 사용 단계

로그 액세스 규칙 목록에서 UUID를 가져옵니다. 이 엔드포인트는 type=logging 규칙만 읽습니다. 같은 테이블의 비로그 UUID도 404를 반환합니다. 저장된 엔터티와 소스, 역할 요약을 반환하며, 목록의 creatorInfo/updatorInfo, memberCount 또는 relMemberInfos는 반환하지 않습니다. 소스 정보는 이력 정보이거나 누락되었을 수 있으며, grantStatus=3은 권한 부여를 사용할 수 없음을 나타냅니다. 저장된 구성을 현재 유효한 권한의 증거로 간주하지 마세요.

규칙 저장은 이후 조건에 부합하는 주체의 데이터 조회 범위/결과 마스킹에 영향을 주며, 원본 데이터를 수정, 삭제 또는 추가 수집하지 않고 역할의 기본 조회 권한도 추가하지 않습니다. 여러 역할 및 규칙은 조회 측 정책에 따라 병합되며, 단일 규칙만으로 최종 권한을 추론할 수 없습니다. 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를 가져옵니다.

요청 예시

curl --get 'https://openapi.guance.com/api/v1/logging_query_rule/lqrl_example/get' \
  -H 'DF-API-KEY: <DF-API-KEY>'

응답

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=[]인 경우 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.indexWsInfo string 또는 object 로그 규칙 전용입니다. *는 전체를 의미하며, 그 외에는 원래 indexes 멤버를 동적 키로 사용합니다. 리소스가 없거나 정보를 가져올 수 없으면 하위 객체가 {}일 수 있습니다.
content.indexWsInfo.인덱스 식별자 object 구성된 인덱스 하나의 워크스페이스 및 인덱스 정보입니다.
content.indexWsInfo.인덱스 식별자.wsInfo object 소스 워크스페이스 정보이며 빈 객체일 수 있습니다.
content.indexWsInfo.인덱스 식별자.wsInfo.uuid string 소스 워크스페이스 UUID입니다.
content.indexWsInfo.인덱스 식별자.wsInfo.name string 소스 워크스페이스 이름입니다.
content.indexWsInfo.인덱스 식별자.wsInfo.status integer 워크스페이스 상태입니다.
content.indexWsInfo.인덱스 식별자.wsInfo.regionCode string 사이트 코드입니다.
content.indexWsInfo.인덱스 식별자.wsInfo.regionName string 또는 null 사이트 현지화 이름입니다.
content.indexWsInfo.인덱스 식별자.wsInfo.datastore object 선택 사항이며, 각 데이터 유형에 대응하는 스토리지 클래스 매핑입니다.
content.indexWsInfo.인덱스 식별자.wsInfo.datastore.데이터 유형 string 예를 들어 logging은 scopedb에 대응합니다. 쓰기 가능한 구성이 아닙니다.
content.indexWsInfo.인덱스 식별자.wsInfo.durationSet object 선택 사항이며, 각 데이터 유형의 보존 기간입니다.
content.indexWsInfo.인덱스 식별자.wsInfo.durationSet.데이터 유형 string 정수+d 형식의 기간 문자열이며 데이터 영역별로 구분됩니다.
content.indexWsInfo.인덱스 식별자.wsInfo.storagePolicy object 로그 소스 워크스페이스의 선택적 장기 정책 매핑입니다.
content.indexWsInfo.인덱스 식별자.wsInfo.storagePolicy.데이터 유형 object 해당 데이터 영역의 장기 정책입니다.
content.indexWsInfo.인덱스 식별자.wsInfo.storagePolicy.데이터 유형.isEnable boolean 장기 정책 활성화 여부입니다.
content.indexWsInfo.인덱스 식별자.wsInfo.storagePolicy.데이터 유형.duration string 장기 보존 기간입니다.
content.indexWsInfo.인덱스 식별자.indexInfo object 일반 인덱스의 전체 엔터티 또는 default 합성 하위 집합입니다. 이력/원격 정보에는 필드가 누락될 수 있으므로 전체를 그대로 다시 전송하여 쓰지 않아야 합니다.
content.indexWsInfo.인덱스 식별자.indexInfo.id integer 또는 null 데이터베이스 레코드 번호입니다. 생성 제출 전 스냅샷은 null일 수 있으며, 작업에는 uuid를 사용합니다.
content.indexWsInfo.인덱스 식별자.indexInfo.uuid string lgim_ 인덱스 구성 UUID이며, 기본 인덱스는 default를 사용합니다.
content.indexWsInfo.인덱스 식별자.indexInfo.workspaceUUID string 소속 워크스페이스입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.sourceIndexUUID string 클론 인덱스 B의 소스 A UUID입니다. 일반 인덱스는 비어 있습니다.
content.indexWsInfo.인덱스 식별자.indexInfo.name string 인덱스 이름입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.desc string 설명입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.conditions string extend에 따라 생성된 실제 조건 문자열이며, 일반 요청에서는 이 필드를 직접 수정하지 마세요.
content.indexWsInfo.인덱스 식별자.indexInfo.sortNo integer 또는 string 일치 순서 식별자입니다. 네이티브 직접 쓰기 또는 클론은 일반적으로 0입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.duration string 표준 스토리지 기간입니다. TLS의 경우 핫/콜드 아카이브 합산 일수입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.isBindCustomStore integer 또는 boolean 1/true이면 외부 스토리지에 바인딩됩니다.
content.indexWsInfo.인덱스 식별자.indexInfo.directIndex integer 또는 boolean 1/true이면 네이티브 직접 쓰기입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.isFullLineIndex integer 1은 전체 행, 0은 Message입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.queryType string 쿼리 유형입니다. 예: logging/standard 또는 외부 SLS가 반환하는 모드.
content.indexWsInfo.인덱스 식별자.indexInfo.exterStoreProject string 외부 프로젝트/데이터베이스 식별자이며, 내부 인덱스는 일반적으로 비어 있습니다.
content.indexWsInfo.인덱스 식별자.indexInfo.exterStoreName string 외부 리소스 이름이며, 내부는 일반적으로 비어 있습니다.
content.indexWsInfo.인덱스 식별자.indexInfo.externalResourceAccessCfgUUID string 액세스 구성 식별자이며 자격 증명 원문이 아닙니다.
content.indexWsInfo.인덱스 식별자.indexInfo.storeType string 내부 인덱스는 일반적으로 비어 있으며, 외부에 바인딩된 경우 실제 유형입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.region string 외부 리전 코드입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.isPublicNetworkAccess integer 또는 boolean 공용 네트워크 액세스 플래그입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.status integer 0 활성화, 2 비활성화, 3 삭제입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.creator string 생성 주체입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.updator string 최근 업데이트 주체입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.createAt integer 생성 Unix 초입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.updateAt integer 업데이트 Unix 초이며, 업데이트되지 않은 경우 -1입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.deleteAt integer 삭제 Unix 초이며, 삭제되지 않은 경우 -1입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.storagePolicy object 선택적 전체 장기 정책 객체입니다. 일반 신규 생성 시 {}를 생략하며, 수정 시 생략하면 유지되고 {}는 비활성화로 정규화됩니다. 명시적 비활성화는 longStorageEnabled=false를 사용합니다. 장기 기간은 표준 duration보다 엄격히 커야 하며 단위는 여전히 일입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.storagePolicy.longStorageEnabled boolean 객체 내에서 생략하면 기본값 false입니다. 비활성화하면 longStorageDuration이 빈 값으로 정규화되며, 이는 과거 데이터를 즉시 삭제한다는 의미가 아닙니다.
content.indexWsInfo.인덱스 식별자.indexInfo.storagePolicy.longStorageDuration string 활성화 시 조건부 필수입니다. 필드는 d를 포함한 문자열이며 초/시간이 아닙니다. 메트릭 rp의 3600d 범위를 로그에 적용하지 마세요.
content.indexWsInfo.인덱스 식별자.indexInfo.setting object TLS 신규 생성 시 hot_retention을 반드시 제공해야 합니다. 전체 duration은 세 시간 수의 합을 일 단위로 환산합니다. 일반 수정 시 setting을 제공할 때는 핫 스토리지와 필요한 단계를 완전히 제공하고 cold_retention만 전달하지 마세요. 기타 스토리지는 이 필드를 TLS로 해석하지 않습니다.
content.indexWsInfo.인덱스 식별자.indexInfo.setting.hot_retention integer TLS 조건부 필수이며, 기본 범위는 1~1800일로 24..43200시간에 대응하고 24의 배수입니다. 콜드 스토리지를 사용하면 핫 스토리지는 최소 7일, 아카이브를 사용하면 최소 30일입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.setting.cold_retention integer 선택 사항이며, 기본 30..1800일이고 일 단위에 해당하는 시간 수입니다. 0을 사용하여 생략을 나타내지 않으며, 총합은 1800일을 초과하지 않습니다.
content.indexWsInfo.인덱스 식별자.indexInfo.setting.archive_retention integer 선택 사항이며, 기본 60..1800일이고 일 단위에 해당하는 시간 수입니다. 핫 스토리지는 최소 30일이며 총합은 1800일을 초과하지 않습니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend object 선택적 확장 객체이며 실제 일치 및 표시 구성을 포함합니다. 일반 modify는 첫 번째 수준 키 기준으로 병합하고, 제공되지 않은 키는 유지하며, 배열 또는 중첩 객체는 전체 교체합니다. {}는 기존 filters를 지우지 않습니다. null을 피하세요. 일부 수정 분기에서 500이 발생할 수 있습니다. 가져오기 recover는 extend를 전체 교체합니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.matchMode string 생략/빈 값이면 basic으로 처리됩니다. advanced는 advancedFilter를 사용하고 basic은 filters를 사용하며, 모드 전환 시 해당 전체 조건을 함께 제공하세요.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.filters array basic의 리프 배열이며, 비어 있지 않은 조건은 conditions를 생성합니다. 신규 생성/수정 basic에서는 operation이 match 또는 not match인 것을 명시적으로 거부합니다. 텍스트 포함 등 복잡한 의미는 advanced의 해당 연산을 우선 사용하세요.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.filters[].name string 실제 필드 이름이며 백틱을 추가하지 않습니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.filters[].condition string 이전 조건과의 and/or 관계이며, 첫 항목의 연결자는 무시됩니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.filters[].operation string 일반적으로 =, !=, in, not_in, >, >=, <, <=, regexp, not_regexp, wildcard, not_wildcard, exist, not_exist를 사용합니다. basic에서는 match/not match를 금지합니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.filters[].value array 조건 값 배열이며, = 및 비교는 첫 항목을 사용합니다. 존재 계열도 비어 있지 않은 자리 표시자 배열을 권장합니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.filters[] json 조건 객체이며, 필드 이름/연산/값이 완전해야 합니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.filters[].value[] JSON 단일 비교 값이며 표시 이름을 실제 값 대신 사용하지 마세요.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.advancedFilter json advanced일 때 필수인 루트 group 객체입니다. 그룹은 type=group, condition, filters를 사용하고, 리프는 type=rule, name, operation, value를 사용합니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.advancedFilter.type string 루트 노드 유형이며 rule일 수 없습니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.advancedFilter.condition string 같은 그룹 하위 조건의 논리 관계입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.advancedFilter.filters array 하위 노드 배열이며 동일한 group 구조의 중첩을 허용합니다. 빈 그룹은 빈 조건을 생성합니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.advancedFilter.filters[] json rule 리프 또는 group 객체입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.advancedFilter.filters[].type string rule은 리프, group은 재귀 그룹입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.advancedFilter.filters[].name string rule 필수이며 비어 있지 않은 필드 이름입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.advancedFilter.filters[].operation string rule은 =, !=, in, not_in, match, not_match, wildcard, not_wildcard, regexp, not_regexp, >, <, >=, <=, exist, not_exist를 허용합니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.advancedFilter.filters[].value array rule 필수 배열입니다. exist/not_exist는 []를 사용할 수 있지만 나머지는 빈 배열을 허용하지 않습니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.advancedFilter.filters[].condition string group 하위 그룹은 and/or를 사용합니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.advancedFilter.filters[].filters array group 하위 그룹의 재귀 배열이며 규칙 리프에서는 생략합니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.advancedFilter.filters[].value[] JSON 단일 문자열 또는 숫자 값입니다. regexp 값에는 백틱이 포함되지 않습니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.extendFields array 선택적 핵심 필드 배열입니다. tag/alias 구조로 제출해야 하며 tag는 비어 있지 않아야 합니다. 신규 추가 시 이 구조 검증이 강제되지 않지만 수정 시 검증합니다. 가져오기는 필드 가속 스위치에 따라 필드 인덱스를 추가로 동기화하며, 직접 modify는 이 구성만 저장합니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.extendFields[] json tag/alias 키만 허용합니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.extendFields[].tag string 조건부 필수이며 비어 있지 않은 키입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.extendFields[].alias string 선택적 표시 별칭입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.topFields array 선택적 표시 구성이며 동일한 tag/alias 객체로 사용합니다. 일반 modify는 독립적인 상단 고정 API가 아닙니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.topFields[] json 단일 표시 필드 객체입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.topFields[].tag string 필드 키입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.topFields[].alias string 선택적 별칭입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.services array 선택적 응답 표시 정보이며 filters의 실제 일치 조건을 대체하지 않습니다.
content.indexWsInfo.인덱스 식별자.indexInfo.extend.services[] string 단일 서비스 표시 값입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.workspaceName string 소스 워크스페이스 이름이며 생략할 수 있습니다.
content.indexWsInfo.인덱스 식별자.indexInfo.workspaceStatus integer 소스 워크스페이스 상태이며 생략할 수 있습니다.
content.indexWsInfo.인덱스 식별자.indexInfo.regionCode string 소스 사이트 코드입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.regionName string 또는 null 소스 사이트 이름입니다.
content.indexWsInfo.인덱스 식별자.indexInfo.grantStatus integer 선택 사항이며, 3은 현재 권한 부여를 사용할 수 없음을 나타냅니다. 표시되지 않는다고 다른 액세스 조건이 충족된다는 보장은 없습니다.
content.relRoleInfos array<object> 읽기 시 일치하는 역할 요약입니다. *는 유효한 Owner가 아닌 역할을 확장하며, 지정한 역할은 이력 status 또는 {}를 반환할 수 있습니다.
content.relRoleInfos[] object 단일 역할 요약이며 찾을 수 없으면 {}일 수 있습니다.
content.relRoleInfos[].uuid string 역할 UUID이며 생략할 수 있습니다.
content.relRoleInfos[].name string 역할 이름이며 생략할 수 있습니다.
content.relRoleInfos[].status integer 역할 상태이며 생략할 수 있습니다.
content.regionName string 또는 null 소스 사이트 현지화 이름이며, 찾을 수 없으면 null일 수 있습니다.
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": "",
    "createAt": 1785427200,
    "updateAt": -1,
    "deleteAt": -1,
    "indexWsInfo": {
      "default": {
        "wsInfo": {},
        "indexInfo": {}
      }
    },
    "regionName": "예시 사이트",
    "relRoleInfos": [
      {
        "uuid": "role_example",
        "name": "프로덕션 쿼리",
        "status": 0
      }
    ],
    "declaration": {}
  },
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-EXAMPLE"
}

오류 응답

인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참조하세요.

HTTP 상태 errorCode 트리거 조건 메시지 또는 응답 설명 처리 방법
404 ft.NotFoundDataQueryRuleCfg 본 워크스페이스에서 지정한 삭제되지 않은 규칙을 찾을 수 없거나 로그 엔드포인트의 대상이 logging이 아님 지정한 로그 쿼리 규칙 구성을 찾을 수 없음 해당 목록에서 UUID를 다시 가져옵니다.
404 ft.NoInitOtherNodeCfg 원격 인덱스/RUM 애플리케이션 메타데이터를 읽거나 검증할 때 사용 가능한 소스 사이트 주소를 찾을 수 없음 기타 노드 구성이 초기화되지 않음 관리자가 소스 사이트 구성, 액세스 가능한 주소 및 유효한 교차 워크스페이스 권한 부여를 확인하고 수정한 후 다시 시도합니다.
500 ft.InternalServerError 규칙, 역할, 소스 워크스페이스 또는 인덱스/애플리케이션 메타데이터 읽기 및 포맷팅 실패 내부 오류 권한이 부여된 소스 및 사이트 정보를 새로 고친 후 나중에 다시 시도합니다. 계속 실패하면 traceId를 제공합니다.

문서 평가

이 페이지가 도움이 되었나요?