기본 유형 인덱스 생성¶
POST /api/v1/log_index_cfg/add
개요¶
내부 로그 인덱스 설정을 생성합니다.
호출 전 확인 사항 및 사용 단계¶
먼저 워크스페이스에서 다중 인덱스가 활성화되어 있고 할당량이 있는지 확인합니다. 기본 내부 인덱스 수 상한은 30이지만 워크스페이스 설정에 따라 조정할 수 있습니다. 내부 인덱스의 활성화, 비활성화 및 클론은 모두 수량을 차지하며, 외부 인덱스 바인딩은 이 내부 할당량에 포함되지 않습니다. 생성 시 name, duration, extend를 모두 지정하는 것이 좋으며, scopedb에서 생성하는 경우 전체 라인 인덱스가 됩니다. directIndex=true는 네이티브 직접 쓰기를 의미합니다. 조건 분기와 직접 쓰기 방식은 수집 측과 일치해야 합니다.
이 공개 생성 Body는 cloneConfig를 선언하지 않으므로 숨겨진 필드를 추가하여 클론을 생성할 수 없습니다. 일괄 템플릿 및 클론 설정이 필요하면 가져오기 API의 공개 구조를 확인하세요.
스토리지 설정, 실제 다운스트림 작업 및 데이터베이스 커밋은 동일한 원자적 단계가 아닙니다. 오류/시간 초과가 발생하면 먼저 목록 및 상세에서 현재 설정을 확인한 다음 스토리지의 실제 상태를 확인하세요. 곧바로 생성을 반복하지 마세요. 인덱스 생성에 성공했다고 해서 물리 인덱스가 이미 생성되었거나 데이터가 존재한다는 보장은 없습니다. 보존 기간을 줄이기 전에 데이터 보존 요구 사항을 먼저 확인하세요.
요청 헤더¶
| 매개변수 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| DF-API-KEY | string | Y | 워크스페이스의 OpenAPI 인증 자격 증명입니다. 예시: <DF-API-KEY>가져오기 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다. |
Body 요청 매개변수¶
| 매개변수 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| storagePolicy.longStorageEnabled | boolean | 객체 내에서 생략하면 기본값은 false입니다. 비활성화하면 longStorageDuration이 빈 값으로 정규화되며, 기존 데이터가 즉시 삭제된다는 의미는 아닙니다. 예시: false가져오기 또는 입력 방법: true는 장기 스토리지 활성화, false는 비활성화입니다. JSON 불리언 값을 명시하는 것이 좋습니다. |
|
| storagePolicy.longStorageDuration | string | 활성화 시 조건부 필수입니다. 필드는 d가 포함된 문자열이며 초/시간 단위가 아니고, 메트릭 rp의 3600d 범위를 로그에 적용하지 않습니다. 예시: 180d가져오기 또는 입력 방법: pay는 기본적으로 90d/120d/180d/360d 중에서 선택하고, enterprise/unlimited는 기본적으로 1d~1800d이며 duration보다 엄격히 커야 합니다. |
|
| extend.matchMode | string | 생략하거나 빈 값이면 basic으로 처리합니다. advanced는 advancedFilter를 사용하고 basic은 filters를 사용하며, 모드를 전환할 때 해당하는 전체 조건을 함께 제공합니다. 예시: basic가져오기 또는 입력 방법: 일반 매칭은 basic, 고급 매칭은 advanced입니다. |
|
| extend.filters | array | basic의 리프 배열이며, 비어 있지 않은 조건은 conditions를 생성합니다. 생성/수정 시 basic에서는 operation이 match 또는 not match인 경우를 명시적으로 거부합니다. 텍스트 포함 등 복잡한 의미는 advanced의 해당 연산을 우선 사용합니다. 예시: [{"name": "env", "condition": "and", "operation": "=", "value": ["production"]}]가져오기 또는 입력 방법: 실제 로그 필드 조건입니다. 일반 매칭을 비워야 할 때는 filters=[]를 명시적으로 전달합니다. |
|
| extend.filters[*].name | string | 실제 필드 이름이며 백틱을 추가하지 않습니다. 예시: env가져오기 또는 입력 방법: 실제 로그 필드, 값 및 매칭 관계에 따라 입력합니다. |
|
| extend.filters[*].condition | string | 이전 조건과의 and/or 관계이며 첫 항목의 연결자는 무시합니다. 예시: and가져오기 또는 입력 방법: 실제 로그 필드, 값 및 매칭 관계에 따라 입력합니다. |
|
| extend.filters[*].operation | string | 주로 =, !=, in, not_in, >, >=, <, <=, regexp, not_regexp, wildcard, not_wildcard, exist, not_exist를 사용하며 basic에서는 match/not match를 금지합니다. 예시: =가져오기 또는 입력 방법: 실제 로그 필드, 값 및 매칭 관계에 따라 입력합니다. |
|
| extend.filters[*].value | array | 조건 값 배열이며 = 및 비교 연산은 첫 번째 항목을 사용합니다. 존재 여부 유형은 비어 있지 않은 자리 표시자 배열을 사용하는 것이 좋습니다. 예시: ["production"]가져오기 또는 입력 방법: 실제 로그 필드, 값 및 매칭 관계에 따라 입력합니다. |
|
| extend.filters[*] | json | 조건 객체이며 필드명/연산/값을 완전하게 지정해야 합니다. 예시: {"name": "env", "condition": "and", "operation": "=", "value": ["production"]}가져오기 또는 입력 방법: 각 항목은 하나의 기본 조건을 나타냅니다. |
|
| extend.filters[*].value[*] | JSON | 단일 비교 값이며 표시 이름으로 실제 값을 대체하지 않습니다. 예시: production가져오기 또는 입력 방법: 로그 원본 필드 값을 사용하고 문자열/숫자 유형을 유지합니다. |
|
| extend.advancedFilter | json | advanced일 때 필수인 루트 group 객체입니다. 그룹은 type=group, condition, filters를 사용하고 리프는 type=rule, name, operation, value를 사용합니다. 예시: {"type": "group", "condition": "and", "filters": [{"type": "rule", "name": "env", "operation": "=", "value": ["production"]}]}가져오기 또는 입력 방법: 고급 모드는 아래의 재귀 group/rule 구조에 따라 구성하고 basic의 평면 형식을 복사하지 마세요. |
|
| extend.advancedFilter.type | string | 루트 노드 유형이며 rule일 수 없습니다. 예시: group가져오기 또는 입력 방법: 루트 노드는 group으로 고정됩니다. |
|
| extend.advancedFilter.condition | string | 같은 그룹 내 하위 조건의 논리 관계입니다. 예시: and가져오기 또는 입력 방법: and/or이며 기본값은 and입니다. |
|
| extend.advancedFilter.filters | array | 하위 노드 배열이며 동일한 group 구조의 중첩을 허용합니다. 빈 그룹은 빈 조건을 생성합니다. 예시: [{"type": "rule", "name": "env", "operation": "=", "value": ["production"]}]가져오기 또는 입력 방법: 리프 rule 또는 재귀 group 하위 노드를 입력합니다. |
|
| extend.advancedFilter.filters[*] | json | rule 리프 또는 group 객체입니다. 예시: {"type": "rule", "name": "env", "operation": "=", "value": ["production"]}가져오기 또는 입력 방법: 리프는 실제 로그 필드에 따라 입력하고, 그룹은 동일한 구조로 계속 재귀합니다. |
|
| extend.advancedFilter.filters[*].type | string | rule은 리프, group은 재귀 그룹입니다. 예시: rule가져오기 또는 입력 방법: 해당 group/rule 노드 구조에 따라 입력합니다. |
|
| extend.advancedFilter.filters[*].name | string | rule에 필수인 비어 있지 않은 필드 이름입니다. 예시: env가져오기 또는 입력 방법: 해당 group/rule 노드 구조에 따라 입력합니다. |
|
| extend.advancedFilter.filters[*].operation | string | rule에서 허용되는 연산자는 =, !=, in, not_in, match, not_match, wildcard, not_wildcard, regexp, not_regexp, >, <, >=, <=, exist, not_exist입니다. 예시: =가져오기 또는 입력 방법: 해당 group/rule 노드 구조에 따라 입력합니다. |
|
| extend.advancedFilter.filters[*].value | array | rule에 필수인 배열입니다. exist/not_exist는 []를 사용할 수 있지만 그 외에는 빈 배열을 허용하지 않습니다. 예시: ["production"]가져오기 또는 입력 방법: 해당 group/rule 노드 구조에 따라 입력합니다. |
|
| extend.advancedFilter.filters[*].condition | string | group 하위 그룹에서 and/or를 사용합니다. 예시: and가져오기 또는 입력 방법: 해당 group/rule 노드 구조에 따라 입력합니다. |
|
| extend.advancedFilter.filters[*].filters | array | group 하위 그룹의 재귀 배열이며 규칙 리프에서는 생략합니다. 예시: []가져오기 또는 입력 방법: 해당 group/rule 노드 구조에 따라 입력합니다. |
|
| extend.advancedFilter.filters[*].value[*] | JSON | 단일 문자열 또는 숫자입니다. regexp 값에는 백틱이 포함되지 않습니다. 예시: production가져오기 또는 입력 방법: 로그 원본 값을 사용합니다. |
|
| extend.extendFields | array | 선택적 핵심 필드 배열입니다. tag/alias 구조로 제출해야 하고 tag는 비어 있지 않아야 합니다. 생성 시에는 이 구조 검증이 강제되지 않지만 수정 시에는 검증합니다. 가져오기는 필드 가속화 스위치에 따라 필드 인덱스를 추가로 동기화하며, 직접 modify는 이 설정만 저장합니다. 예시: [{"tag": "service", "alias": "서비스"}]가져오기 또는 입력 방법: 실제 로그 필드에서 주요 표시 필드를 선택합니다. |
|
| extend.extendFields[*] | json | tag/alias 키만 허용합니다. 예시: {"tag": "service", "alias": "서비스"}가져오기 또는 입력 방법: 필드 키 및 표시 별칭에 따라 입력합니다. |
|
| extend.extendFields[*].tag | string | 조건부 필수이며 비어 있지 않은 키입니다. 예시: service가져오기 또는 입력 방법: 실제 로그 필드 이름입니다. |
|
| extend.extendFields[*].alias | string | 선택적 표시 별칭입니다. 예시: 서비스가져오기 또는 입력 방법: 비즈니스 표시 이름이며 생략할 수 있습니다. |
|
| extend.topFields | array | 선택적 표시 설정이며 동일한 tag/alias 객체 형식으로 사용합니다. 일반 modify는 독립적인 상단 고정 API가 아닙니다. 예시: [{"tag": "host", "alias": "호스트"}]가져오기 또는 입력 방법: 콘솔의 상단 고정 필드 목록을 유지합니다. |
|
| extend.topFields[*] | json | 단일 표시 필드 객체입니다. 예시: {"tag": "host", "alias": "호스트"}가져오기 또는 입력 방법: 기존 목록에 따라 다시 채웁니다. |
|
| extend.topFields[*].tag | string | 필드 키입니다. 예시: host가져오기 또는 입력 방법: 실제 필드 이름입니다. |
|
| extend.topFields[*].alias | string | 선택적 별칭입니다. 예시: 호스트가져오기 또는 입력 방법: 표시 별칭입니다. |
|
| extend.services | array | 선택적 에코 정보이며 filters의 실제 매칭 조건을 대체하지 않습니다. 예시: ["checkout-api"]가져오기 또는 입력 방법: 콘솔 관련 서비스 표시 설정을 유지합니다. |
|
| extend.services[*] | string | 단일 서비스 표시 값입니다. 예시: checkout-api가져오기 또는 입력 방법: 실제 서비스 이름입니다. |
|
| desc | string | 선택적 설명이며 최대 1024자입니다. 일반 modify에서 생략하면 유지되고 빈 문자열이면 지웁니다. 외부 바인딩 수정에서 생략하면 지워집니다. 빈 문자열 허용: True null 허용: False 최대 길이: 1024 예시: 프로덕션 서비스 로그.가져오기 또는 입력 방법: 용도, 출처 및 유지보수 책임 설명을 입력합니다. |
|
| directIndex | boolean | 선택 사항이며 생성 시 기본값은 false입니다. 직접 쓰기는 일반 매칭 순서에 따라 분기하지 않습니다. 일반 modify에는 이 필드가 없으며, 가져오기 recover도 기존 인덱스 모드를 변환하지 않습니다. null 허용: False 예시: false가져오기 또는 입력 방법: 일반 매칭으로 분기하는 인덱스는 false, 인덱스 이름으로 직접 쓰는 네이티브 직접 쓰기 인덱스는 true입니다. |
|
| duration | string | 일반 생성 시 기본값은 보통 3d입니다. 비TLS 스토리지에서 pay는 기본적으로 3d/7d/14d/30d/60d/90d를 허용하고, enterprise/unlimited는 기본적으로 1d~1800d를 허용하며 구체적인 값은 사이트 설정을 따릅니다. modify에서 생략하면 유지됩니다. TLS는 setting을 확인하며 이 필드로 실제 기간을 제어하지 않습니다. null 허용: False 예시: 7d가져오기 또는 입력 방법: 현재 워크스페이스 버전과 로그 스토리지에 따라 표준 보존 일수를 선택하고 정수+d 형식을 사용합니다. |
|
| extend | json | 선택적 확장 객체이며 실제 매칭 및 표시 설정을 포함합니다. 일반 modify는 첫 번째 수준 키 기준으로 병합하고 제공되지 않은 키는 유지하며, 배열 또는 중첩 객체는 통째로 교체합니다. {}는 기존 filters를 지우지 않습니다. null을 피하세요. 일부 수정 분기에서는 500이 발생할 수 있습니다. 가져오기 recover는 extend를 통째로 교체합니다. null 허용: True 예시: {"matchMode": "basic", "filters": [{"name": "env", "condition": "and", "operation": "=", "value": ["production"]}]}가져오기 또는 입력 방법: 매칭 조건은 실제 로그 필드와 값으로 구성하고, 기타 표시 설정은 원래 상세 정보에서 유지합니다. |
|
| isFullLineIndex | int | 0/1 또는 불리언만 허용합니다. scopedb 생성 시 기본값은 1이며 0을 허용하지 않습니다. 기존 Message는 0→1은 가능하지만 1→0은 불가능하며, 전환 시 message 필드 인덱스가 동기화되고 되돌릴 수 없습니다. modify에서 생략하면 유지됩니다. null 허용: False 예시: 1가져오기 또는 입력 방법: scopedb 로그 생성 시 반드시 1/true여야 하고, 기타 로그 스토리지는 0/false를 유지합니다. |
|
| name | string | Y | 생성 시 필수입니다. 선언상 최대 256자이지만 실제 저장 컬럼은 128자이므로 128자 이내를 권장합니다. ES 로그 스토리지에서는 하이픈을 허용하지 않으며 default 예약 이름 또는 다른 인덱스 UUID를 사용하지 않습니다. 일반 인덱스는 modify로 이름을 변경할 수 없습니다. null 허용: False 최대 길이: 256 예시: production_logs가져오기 또는 입력 방법: 비즈니스 기준으로 이름을 지정하고 먼저 로그 인덱스 목록에서 현재 워크스페이스에서 사용 중인 이름을 확인합니다. |
| setting | json | TLS 생성 시 hot_retention을 반드시 제공해야 합니다. 총 duration은 세 가지 시간 값의 합을 일 단위로 환산합니다. 일반 수정에서 setting을 제공할 때는 핫 스토리지와 필요한 단계를 완전하게 제공하고 cold_retention만 전달하지 마세요. 다른 스토리지는 이 필드를 TLS로 해석하지 않습니다. null 허용: False 예시: {"hot_retention": 168}가져오기 또는 입력 방법: 워크스페이스 로그 스토리지가 volctls인 경우에만 표준/저빈도/아카이브 보존을 설정하며 값의 단위는 시간입니다. |
|
| setting.archive_retention | int | 선택 사항이며 기본 범위는 60..1800일이고 하루 단위 시간 수여야 합니다. 핫 스토리지는 최소 30일이어야 하며 합계는 1800일을 초과할 수 없습니다. null 허용: False 예시: 1440가져오기 또는 입력 방법: 아카이브 일수×24로 입력합니다. 예를 들어 60일=1440시간입니다. 이 단계를 활성화하지 않으면 생략합니다. |
|
| setting.cold_retention | int | 선택 사항이며 기본 범위는 30..1800일이고 하루 단위 시간 수여야 합니다. 0을 사용하여 생략을 나타내지 않으며 합계는 1800일을 초과할 수 없습니다. null 허용: False 예시: 720가져오기 또는 입력 방법: 저빈도 스토리지 일수×24로 입력합니다. 예를 들어 30일=720시간입니다. 이 단계를 활성화하지 않으면 생략합니다. |
|
| setting.hot_retention | int | TLS에서 조건부 필수이며 기본 범위는 1~1800일로 24..43200시간에 해당하고 24의 배수여야 합니다. 콜드 스토리지를 사용할 때 핫 스토리지는 최소 7일, 아카이브를 사용할 때는 최소 30일이어야 합니다. null 허용: False 예시: 168가져오기 또는 입력 방법: 일수×24로 입력합니다. 예를 들어 7일=168시간입니다. |
|
| storagePolicy | json | 선택적 전체 장기 정책 객체입니다. 일반 생성 시 {}를 생략합니다. 수정 시 생략하면 유지되고, {}는 비활성화로 정규화되며 명시적으로 끄려면 longStorageEnabled=false를 사용합니다. 장기 기간은 표준 duration보다 엄격히 커야 하며 단위는 여전히 일입니다. null 허용: False 예시: {"longStorageEnabled": false}가져오기 또는 입력 방법: 로그 스토리지가 scopedb이고 버전이 pay/enterprise/unlimited인 경우에만 장기 스토리지를 활성화할 수 있습니다. 먼저 워크스페이스 기능을 확인하세요. |
매개변수 추가 설명¶
1. 요청 매개변수 설명
| 매개변수 이름 | type | 필수 | 설명 |
|---|---|---|---|
| name | String | 필수 | 인덱스 이름 |
| desc | String | 인덱스 설명 | |
| extend | Json | 프런트엔드 표시용 확장 정보 | |
| duration | Json | 인덱스 총 스토리지 기간, 예시: 60d | |
| directIndex | Boolean | 네이티브 직접 쓰기 인덱스, 기본 false, 2025-06-25 업데이트에서 추가됨 | |
| setting | Json | 로그가 Volcengine 스토리지일 때의 인덱스 설정 정보 |
2. setting의 매개변수 설명
| 매개변수 이름 | type | 필수 | 설명 |
|---|---|---|---|
| hot_retention | int | 필수 | 표준 스토리지 - 핫 데이터, 하루 단위 시간 수여야 함, 단위: 시간 h |
| cold_retention | int | 저빈도 스토리지 - 콜드 데이터, 하루 단위 시간 수여야 함, 단위: 시간 h | |
| archive_retention | int | 아카이브 스토리지 - 아카이브 데이터, 하루 단위 시간 수여야 함, 단위: 시간 h |
2.1. Volcengine 스토리지 기간 제한:
표준 스토리지: 핫 데이터 스토리지이며 데이터 범위는 1-1800일입니다. 저빈도 스토리지가 있으면 데이터 범위는 7-1800일이고, 아카이브 스토리지가 있으면 30-1800일입니다.
저빈도 스토리지: 콜드 데이터 스토리지이며 데이터 범위는 30-1800일입니다.
아카이브 스토리지: 아카이브 데이터 등의 스토리지이며 데이터 범위는 60-1800일입니다.
2.2. Volcengine 스토리지 기간 제한:
총 스토리지 기간(표준 스토리지 + 저빈도 스토리지 + 아카이브 스토리지)은 1800일을 초과할 수 없습니다.
3. extend의 매개변수 설명
| 매개변수 이름 | type | 필수 | 설명 |
|---|---|---|---|
| matchMode | String | 매칭 모드, 선택 가능한 값: basic, advanced; 생략 시 basic으로 처리 |
|
| filters | Array[dict] | 일반 매칭 필터 조건 목록이며 네이티브 직접 쓰기 인덱스에는 설정이 필요 없습니다. advanced 모드에서는 빈 배열을 전달하는 것이 좋습니다 |
|
| advancedFilter | Dict | 고급 매칭 조건 트리이며 matchMode=advanced일 때 적용됩니다 |
|
| extendFields | Array | 인덱스 확장 필드 정보 | |
| extendFields[*].tag | String | 필수 | 핵심 필드 이름 |
| extendFields[*].alias | String | 핵심 필드 별칭 | |
| services | String | 매칭 서비스 |
4. extend.filters의 본문 구조 설명
| 매개변수 이름 | type | 필수 | 설명 |
|---|---|---|---|
| condition | string | 이전 필터 조건과의 관계, 선택 가능한 값: and, or; 기본값: and |
|
| name | string | 필터링할 필드 이름 | |
| operation | string | 연산자, 선택 가능한 값: in, not_in |
|
| value | array | 값 목록 | |
| value[#] | string/int/boolean | 문자열/숫자/불리언 유형일 수 있습니다 |
5. extend.advancedFilter의 본문 구조 설명
| 매개변수 이름 | type | 필수 | 설명 |
|---|---|---|---|
| type | string | 필수 | 루트 노드는 group으로 고정됩니다 |
| condition | string | 필수 | 현재 그룹 내 하위 노드 관계, 선택 가능한 값: and, or |
| filters | array | 필수 | 하위 노드 목록이며 요소는 rule 또는 group일 수 있습니다 |
| filters[#].type | string | 필수 | 노드 유형, 선택 가능한 값: rule, group |
| filters[#].name | string | rule 필수 | 로그 필드 이름 |
| filters[#].operation | string | rule 필수 | 연산자, 선택 가능한 값: =, !=, in, not_in, match, not_match, wildcard, not_wildcard, regexp, not_regexp, >, <, >=, <=, exist, not_exist |
| filters[#].value | array | rule 필수 | 값 목록, exist / not_exist는 빈 배열을 사용합니다 |
matchMode=advanced일 때 백엔드는 DQL where 스타일로 conditions를 생성합니다. 예: IN, NOT IN, = match('xxx'), = wildcard('xxx'). 일반 filters는 기존 생성 형식을 유지합니다.
요청 예시¶
curl --request POST 'https://openapi.guance.com/api/v1/log_index_cfg/add' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json' \
--data-raw '{"name":"production_logs","desc":"프로덕션 서비스 로그.","duration":"7d","directIndex":false,"isFullLineIndex":1,"extend":{"matchMode":"basic","filters":[{"name":"env","condition":"and","operation":"=","value":["production"]}]}}'
응답¶
HTTP 200, application/json. 아래 예시는 바로 읽을 수 있는 주요 필드를 보여 줍니다.
| 필드 | 유형 | 설명 |
|---|---|---|
| content.id | integer 또는 null | 데이터베이스 레코드 번호이며, 생성 제출 전 스냅샷에서는 null일 수 있습니다. 작업에는 uuid를 사용합니다. |
| content.uuid | string | lgim_ 인덱스 설정 UUID이며 기본 인덱스는 default를 사용합니다. |
| content.workspaceUUID | string | 소속 워크스페이스입니다. |
| content.sourceIndexUUID | string | 클론 인덱스 B의 원본 A UUID이며 일반 인덱스는 비어 있습니다. |
| content.name | string | 인덱스 이름입니다. |
| content.desc | string | 설명입니다. |
| content.conditions | string | extend에 따라 생성된 실제 조건 문자열이며 일반 요청에서는 이 필드를 직접 수정하지 마세요. |
| content.sortNo | integer 또는 string | 매칭 순서 식별자이며 네이티브 직접 쓰기 또는 클론은 보통 0입니다. |
| content.duration | string | 표준 스토리지 기간이며 TLS는 콜드/핫/아카이브 합계 일수입니다. |
| content.isBindCustomStore | integer 또는 boolean | 1/true이면 외부 스토리지에 바인딩됩니다. |
| content.directIndex | integer 또는 boolean | 1/true이면 네이티브 직접 쓰기입니다. |
| content.isFullLineIndex | integer | 1은 전체 라인, 0은 Message입니다. |
| content.queryType | string | 쿼리 유형이며 예: logging/standard 또는 외부 SLS가 반환하는 모드입니다. |
| content.exterStoreProject | string | 외부 프로젝트/데이터베이스 식별자이며 내부 인덱스는 보통 비어 있습니다. |
| content.exterStoreName | string | 외부 리소스 이름이며 내부는 보통 비어 있습니다. |
| content.externalResourceAccessCfgUUID | string | 액세스 설정 식별자이며 자격 증명 원문이 아닙니다. |
| content.storeType | string | 내부 인덱스는 보통 비어 있고 외부에 바인딩된 경우 실제 유형입니다. |
| content.region | string | 외부 리전 코드입니다. |
| content.isPublicNetworkAccess | integer 또는 boolean | 공용 네트워크 액세스 표시입니다. |
| 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.storagePolicy | object | 선택적 전체 장기 정책 객체입니다. 일반 생성 시 {}를 생략합니다. 수정 시 생략하면 유지되고, {}는 비활성화로 정규화되며 명시적으로 끄려면 longStorageEnabled=false를 사용합니다. 장기 기간은 표준 duration보다 엄격히 커야 하며 단위는 여전히 일입니다. |
| content.storagePolicy.longStorageEnabled | boolean | 객체 내에서 생략하면 기본값은 false입니다. 비활성화하면 longStorageDuration이 빈 값으로 정규화되며, 기존 데이터가 즉시 삭제된다는 의미는 아닙니다. |
| content.storagePolicy.longStorageDuration | string | 활성화 시 조건부 필수입니다. 필드는 d가 포함된 문자열이며 초/시간 단위가 아니고, 메트릭 rp의 3600d 범위를 로그에 적용하지 않습니다. |
| content.setting | object | TLS 생성 시 hot_retention을 반드시 제공해야 합니다. 총 duration은 세 가지 시간 값의 합을 일 단위로 환산합니다. 일반 수정에서 setting을 제공할 때는 핫 스토리지와 필요한 단계를 완전하게 제공하고 cold_retention만 전달하지 마세요. 다른 스토리지는 이 필드를 TLS로 해석하지 않습니다. |
| content.setting.hot_retention | integer | TLS에서 조건부 필수이며 기본 범위는 1~1800일로 24..43200시간에 해당하고 24의 배수여야 합니다. 콜드 스토리지를 사용할 때 핫 스토리지는 최소 7일, 아카이브를 사용할 때는 최소 30일이어야 합니다. |
| content.setting.cold_retention | integer | 선택 사항이며 기본 범위는 30..1800일이고 하루 단위 시간 수여야 합니다. 0을 사용하여 생략을 나타내지 않으며 합계는 1800일을 초과할 수 없습니다. |
| content.setting.archive_retention | integer | 선택 사항이며 기본 범위는 60..1800일이고 하루 단위 시간 수여야 합니다. 핫 스토리지는 최소 30일이어야 하며 합계는 1800일을 초과할 수 없습니다. |
| content.extend | object | 선택적 확장 객체이며 실제 매칭 및 표시 설정을 포함합니다. 일반 modify는 첫 번째 수준 키 기준으로 병합하고 제공되지 않은 키는 유지하며, 배열 또는 중첩 객체는 통째로 교체합니다. {}는 기존 filters를 지우지 않습니다. null을 피하세요. 일부 수정 분기에서는 500이 발생할 수 있습니다. 가져오기 recover는 extend를 통째로 교체합니다. |
| content.extend.matchMode | string | 생략하거나 빈 값이면 basic으로 처리합니다. advanced는 advancedFilter를 사용하고 basic은 filters를 사용하며, 모드를 전환할 때 해당하는 전체 조건을 함께 제공합니다. |
| content.extend.filters | array | basic의 리프 배열이며, 비어 있지 않은 조건은 conditions를 생성합니다. 생성/수정 시 basic에서는 operation이 match 또는 not match인 경우를 명시적으로 거부합니다. 텍스트 포함 등 복잡한 의미는 advanced의 해당 연산을 우선 사용합니다. |
| content.extend.filters[].name | string | 실제 필드 이름이며 백틱을 추가하지 않습니다. |
| content.extend.filters[].condition | string | 이전 조건과의 and/or 관계이며 첫 항목의 연결자는 무시합니다. |
| content.extend.filters[].operation | string | 주로 =, !=, in, not_in, >, >=, <, <=, regexp, not_regexp, wildcard, not_wildcard, exist, not_exist를 사용하며 basic에서는 match/not match를 금지합니다. |
| content.extend.filters[].value | array | 조건 값 배열이며 = 및 비교 연산은 첫 번째 항목을 사용합니다. 존재 여부 유형은 비어 있지 않은 자리 표시자 배열을 사용하는 것이 좋습니다. |
| content.extend.filters[] | json | 조건 객체이며 필드명/연산/값을 완전하게 지정해야 합니다. |
| content.extend.filters[].value[] | JSON | 단일 비교 값이며 표시 이름으로 실제 값을 대체하지 않습니다. |
| content.extend.advancedFilter | json | advanced일 때 필수인 루트 group 객체입니다. 그룹은 type=group, condition, filters를 사용하고 리프는 type=rule, name, operation, value를 사용합니다. |
| content.extend.advancedFilter.type | string | 루트 노드 유형이며 rule일 수 없습니다. |
| content.extend.advancedFilter.condition | string | 같은 그룹 내 하위 조건의 논리 관계입니다. |
| content.extend.advancedFilter.filters | array | 하위 노드 배열이며 동일한 group 구조의 중첩을 허용합니다. 빈 그룹은 빈 조건을 생성합니다. |
| content.extend.advancedFilter.filters[] | json | rule 리프 또는 group 객체입니다. |
| content.extend.advancedFilter.filters[].type | string | rule은 리프, group은 재귀 그룹입니다. |
| content.extend.advancedFilter.filters[].name | string | rule에 필수인 비어 있지 않은 필드 이름입니다. |
| content.extend.advancedFilter.filters[].operation | string | rule에서 허용되는 연산자는 =, !=, in, not_in, match, not_match, wildcard, not_wildcard, regexp, not_regexp, >, <, >=, <=, exist, not_exist입니다. |
| content.extend.advancedFilter.filters[].value | array | rule에 필수인 배열입니다. exist/not_exist는 []를 사용할 수 있지만 그 외에는 빈 배열을 허용하지 않습니다. |
| content.extend.advancedFilter.filters[].condition | string | group 하위 그룹에서 and/or를 사용합니다. |
| content.extend.advancedFilter.filters[].filters | array | group 하위 그룹의 재귀 배열이며 규칙 리프에서는 생략합니다. |
| content.extend.advancedFilter.filters[].value[] | JSON | 단일 문자열 또는 숫자입니다. regexp 값에는 백틱이 포함되지 않습니다. |
| content.extend.extendFields | array | 선택적 핵심 필드 배열입니다. tag/alias 구조로 제출해야 하고 tag는 비어 있지 않아야 합니다. 생성 시에는 이 구조 검증이 강제되지 않지만 수정 시에는 검증합니다. 가져오기는 필드 가속화 스위치에 따라 필드 인덱스를 추가로 동기화하며, 직접 modify는 이 설정만 저장합니다. |
| content.extend.extendFields[] | json | tag/alias 키만 허용합니다. |
| content.extend.extendFields[].tag | string | 조건부 필수이며 비어 있지 않은 키입니다. |
| content.extend.extendFields[].alias | string | 선택적 표시 별칭입니다. |
| content.extend.topFields | array | 선택적 표시 설정이며 동일한 tag/alias 객체 형식으로 사용합니다. 일반 modify는 독립적인 상단 고정 API가 아닙니다. |
| content.extend.topFields[] | json | 단일 표시 필드 객체입니다. |
| content.extend.topFields[].tag | string | 필드 키입니다. |
| content.extend.topFields[].alias | string | 선택적 별칭입니다. |
| content.extend.services | array | 선택적 에코 정보이며 filters의 실제 매칭 조건을 대체하지 않습니다. |
| content.extend.services[] | string | 단일 서비스 표시 값입니다. |
| content.cloneConfig | object 또는 null | 원본 A와 연결된 클론 B의 전체 엔티티이며 없으면 null입니다. 클론 자체의 응답에 이 키가 항상 포함되는 것은 아닙니다. |
| content.cloneConfig.id | integer 또는 null | 데이터베이스 레코드 번호이며, 생성 제출 전 스냅샷에서는 null일 수 있습니다. 작업에는 uuid를 사용합니다. |
| content.cloneConfig.uuid | string | lgim_ 인덱스 설정 UUID이며 기본 인덱스는 default를 사용합니다. |
| content.cloneConfig.workspaceUUID | string | 소속 워크스페이스입니다. |
| content.cloneConfig.sourceIndexUUID | string | 클론 인덱스 B의 원본 A UUID이며 일반 인덱스는 비어 있습니다. |
| content.cloneConfig.name | string | 인덱스 이름입니다. |
| content.cloneConfig.desc | string | 설명입니다. |
| content.cloneConfig.conditions | string | extend에 따라 생성된 실제 조건 문자열이며 일반 요청에서는 이 필드를 직접 수정하지 마세요. |
| content.cloneConfig.sortNo | integer 또는 string | 매칭 순서 식별자이며 네이티브 직접 쓰기 또는 클론은 보통 0입니다. |
| content.cloneConfig.duration | string | 표준 스토리지 기간이며 TLS는 콜드/핫/아카이브 합계 일수입니다. |
| content.cloneConfig.isBindCustomStore | integer 또는 boolean | 1/true이면 외부 스토리지에 바인딩됩니다. |
| content.cloneConfig.directIndex | integer 또는 boolean | 1/true이면 네이티브 직접 쓰기입니다. |
| content.cloneConfig.isFullLineIndex | integer | 1은 전체 라인, 0은 Message입니다. |
| content.cloneConfig.queryType | string | 쿼리 유형이며 예: logging/standard 또는 외부 SLS가 반환하는 모드입니다. |
| content.cloneConfig.exterStoreProject | string | 외부 프로젝트/데이터베이스 식별자이며 내부 인덱스는 보통 비어 있습니다. |
| content.cloneConfig.exterStoreName | string | 외부 리소스 이름이며 내부는 보통 비어 있습니다. |
| content.cloneConfig.externalResourceAccessCfgUUID | string | 액세스 설정 식별자이며 자격 증명 원문이 아닙니다. |
| content.cloneConfig.storeType | string | 내부 인덱스는 보통 비어 있고 외부에 바인딩된 경우 실제 유형입니다. |
| content.cloneConfig.region | string | 외부 리전 코드입니다. |
| content.cloneConfig.isPublicNetworkAccess | integer 또는 boolean | 공용 네트워크 액세스 표시입니다. |
| content.cloneConfig.status | integer | 0 활성화, 2 비활성화, 3 삭제. |
| content.cloneConfig.creator | string | 생성 주체입니다. |
| content.cloneConfig.updator | string | 최근 업데이트 주체입니다. |
| content.cloneConfig.createAt | integer | 생성 Unix 초입니다. |
| content.cloneConfig.updateAt | integer | 업데이트 Unix 초이며 업데이트되지 않았으면 -1입니다. |
| content.cloneConfig.deleteAt | integer | 삭제 Unix 초이며 삭제되지 않았으면 -1입니다. |
| content.cloneConfig.storagePolicy | object | 선택적 전체 장기 정책 객체입니다. 일반 생성 시 {}를 생략합니다. 수정 시 생략하면 유지되고, {}는 비활성화로 정규화되며 명시적으로 끄려면 longStorageEnabled=false를 사용합니다. 장기 기간은 표준 duration보다 엄격히 커야 하며 단위는 여전히 일입니다. |
| content.cloneConfig.storagePolicy.longStorageEnabled | boolean | 객체 내에서 생략하면 기본값은 false입니다. 비활성화하면 longStorageDuration이 빈 값으로 정규화되며, 기존 데이터가 즉시 삭제된다는 의미는 아닙니다. |
| content.cloneConfig.storagePolicy.longStorageDuration | string | 활성화 시 조건부 필수입니다. 필드는 d가 포함된 문자열이며 초/시간 단위가 아니고, 메트릭 rp의 3600d 범위를 로그에 적용하지 않습니다. |
| content.cloneConfig.setting | object | TLS 생성 시 hot_retention을 반드시 제공해야 합니다. 총 duration은 세 가지 시간 값의 합을 일 단위로 환산합니다. 일반 수정에서 setting을 제공할 때는 핫 스토리지와 필요한 단계를 완전하게 제공하고 cold_retention만 전달하지 마세요. 다른 스토리지는 이 필드를 TLS로 해석하지 않습니다. |
| content.cloneConfig.setting.hot_retention | integer | TLS에서 조건부 필수이며 기본 범위는 1~1800일로 24..43200시간에 해당하고 24의 배수여야 합니다. 콜드 스토리지를 사용할 때 핫 스토리지는 최소 7일, 아카이브를 사용할 때는 최소 30일이어야 합니다. |
| content.cloneConfig.setting.cold_retention | integer | 선택 사항이며 기본 범위는 30..1800일이고 하루 단위 시간 수여야 합니다. 0을 사용하여 생략을 나타내지 않으며 합계는 1800일을 초과할 수 없습니다. |
| content.cloneConfig.setting.archive_retention | integer | 선택 사항이며 기본 범위는 60..1800일이고 하루 단위 시간 수여야 합니다. 핫 스토리지는 최소 30일이어야 하며 합계는 1800일을 초과할 수 없습니다. |
| content.cloneConfig.extend | object | 선택적 확장 객체이며 실제 매칭 및 표시 설정을 포함합니다. 일반 modify는 첫 번째 수준 키 기준으로 병합하고 제공되지 않은 키는 유지하며, 배열 또는 중첩 객체는 통째로 교체합니다. {}는 기존 filters를 지우지 않습니다. null을 피하세요. 일부 수정 분기에서는 500이 발생할 수 있습니다. 가져오기 recover는 extend를 통째로 교체합니다. |
| content.cloneConfig.extend.matchMode | string | 생략하거나 빈 값이면 basic으로 처리합니다. advanced는 advancedFilter를 사용하고 basic은 filters를 사용하며, 모드를 전환할 때 해당하는 전체 조건을 함께 제공합니다. |
| content.cloneConfig.extend.filters | array | basic의 리프 배열이며, 비어 있지 않은 조건은 conditions를 생성합니다. 생성/수정 시 basic에서는 operation이 match 또는 not match인 경우를 명시적으로 거부합니다. 텍스트 포함 등 복잡한 의미는 advanced의 해당 연산을 우선 사용합니다. |
| content.cloneConfig.extend.filters[].name | string | 실제 필드 이름이며 백틱을 추가하지 않습니다. |
| content.cloneConfig.extend.filters[].condition | string | 이전 조건과의 and/or 관계이며 첫 항목의 연결자는 무시합니다. |
| content.cloneConfig.extend.filters[].operation | string | 주로 =, !=, in, not_in, >, >=, <, <=, regexp, not_regexp, wildcard, not_wildcard, exist, not_exist를 사용하며 basic에서는 match/not match를 금지합니다. |
| content.cloneConfig.extend.filters[].value | array | 조건 값 배열이며 = 및 비교 연산은 첫 번째 항목을 사용합니다. 존재 여부 유형은 비어 있지 않은 자리 표시자 배열을 사용하는 것이 좋습니다. |
| content.cloneConfig.extend.filters[] | json | 조건 객체이며 필드명/연산/값을 완전하게 지정해야 합니다. |
| content.cloneConfig.extend.filters[].value[] | JSON | 단일 비교 값이며 표시 이름으로 실제 값을 대체하지 않습니다. |
| content.cloneConfig.extend.advancedFilter | json | advanced일 때 필수인 루트 group 객체입니다. 그룹은 type=group, condition, filters를 사용하고 리프는 type=rule, name, operation, value를 사용합니다. |
| content.cloneConfig.extend.advancedFilter.type | string | 루트 노드 유형이며 rule일 수 없습니다. |
| content.cloneConfig.extend.advancedFilter.condition | string | 같은 그룹 내 하위 조건의 논리 관계입니다. |
| content.cloneConfig.extend.advancedFilter.filters | array | 하위 노드 배열이며 동일한 group 구조의 중첩을 허용합니다. 빈 그룹은 빈 조건을 생성합니다. |
| content.cloneConfig.extend.advancedFilter.filters[] | json | rule 리프 또는 group 객체입니다. |
| content.cloneConfig.extend.advancedFilter.filters[].type | string | rule은 리프, group은 재귀 그룹입니다. |
| content.cloneConfig.extend.advancedFilter.filters[].name | string | rule에 필수인 비어 있지 않은 필드 이름입니다. |
| content.cloneConfig.extend.advancedFilter.filters[].operation | string | rule에서 허용되는 연산자는 =, !=, in, not_in, match, not_match, wildcard, not_wildcard, regexp, not_regexp, >, <, >=, <=, exist, not_exist입니다. |
| content.cloneConfig.extend.advancedFilter.filters[].value | array | rule에 필수인 배열입니다. exist/not_exist는 []를 사용할 수 있지만 그 외에는 빈 배열을 허용하지 않습니다. |
| content.cloneConfig.extend.advancedFilter.filters[].condition | string | group 하위 그룹에서 and/or를 사용합니다. |
| content.cloneConfig.extend.advancedFilter.filters[].filters | array | group 하위 그룹의 재귀 배열이며 규칙 리프에서는 생략합니다. |
| content.cloneConfig.extend.advancedFilter.filters[].value[] | JSON | 단일 문자열 또는 숫자입니다. regexp 값에는 백틱이 포함되지 않습니다. |
| content.cloneConfig.extend.extendFields | array | 선택적 핵심 필드 배열입니다. tag/alias 구조로 제출해야 하고 tag는 비어 있지 않아야 합니다. 생성 시에는 이 구조 검증이 강제되지 않지만 수정 시에는 검증합니다. 가져오기는 필드 가속화 스위치에 따라 필드 인덱스를 추가로 동기화하며, 직접 modify는 이 설정만 저장합니다. |
| content.cloneConfig.extend.extendFields[] | json | tag/alias 키만 허용합니다. |
| content.cloneConfig.extend.extendFields[].tag | string | 조건부 필수이며 비어 있지 않은 키입니다. |
| content.cloneConfig.extend.extendFields[].alias | string | 선택적 표시 별칭입니다. |
| content.cloneConfig.extend.topFields | array | 선택적 표시 설정이며 동일한 tag/alias 객체 형식으로 사용합니다. 일반 modify는 독립적인 상단 고정 API가 아닙니다. |
| content.cloneConfig.extend.topFields[] | json | 단일 표시 필드 객체입니다. |
| content.cloneConfig.extend.topFields[].tag | string | 필드 키입니다. |
| content.cloneConfig.extend.topFields[].alias | string | 선택적 별칭입니다. |
| content.cloneConfig.extend.services | array | 선택적 에코 정보이며 filters의 실제 매칭 조건을 대체하지 않습니다. |
| content.cloneConfig.extend.services[] | string | 단일 서비스 표시 값입니다. |
| content.declaration | object | 워크스페이스 공용 선언이며 단일 엔티티 응답에 추가됩니다. |
{
"code": 200,
"content": {
"id": null,
"uuid": "lgim_example",
"workspaceUUID": "wksp_example",
"sourceIndexUUID": "",
"name": "production_logs",
"desc": "프로덕션 서비스 로그.",
"duration": "7d",
"directIndex": false,
"isFullLineIndex": 1,
"extend": {
"matchMode": "basic",
"filters": [
{
"name": "env",
"condition": "and",
"operation": "=",
"value": [
"production"
]
}
]
},
"conditions": "{ `env` = 'production' }",
"sortNo": 1,
"isBindCustomStore": 0,
"queryType": "logging",
"exterStoreProject": "",
"exterStoreName": "",
"externalResourceAccessCfgUUID": "",
"storeType": "",
"region": "",
"isPublicNetworkAccess": 0,
"setting": {},
"storagePolicy": {},
"status": 0,
"creator": "wsak_example",
"updator": "wsak_example",
"createAt": 1785427200,
"updateAt": -1,
"deleteAt": -1,
"cloneConfig": null,
"declaration": {}
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
오류 응답¶
인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참조하세요.
| HTTP 상태 | errorCode | 발생 조건 | 메시지 또는 응답 설명 | 처리 방법 |
|---|---|---|---|---|
| 406 | ft.ParameterValidationFailed | 요청 필드가 누락되었거나 필드 값이 선언된 검증 조건을 위반했습니다 | 매개변수 구문 분석 실패 | 매개변수 위치, 필드 이름, 유형 및 값을 확인하세요. |
| 400 | ft.RequestJsonFormatError | 요청 JSON 구문이 유효하지 않음 | 요청 JSON 형식 오류 | content.reason, line, column에 따라 JSON을 수정하세요. |
| 400 | ft.JsonFormatError | JSON 최상위가 객체가 아니거나 정책이 객체가 아님 | 일부 json 파일 형식 오류 | 매개변수 표에 따라 객체를 제출하고 storagePolicy는 JSON 객체를 사용하세요. |
| 429 | ft.OperationTooFrequently | 동일 워크스페이스의 스토리지 쓰기/인덱스 관계에 대한 동시 작업 또는 잠금 리스 만료 | 작업이 너무 빈번합니다. 잠시 후 다시 시도하세요 | 진행 중인 작업이 완료될 때까지 기다린 후 백오프하여 재시도하고 먼저 현재 상태를 조회하세요. |
| 500 | ft.InternalServerError | 데이터베이스, 캐시, 다운스트림 연결/일반 5xx 또는 필드 형태 이상 | 내부 오류 | 먼저 설정을 읽고 실제 스토리지 현재 상태를 확인하세요. 계속 실패하면 traceId를 제공하세요. 오류를 저장되지 않은 상태로 간주하거나 생성을 곧바로 반복하지 마세요. |
| 406 | ft.InvalidDuration | 보존 문자열 형식 또는 현재 버전에서 허용되는 범위와 일치하지 않음 | 유효하지 않은 duration | 정수+d를 사용하고 버전에서 선택 가능한 기간을 확인하세요. |
| 406 | ft.InvalidDurationRange | 표준/장기 보존이 범위를 초과했거나 장기 보존이 표준 기간보다 크지 않음 | 유효한 데이터 보존 기간 범위를 초과했습니다 | 두 기간과 현재 워크스페이스 기능을 확인하세요. |
| 400 | ft.InvalidActionForbiddenChange | 버전 또는 로그 스토리지 유형에서 장기 정책 활성화를 허용하지 않음 | 인덱스 병합 상태 스위치 변경 금지 | 지원되는 버전과 scopedb 로그에서만 활성화하세요. |
| 406 | ft.CurrentVersionUnsupportRp | 현재 버전에서 스토리지 정책 변경을 지원하지 않음 | 현재 버전은 rp:{}를 지원하지 않습니다 |
관리자가 워크스페이스 버전 기능을 확인하도록 하세요. |
| 404 | ft.MissingVolctlsHotRetention | TLS setting에 0이 아닌 hot_retention이 없음 | Volcengine 스토리지, 표준 스토리지(핫 스토리지) 필드 누락 | 핫 스토리지 시간 수와 필요한 콜드/아카이브 필드를 완전하게 제공하세요. |
| 400 | ft.InvalidHotRetention | TLS 핫 기간이 하루 단위 시간 수가 아님 | Volcengine 스토리지, 유효하지 않은 핫 데이터 스토리지 기간, 하루 단위 시간 수여야 합니다 | 일수×24를 사용하세요. |
| 400 | ft.InvalidRetention | TLS 특정 단계 기간이 범위를 초과 | Volcengine 스토리지, 유효하지 않은 {} 스토리지 기간, 범위 {}일 | 이 페이지의 콜드/핫/아카이브 범위에 따라 시간 수를 입력하세요. |
| 400 | ft.InvalidRetentionFullDayhours | 콜드/아카이브가 하루 단위 시간 수가 아님 | Volcengine 스토리지, 유효하지 않은 {} 스토리지 기간, 하루 단위 시간 수여야 합니다 | 24의 정수 배수를 사용하세요. |
| 400 | ft.InvalidColdRententionHot | 콜드 스토리지가 있을 때 핫 단계가 7일 미만 | 스토리지 엔진에 저빈도 스토리지가 있으면 표준 스토리지는 {}일 이상이어야 합니다 | 핫 단계는 최소 168시간이어야 합니다. |
| 400 | ft.InvalidArchiveRententionHot | 아카이브가 있을 때 핫 단계가 30일 미만 | 스토리지 엔진에 아카이브 스토리지가 있으면 표준 스토리지는 {}일 이상이어야 합니다 | 핫 단계는 최소 720시간이어야 합니다. |
| 400 | ft.InvalidAllRetention | TLS 총 보존 기간이 허용 범위를 초과 | Volcengine 스토리지, 유효하지 않은 총 스토리지 기간, 범위 {}일 | 합계가 1800일(43200시간)을 초과하지 않도록 하세요. |
| 406 | ft.InvalidParameter | advanced 노드 유형, 구조, 값 배열 또는 논리 관계 오류 | 매개변수 {}가 유효하지 않습니다 |
group/rule 구조를 사용하고 존재 여부 유형 외의 value 배열은 비어 있지 않게 하세요. |
| 406 | ft.InvalidOperationSymbol | 필터 연산자가 지원되지 않음 | 유효하지 않은 연산자 {} |
basic/advanced에 해당하는 연산을 선택하세요. |
| 400 | ft.SpecialCharactersExist | 필드 이름 또는 정규식에 허용되지 않는 백틱이 있음 | 연산자 왼쪽에 특수 문자가 있습니다 | 실제 필드 또는 정규식 값을 전달하고 인위적으로 백틱을 추가하지 마세요. |
| 406 | ft.UnsupportRuleType | basic 조건에서 operation=match/not match 사용 | 지원되지 않는 규칙 유형: {} |
지원되는 basic 조건을 사용하거나 advanced로 전환하세요. |
| 400 | ft.NotEnabledLogIndexCfg | 워크스페이스에서 다중 인덱스를 활성화하지 않음 | 워크스페이스에서 로그 다중 인덱스 설정이 활성화되지 않았거나 이미 비활성화되었습니다 | 관리자가 활성화하고 워크스페이스 지원 여부를 확인하도록 하세요. |
| 400 | ft.ForIndexCfgNameExists | 현재 워크스페이스에 삭제되지 않은 동일 이름 인덱스가 있음 | 지정한 인덱스 설정 이름이 이미 존재합니다 | 고유한 이름으로 변경하세요. |
| 400 | ft.LogIndexCfgQuantityExceedsMaximumValue | 내부 인덱스/클론 수가 워크스페이스 할당량을 초과 | 사용자 지정 로그 인덱스 설정 수가 최대값 {}을 초과했습니다 | 기존 인덱스를 확인한 후 방안 또는 할당량을 조정하세요. 비활성화해도 할당량은 해제되지 않습니다. |
| 400 | ft.InvalidLogIndexName | ES 로그 스토리지의 생성 이름에 하이픈이 포함됨 | 유효하지 않은 인덱스 이름 | 하이픈이 없는 이름으로 변경하세요. |
| 403 | ft.Forbidden | 권한 부족 또는 현재 버전에서 해당 API를 허용하지 않음 | 작업 권한이 없습니다 | 해당 인덱스 권한이 있는 API Key와 지원 버전을 사용하세요. |