목록 조회¶
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를 제공하십시오. |