콘텐츠로 이동

목록 조회



GET /api/v1/logging_query_rule/list

개요

로그 액세스 규칙과 해당 규칙의 소스 및 활성화/비활성화 설정을 페이지 단위로 읽습니다.

호출 전 및 사용 단계

현재 워크스페이스의 삭제되지 않은 규칙을 조회하며, 비활성화 항목을 포함하고 createAt 내림차순으로 정렬합니다. 이 공개 엔드포인트는 pageIndex/pageSize만 지원하며 내부 search 또는 effectiveRulesForCurAcnt는 지원하지 않습니다. 프런트엔드에서만 활성화되는 구성원 수/구성원 및 역할 확장 정보는 반환하지 않습니다.

규칙 저장은 이후 조건에 부합하는 ID의 데이터 쿼리 범위/결과 마스킹에 영향을 주며, 원본 데이터를 수정, 삭제 또는 추가 수집하지 않고 역할의 기본 쿼리 권한도 추가하지 않습니다. 여러 역할 및 규칙은 쿼리 측 정책에 따라 병합되며, 단일 규칙만으로 최종 권한을 추론할 수 없습니다. Owner는 예외이며, 관리자 및 워크스페이스의 "데이터 액세스 범위 제한" 설정은 일치하는 역할이 없을 때의 처리를 변경하므로 대표 구성원의 실제 쿼리로 검증해야 합니다. 저장 후 규칙 캐시가 무효화되지만, 진행 중인 모든 쿼리가 즉시 전환됨을 보장할 수는 없습니다.

요청 헤더

매개변수 이름 유형 필수 설명
DF-API-KEY string Y 워크스페이스의 OpenAPI 인증 자격 증명입니다.
예: <DF-API-KEY>
획득 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다.

Query 요청 매개변수

매개변수 이름 유형 필수 설명
pageIndex integer 선택 사항, 기본값 1, 최솟값이 선언되어 있지 않으며 호출자는 양의 정수를 선택해야 합니다.
null 허용: False
예: 1
획득 또는 입력 방법: 1부터 시작하여 최상위 pageInfo를 기준으로 계속 진행합니다.
pageSize integer 선택 사항, 기본값 50, 선언된 최댓값 없음; 작은 페이지는 반환량을 줄이지만 현재 구현은 먼저 모든 일치 규칙을 읽은 후 페이지를 나누므로 페이지별 조회를 권장합니다.
null 허용: False
예: 50
획득 또는 입력 방법: 클라이언트 용량에 따라 50과 같은 적절한 양의 정수를 선택합니다.

요청 예시

curl --get 'https://openapi.guance.com/api/v1/logging_query_rule/list' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  --data-urlencode pageIndex=1 \
  --data-urlencode pageSize=50

응답

HTTP 200, application/json. 아래 예시는 직접 읽을 수 있는 주요 필드를 보여줍니다.

필드 유형 설명
content.data array<object> 이 페이지의 규칙이며, 결과가 없으면 []입니다.
content.data[].id integer 또는 null 레코드 번호입니다. 생성 응답은 제출 전 스냅샷을 반환하므로 null일 수 있으며, 후속 작업에는 uuid를 사용합니다.
content.data[].uuid string lqrl_규칙 UUID이며, 두 모듈이 엔터티와 식별자를 공유합니다.
content.data[].workspaceUUID string 이 규칙이 속한 워크스페이스이며, 소스 워크스페이스와 구분됩니다.
content.data[].status integer 0 활성화, 2 비활성화, 3 삭제. 이 모듈은 삭제되지 않은 항목만 읽습니다.
content.data[].creator string 생성자 ID입니다.
content.data[].updator string 최근 업데이트 ID이며, 초기에는 비어 있을 수 있습니다.
content.data[].createAt integer 생성 Unix 초입니다.
content.data[].updateAt integer 업데이트 Unix 초이며, 업데이트되지 않은 경우 -1입니다.
content.data[].deleteAt integer 삭제 Unix 초이며, 삭제되지 않은 경우 -1입니다.
content.data[].name string 저장 값: 생략할 수 있습니다. 누락되었거나 빈 문자열이면 호출 ID의 표시 이름과 현재 Unix 초를 기준으로 생성을 시도하며, 수정 시에도 동일하게 다시 생성되고 이전 이름을 유지하지 않습니다. 최대 64 계수 단위(ASCII/반각 가타카나 1, 기타 문자 2)입니다. 활성화 및 비활성화된 동일 유형 규칙 모두 중복 이름 검사에 포함됩니다.
content.data[].desc string 저장 값: 선택 사항, 최대 256(위와 동일한 계수 단위), 누락/빈 문자열이면 빈 값으로 초기화됩니다. 수정 시 기존 값을 유지하지 않습니다.
content.data[].indexes array 저장 값: 로그 규칙은 명시적으로 제공해야 하며, 이 모듈에서는 필수로 선언되어 있습니다. ["*"]는 사용 가능한 모든 로그 인덱스를 의미합니다. *는 단독으로 사용하는 것을 권장하며, []는 전체를 의미하지 않습니다. keyevent는 []로 강제 저장되고, 기타 비로그 유형은 일반적으로 []를 사용합니다. 일반 인덱스 이름으로 UUID를 대체할 수 없으며, 권한 부여가 자동 생성되지 않습니다. 저장 성공이 원격의 모든 리소스가 여전히 유효함을 증명하지는 않습니다.
content.data[].indexes[] string 저장 값: 배열 요소는 비어 있지 않은 문자열을 권장합니다. 원래 선언에서 항목별로 강제하지 않았으며, 잘못된 유형은 500을 발생시킬 수 있습니다.
content.data[].roleUUIDs array 저장 값: 필수 배열입니다. ["*"]는 각 역할을 의미하며, Owner는 여전히 데이터 액세스 제한을 받지 않습니다. []는 어떤 역할과도 일치하지 않으며 전체를 의미하지 않습니다. 이벤트 keyevent는 비어 있지 않은 문자열 배열이어야 하며, *는 단독으로만 나타날 수 있습니다. 기타 유형은 범위 내 역할의 존재를 검증하지만 역할 status=0을 보장하지는 않습니다. 기본 쿼리 권한은 여전히 별도로 갖추어야 합니다.
content.data[].roleUUIDs[] string 저장 값: 유효한 역할을 사용해야 하며, 계정 UUID를 사용하지 마십시오.
content.data[].conditions string 저장 값: 필터 표현식만 입력하고 전체 쿼리나 바깥쪽 중괄호는 입력하지 않습니다. 이 모듈에서는 필수 문자열로 선언되어 있습니다. 4048자를 넘지 않는 것을 권장합니다. keyevent는 Python 문자 수 ≤4048을 기준으로 E 쿼리 구문을 구문 분석하며, 기타 유형은 저장 시 조건 의미를 전면적으로 검증하지 않으므로 성공이 향후 쿼리 성공을 보장하지 않습니다. 이 규칙은 액세스가 허용되는 데이터 범위를 정의합니다.
content.data[].extend json 저장 값: 선택적 임의 JSON을 그대로 반환하며 기본값은 {}입니다. 통일된 필수 하위 키나 단위가 없고, 서버가 이 값에서 conditions를 자동 생성하지 않으며, 수정 시 전체가 교체됩니다. 자격 증명을 저장하지 마십시오.
content.data[].extend.自定义键 any 저장 값: 직렬화 가능한 임의의 JSON 값입니다. 추가로 적용되는 조건이 아닙니다.
content.data[].logic string 저장 값: 호환성을 위해 반환되는 필드이며 일반적으로 and/or입니다. 추가 시 필수로 선언되지만 수정 시 생략할 수 있습니다. 생략하면 빈 문자열로 저장됩니다. 실제 적용되는 필터는 conditions를 직접 사용하며, logic을 변경해도 조건이 다시 작성되지 않습니다. 다중 역할/다중 규칙 병합은 이 필드로 제어되지 않습니다.
content.data[].maskFields string 저장 값: 선택 사항이며, 누락 시 빈 문자열로 이 규칙의 필드 마스킹이 구성되지 않습니다. 수정 시 생략하면 비워집니다. 필드를 선택했고 reExprs=[]이면 null이 아닌 값의 전체 필드가 ***로 마스킹됩니다. 비어 있지 않은 정규식 목록을 제공하면 활성화된 정규식만 적용되며, 모두 비활성화된 것은 전체 필드 마스킹과 같지 않습니다. 저장 열에 맞게 256자 이하를 권장합니다.
content.data[].reExprs array 저장 값: 선택 사항, 기본값 [], 수정 시 전체 교체. 저장 시 각 정규식을 검증하며 enable=false 항목도 포함합니다. 잘못된 정규식은 ft.ErrorRegularExpression을 반환합니다. 단독 *로 임의 문자열을 표현하지 말고 .*를 사용하십시오. 선택한 필드에 정규식이 없으면 전체 필드가 ***가 됩니다. 정규식은 문자열 내용의 일치 부분만 처리하며 일치 내용을 ***로 바꿉니다. 저장 검증과 실행 엔진 간에는 차이가 있으므로 저장 성공 후에도 대표 쿼리로 검증해야 합니다.
content.data[].reExprs[] json 저장 값: name/enable/reExpr만 사용하는 것을 권장합니다. 배열 요소의 구조는 원래 선언에서 강제되지 않았으며, 객체가 아니면 500이 발생할 수 있습니다.
content.data[].reExprs[].name string 저장 값: 선택적 반환 이름이며 일치 표현식으로 사용되지 않으므로 생략해도 정규식 일치에 영향을 주지 않습니다.
content.data[].reExprs[].enable boolean 저장 값: 명시적 부울을 권장하며, 누락 시 비활성화로 처리됩니다. 비활성화된 정규식도 구문이 유효해야 합니다.
content.data[].reExprs[].reExpr string 저장 값: 비어 있지 않은 정규식을 권장합니다. 현재 누락 시 빈 문자열로 검사되며, 서버가 유효한 표현식을 보완할 것이라고 의존할 수 없습니다.
content.data[].sources array 저장 값: 비로그 범위 배열입니다. ["*"]는 사용 가능한 모든 소스를 의미하며, []를 생략하더라도 전체를 의미하지 않습니다. logging은 []로 강제 저장됩니다. rum/lineage는 권한이 부여된 워크스페이스 UUID:소스 식별자로 제한할 수 있으며, tracing/metric/keyevent는 원시 소스 문자열을 사용합니다. keyevent는 비어 있지 않은 문자열 배열이어야 하고 wksp_:소스를 허용하지 않으며, *는 다른 값과 혼용할 수 없습니다. rum은 현재 regionCode를 명시한 경우에만 쿼리 시 애플리케이션 존재를 확인하며, 기타 소스는 저장 성공이 실제 데이터 존재를 증명하지 않습니다.
content.data[].sources[] string 저장 값: 상위 type에 따라 해석되는 단일 소스이며, 비어 있지 않은 문자열을 권장합니다.
content.data[].type string 저장 값: 추가 시 logging/rum/tracing/metric/lineage/keyevent가 필수입니다. 선언상 null이 허용되지만 유효하지 않은 유형은 정상적인 쿼리 규칙을 형성할 수 없으므로 항상 위 문자열을 제출해야 합니다. 수정 시 type을 허용하지 않으며 저장된 유형을 따릅니다.
content.data[].regionCode string 저장 값: v2에서 소스 사이트 코드가 필수로 선언되며, 동일 규칙의 로그 인덱스는 동일 사이트에 속해야 하고 이 값과 일치해야 합니다. 이전 엔드포인트는 이 필드를 허용하지 않습니다. 데이터 액세스 규칙은 사이트 간/워크스페이스 간 권한 부여를 대체하지 않습니다. 이벤트의 사이트 간 접근에는 keyevent 또는 *를 포함하는 유효한 권한 부여가 있어야 합니다. 아래 중복 라우트의 실제 도달 가능성 설명에 유의하십시오.
content.data[].indexWsInfo string 또는 object 로그 규칙 전용: *는 전체를 의미하며, 그렇지 않으면 원래 indexes 구성원을 동적 키로 사용합니다. 리소스가 없거나 정보를 가져올 수 없으면 하위 객체가 {}일 수 있습니다.
content.data[].indexWsInfo.索引标识 object 구성된 인덱스의 워크스페이스 및 인덱스 정보입니다.
content.data[].indexWsInfo.索引标识.wsInfo object 소스 워크스페이스 정보이며 빈 객체일 수 있습니다.
content.data[].indexWsInfo.索引标识.wsInfo.uuid string 소스 워크스페이스 UUID입니다.
content.data[].indexWsInfo.索引标识.wsInfo.name string 소스 워크스페이스 이름입니다.
content.data[].indexWsInfo.索引标识.wsInfo.status integer 워크스페이스 상태입니다.
content.data[].indexWsInfo.索引标识.wsInfo.regionCode string 사이트 코드입니다.
content.data[].indexWsInfo.索引标识.wsInfo.regionName string 또는 null 사이트 현지화 이름입니다.
content.data[].indexWsInfo.索引标识.wsInfo.datastore object 선택 사항이며, 각 데이터 유형에 대응하는 스토리지 클래스 매핑입니다.
content.data[].indexWsInfo.索引标识.wsInfo.datastore.数据类型 string 예를 들어 logging은 scopedb에 대응합니다. 쓰기 가능한 구성이 아닙니다.
content.data[].indexWsInfo.索引标识.wsInfo.durationSet object 선택 사항이며, 각 데이터 유형의 보존 기간입니다.
content.data[].indexWsInfo.索引标识.wsInfo.durationSet.数据类型 string 정수+d 형식의 기간 문자열입니다. 데이터 영역별로 구분됩니다.
content.data[].indexWsInfo.索引标识.wsInfo.storagePolicy object 로그 소스 워크스페이스의 선택적 장기 정책 매핑입니다.
content.data[].indexWsInfo.索引标识.wsInfo.storagePolicy.数据类型 object 해당 데이터 영역의 장기 정책입니다.
content.data[].indexWsInfo.索引标识.wsInfo.storagePolicy.数据类型.isEnable boolean 장기 정책 활성화 여부입니다.
content.data[].indexWsInfo.索引标识.wsInfo.storagePolicy.数据类型.duration string 장기 보존 기간입니다.
content.data[].indexWsInfo.索引标识.indexInfo object 일반 인덱스의 전체 엔터티 또는 default 합성 하위 집합입니다. 이전/원격 정보에는 필드가 누락될 수 있으므로 전체를 그대로 다시 전송하여 쓰기해서는 안 됩니다.
content.data[].indexWsInfo.索引标识.indexInfo.id integer 또는 null 데이터베이스 레코드 번호입니다. 생성 제출 전 스냅샷은 null일 수 있으며, 작업에는 uuid를 사용합니다.
content.data[].indexWsInfo.索引标识.indexInfo.uuid string lgim_인덱스 구성 UUID이며, 기본 인덱스는 default를 사용합니다.
content.data[].indexWsInfo.索引标识.indexInfo.workspaceUUID string 소속 워크스페이스입니다.
content.data[].indexWsInfo.索引标识.indexInfo.sourceIndexUUID string 클론 인덱스 B의 소스 A UUID입니다. 일반 인덱스는 비어 있습니다.
content.data[].indexWsInfo.索引标识.indexInfo.name string 인덱스 이름입니다.
content.data[].indexWsInfo.索引标识.indexInfo.desc string 설명입니다.
content.data[].indexWsInfo.索引标识.indexInfo.conditions string extend에 따라 생성된 실제 조건 문자열이며, 일반 요청에서는 이 필드를 직접 수정하지 마십시오.
content.data[].indexWsInfo.索引标识.indexInfo.sortNo integer 또는 string 일치 순서 식별자입니다. 네이티브 직접 쓰기 또는 클론은 일반적으로 0입니다.
content.data[].indexWsInfo.索引标识.indexInfo.duration string 표준 스토리지 기간입니다. TLS는 핫/콜드 아카이브 합계 일수입니다.
content.data[].indexWsInfo.索引标识.indexInfo.isBindCustomStore integer 또는 boolean 1/true이면 외부 스토리지에 바인딩됩니다.
content.data[].indexWsInfo.索引标识.indexInfo.directIndex integer 또는 boolean 1/true이면 네이티브 직접 쓰기입니다.
content.data[].indexWsInfo.索引标识.indexInfo.isFullLineIndex integer 1은 전체 행, 0은 Message입니다.
content.data[].indexWsInfo.索引标识.indexInfo.queryType string 쿼리 유형입니다. 예를 들어 logging/standard 또는 외부 SLS가 반환하는 모드입니다.
content.data[].indexWsInfo.索引标识.indexInfo.exterStoreProject string 외부 프로젝트/데이터베이스 식별자이며, 내부 인덱스는 일반적으로 비어 있습니다.
content.data[].indexWsInfo.索引标识.indexInfo.exterStoreName string 외부 리소스 이름이며, 내부는 일반적으로 비어 있습니다.
content.data[].indexWsInfo.索引标识.indexInfo.externalResourceAccessCfgUUID string 액세스 구성 식별자이며 자격 증명 원문이 아닙니다.
content.data[].indexWsInfo.索引标识.indexInfo.storeType string 내부 인덱스는 일반적으로 비어 있고, 외부 바인딩 시 실제 유형입니다.
content.data[].indexWsInfo.索引标识.indexInfo.region string 외부 리전 코드입니다.
content.data[].indexWsInfo.索引标识.indexInfo.isPublicNetworkAccess integer 또는 boolean 공용 네트워크 액세스 플래그입니다.
content.data[].indexWsInfo.索引标识.indexInfo.status integer 0 활성화, 2 비활성화, 3 삭제.
content.data[].indexWsInfo.索引标识.indexInfo.creator string 생성자 ID입니다.
content.data[].indexWsInfo.索引标识.indexInfo.updator string 최근 업데이트 ID입니다.
content.data[].indexWsInfo.索引标识.indexInfo.createAt integer 생성 Unix 초입니다.
content.data[].indexWsInfo.索引标识.indexInfo.updateAt integer 업데이트 Unix 초이며, 업데이트되지 않은 경우 -1입니다.
content.data[].indexWsInfo.索引标识.indexInfo.deleteAt integer 삭제 Unix 초이며, 삭제되지 않은 경우 -1입니다.
content.data[].indexWsInfo.索引标识.indexInfo.storagePolicy object 선택적 전체 장기 정책 객체입니다. 일반 생성 시 {}를 생략하며, 수정 시 생략하면 유지되고 {}는 비활성화로 정규화되며, 명시적 비활성화는 longStorageEnabled=false를 사용합니다. 장기 기간은 표준 duration보다 엄격히 커야 하며 단위는 여전히 일 단위입니다.
content.data[].indexWsInfo.索引标识.indexInfo.storagePolicy.longStorageEnabled boolean 객체 내에서 생략 시 기본값은 false입니다. 비활성화하면 longStorageDuration이 빈 값으로 정규화되지만, 기존 이력 데이터가 즉시 삭제됨을 의미하지는 않습니다.
content.data[].indexWsInfo.索引标识.indexInfo.storagePolicy.longStorageDuration string 활성화 시 조건부 필수입니다. 필드는 d를 포함한 문자열이며 초/시간이 아니고, 메트릭 rp의 3600d 범위를 로그에 적용해서는 안 됩니다.
content.data[].indexWsInfo.索引标识.indexInfo.setting object TLS 생성 시 hot_retention을 반드시 제공해야 하며, 총 duration은 세 시간 수의 합을 일 단위로 환산합니다. 일반 수정 시 setting을 제공하면 핫 스토리지 및 필요한 단계를 완전히 제공해야 하며 cold_retention만 전달해서는 안 됩니다. 기타 스토리지는 이 필드를 TLS로 해석하지 않습니다.
content.data[].indexWsInfo.索引标识.indexInfo.setting.hot_retention integer TLS 조건부 필수이며, 기본 범위는 1~1800일로 24..43200시간에 대응하고 24의 배수입니다. 콜드 스토리지를 사용하면 핫 스토리지는 최소 7일, 아카이브를 사용하면 최소 30일입니다.
content.data[].indexWsInfo.索引标识.indexInfo.setting.cold_retention integer 선택 사항이며 기본 범위는 30..1800일이고 하루 단위의 정수 시간 수입니다. 0을 사용하여 생략을 표현하지 않으며, 합계는 1800일을 초과할 수 없습니다.
content.data[].indexWsInfo.索引标识.indexInfo.setting.archive_retention integer 선택 사항이며 기본 범위는 60..1800일이고 하루 단위의 정수 시간 수입니다. 핫 스토리지는 최소 30일이고 합계는 1800일을 초과할 수 없습니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend object 선택적 확장 객체이며 실제 일치 및 표시 구성을 포함합니다. 일반 modify는 1차 키 기준으로 병합하고 제공되지 않은 키는 유지하며, 배열 또는 중첩 객체는 전체 교체됩니다. {}는 기존 filters를 지우지 않습니다. null을 피하십시오. 일부 수정 분기에서는 500이 발생할 수 있습니다. 가져오기 recover는 extend를 전체 교체합니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.matchMode string 생략/빈 값은 basic으로 처리됩니다. advanced는 advancedFilter를 사용하고 basic은 filters를 사용하며, 모드를 전환할 때 해당 전체 조건을 함께 제공해야 합니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.filters array basic의 리프 배열이며, 비어 있지 않은 조건은 conditions를 생성합니다. 생성/수정 basic에서는 operation이 match 또는 not match인 것을 명시적으로 거부합니다. 텍스트 포함 등 복잡한 의미는 advanced의 해당 연산을 우선 사용하십시오.
content.data[].indexWsInfo.索引标识.indexInfo.extend.filters[].name string 실제 필드 이름이며 백틱을 추가하지 않습니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.filters[].condition string 이전 조건과의 and/or 관계이며, 첫 항목의 연결자는 무시됩니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.filters[].operation string 일반적으로 =, !=, in, not_in, >, >=, <, <=, regexp, not_regexp, wildcard, not_wildcard, exist, not_exist를 사용합니다. basic에서는 match/not match가 금지됩니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.filters[].value array 조건 값 배열입니다. = 및 비교는 첫 항목을 사용하며, 존재 유형은 여전히 비어 있지 않은 자리 표시자 배열을 권장합니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.filters[] json 조건 객체입니다. 필드 이름/연산/값이 완전해야 합니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.filters[].value[] JSON 단일 비교 값이며 표시 이름으로 실제 값을 대체하지 마십시오.
content.data[].indexWsInfo.索引标识.indexInfo.extend.advancedFilter json advanced 시 필수인 루트 group 객체입니다. 그룹은 type=group, condition, filters를 사용하고 리프는 type=rule, name, operation, value를 사용합니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.advancedFilter.type string 루트 노드 유형이며 rule일 수 없습니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.advancedFilter.condition string 동일 그룹 하위 조건의 논리 관계입니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.advancedFilter.filters array 하위 노드 배열이며 동일한 group 구조의 중첩을 허용합니다. 빈 그룹은 빈 조건을 생성합니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.advancedFilter.filters[] json rule 리프 또는 group 객체입니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.advancedFilter.filters[].type string rule은 리프, group은 재귀 그룹입니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.advancedFilter.filters[].name string rule 필수이며 비어 있지 않은 필드 이름입니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.advancedFilter.filters[].operation string rule에서 허용되는 연산은 =, !=, in, not_in, match, not_match, wildcard, not_wildcard, regexp, not_regexp, >, <, >=, <=, exist, not_exist입니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.advancedFilter.filters[].value array rule 필수 배열입니다. exist/not_exist는 []를 사용할 수 있지만 나머지는 빈 배열을 허용하지 않습니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.advancedFilter.filters[].condition string group 하위 그룹에서 and/or를 사용합니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.advancedFilter.filters[].filters array group 하위 그룹의 재귀 배열이며 규칙 리프에서는 생략합니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.advancedFilter.filters[].value[] JSON 단일 문자열 또는 숫자입니다. regexp 값에는 백틱이 포함되지 않습니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.extendFields array 선택적 키 필드 배열입니다. tag/alias 구조로 제출하고 tag는 비어 있지 않아야 합니다. 추가 시 이 구조 검증이 강제되지 않지만 수정 시 검증합니다. 가져오기는 필드 가속 스위치에 따라 필드 인덱스를 추가로 동기화하며, 직접 modify는 이 구성만 저장합니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.extendFields[] json tag/alias 키만 허용합니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.extendFields[].tag string 조건부 필수이며 비어 있지 않은 키입니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.extendFields[].alias string 선택적 표시 별칭입니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.topFields array 선택적 표시 구성이며 동일한 tag/alias 객체로 사용합니다. 일반 modify는 독립적인 상단 고정 인터페이스가 아닙니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.topFields[] json 단일 표시 필드 객체입니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.topFields[].tag string 필드 키입니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.topFields[].alias string 선택적 별칭입니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.services array 선택적 반환 정보이며 filters의 실제 일치 조건을 대체하지 않습니다.
content.data[].indexWsInfo.索引标识.indexInfo.extend.services[] string 단일 서비스 표시 값입니다.
content.data[].indexWsInfo.索引标识.indexInfo.workspaceName string 소스 워크스페이스 이름이며 생략할 수 있습니다.
content.data[].indexWsInfo.索引标识.indexInfo.workspaceStatus integer 소스 워크스페이스 상태이며 생략할 수 있습니다.
content.data[].indexWsInfo.索引标识.indexInfo.regionCode string 소스 사이트 코드입니다.
content.data[].indexWsInfo.索引标识.indexInfo.regionName string 또는 null 소스 사이트 이름입니다.
content.data[].indexWsInfo.索引标识.indexInfo.grantStatus integer 선택 사항이며, 3은 현재 권한 부여를 사용할 수 없음을 의미합니다. 표시되지 않는다고 해서 다른 액세스 조건이 충족됨을 보장하지는 않습니다.
content.data[].creatorInfo object ID 요약이며, 확인 가능한 정보가 없으면 {}입니다.
content.data[].creatorInfo.uuid string ID UUID이며 생략할 수 있습니다.
content.data[].creatorInfo.status integer 계정 상태이며 생략할 수 있습니다.
content.data[].creatorInfo.wsAccountStatus integer 구성원 관계 상태이며 생략할 수 있습니다.
content.data[].creatorInfo.name string 표시 이름입니다.
content.data[].creatorInfo.username string 로그인 이름입니다.
content.data[].creatorInfo.email string 이메일 또는 시스템 ID 식별자입니다.
content.data[].creatorInfo.mobile string 휴대폰 번호이며 비어 있을 수 있습니다.
content.data[].creatorInfo.countryCode string 국가/지역 코드이며 생략할 수 있습니다.
content.data[].creatorInfo.iconUrl string 아바타 주소이며 생략할 수 있습니다.
content.data[].creatorInfo.acntWsNickname string 이 워크스페이스 닉네임이며 생략할 수 있습니다.
content.data[].updatorInfo object ID 요약이며, 확인 가능한 정보가 없으면 {}입니다.
content.data[].updatorInfo.uuid string ID UUID이며 생략할 수 있습니다.
content.data[].updatorInfo.status integer 계정 상태이며 생략할 수 있습니다.
content.data[].updatorInfo.wsAccountStatus integer 구성원 관계 상태이며 생략할 수 있습니다.
content.data[].updatorInfo.name string 표시 이름입니다.
content.data[].updatorInfo.username string 로그인 이름입니다.
content.data[].updatorInfo.email string 이메일 또는 시스템 ID 식별자입니다.
content.data[].updatorInfo.mobile string 휴대폰 번호이며 비어 있을 수 있습니다.
content.data[].updatorInfo.countryCode string 국가/지역 코드이며 생략할 수 있습니다.
content.data[].updatorInfo.iconUrl string 아바타 주소이며 생략할 수 있습니다.
content.data[].updatorInfo.acntWsNickname string 이 워크스페이스 닉네임이며 생략할 수 있습니다.
content.declaration object 공통 선언입니다.
pageInfo.pageIndex integer 현재 페이지 번호입니다.
pageInfo.pageSize integer 페이지 크기입니다.
pageInfo.count integer 이 페이지의 수량입니다.
pageInfo.totalCount integer 비어 있지 않은 페이지에서는 일치 규칙의 총수입니다. 현재 빈 페이지가 조기에 반환되면 이 값은 0이며, 범위를 벗어난 페이지의 0은 전역에 규칙이 없음을 증명할 수 없습니다.
{
  "code": 200,
  "content": {
    "data": [
      {
        "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": {}
          }
        },
        "creatorInfo": {},
        "updatorInfo": {}
      }
    ],
    "declaration": {}
  },
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-EXAMPLE",
  "pageInfo": {
    "pageIndex": 1,
    "pageSize": 50,
    "count": 1,
    "totalCount": 1
  }
}

오류 응답

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

HTTP 상태 errorCode 발생 조건 메시지 또는 응답 설명 처리 방법
406 ft.ParameterValidationFailed 선언되지 않은 Query 매개변수를 사용하거나 매개변수가 규칙을 위반함 매개변수 구문 분석 실패 Query 매개변수 표와 예시를 확인하십시오.
404 ft.NoInitOtherNodeCfg 원격 인덱스/RUM 애플리케이션 메타데이터를 읽거나 검증할 때 사용 가능한 소스 사이트 주소를 찾지 못함 기타 노드 구성이 초기화되지 않음 관리자가 소스 사이트 구성, 액세스 가능한 주소 및 유효한 워크스페이스 간 권한 부여를 확인하고 수정한 후 다시 시도하십시오.
500 ft.InternalServerError 규칙, 역할, 소스 워크스페이스 또는 인덱스/애플리케이션 메타데이터를 읽고 포맷하는 데 실패함 내부 오류 권한이 부여된 소스 및 사이트 정보를 새로 고친 후 나중에 다시 시도하십시오. 계속 실패하면 traceId를 제공하십시오.

문서 평가

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