내보내기¶
POST /api/v1/log_index_cfg/export
개요¶
필터 조건에 따라 내부 로그 인덱스 및 해당 클론 템플릿 JSON을 내보냅니다.
호출 전 및 사용 단계¶
URL Query로 필터를 제출합니다. Query가 비어 있지 않으면 POST에 JSON Body가 필요 없으며 Query를 우선 읽습니다. 전체 내보내기는 ?search= 빈 문자열을 명시적으로 사용하여 Query가 존재하도록 할 수 있습니다. Query를 완전히 생략하는 경우 Content-Type: application/json 및 {}를 전송해야 하며, 그렇지 않으면 JSON이 아닌 Body를 읽어 오류가 발생할 수 있습니다. 혼용하지 마십시오. 이 워크스페이스의 삭제되지 않았고, 기본이 아니며, 외부 바인딩이 아니고, 클론 독립 항목이 아닌 항목만 내보냅니다. A 이름 오름차순으로 정렬하며, A에는 cloneConfig와 양쪽 fields가 포함됩니다. 반환 결과는 JSON 통합 래퍼의 배열이며, ZIP/파일 다운로드 또는 비동기 작업이 아닙니다. 성공해도 인덱스나 데이터를 수정하지 않습니다.
공개된 isBindCustomStore는 구현과 역사적 차이가 있습니다. 구현은 이를 무시하고 바인딩을 고정적으로 제외하므로, true로 바인딩 내보내기를 요청하거나 반환이 비어 있을 것이라고 의존할 수 없습니다. 마이그레이션 시 content에서 템플릿을 추출하고 공통 declaration을 제거한 뒤 import의 logIndexes 필드에 따라 제출하며, 대상 스토리지/보존/전체 행 기능을 확인하십시오.
요청 헤더¶
| 파라미터 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
| DF-API-KEY | string | Y | 워크스페이스의 OpenAPI 인증 자격 증명입니다. 예: <DF-API-KEY>조회 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다. |
Query 요청 파라미터¶
| 파라미터 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
| isBindCustomStore | boolean | 호환 조회 필드로 현재 구현 필터링에 참여하지 않습니다. 값과 관계없이 바인딩 인덱스를 제외하며, true도 빈 결과를 보장하지 않습니다.예: false조회 또는 입력 방법: 이 내보내기는 내부 인덱스만 지원하므로 false를 사용합니다. |
|
| isDirectIndex | boolean | 선택 사항이며, A의 직접 쓰기 표시로 필터링합니다. 예: false조회 또는 입력 방법: true는 직접 쓰기, false는 직접 쓰기 아님을 의미하며, 생략하면 두 유형 모두입니다. |
|
| queryType | commaArray | 선택 사항인 정확한 카테고리 필터이며, 생략하면 필터링하지 않습니다. 예: logging조회 또는 입력 방법: 목록의 queryType에서 실제 값을 가져오며, 여러 개는 영문 쉼표로 구분하고 공백을 넣지 않습니다. |
|
| search | string | 선택 사항이며, B가 일치하면 해당 A 및 내장된 B를 내보냅니다. 빈 문자열 허용: True 예: production조회 또는 입력 방법: A 또는 B 이름의 키워드와 일치시킵니다. |
파라미터 추가 설명¶
이 API는 로그 인덱스 템플릿을 별도로 내보내는 데 사용되며, 워크스페이스 리소스 내보내기 작업을 거칠 필요가 없습니다.
요청 설명
- 내보내기 파라미터는 로그 인덱스 목록 API와 일관되지만, 페이지네이션 및 워크스페이스 간 관련 파라미터는 지원하지 않습니다.
- 현재 지원되는 필터 파라미터는
search,queryType,isDirectIndex,isBindCustomStore입니다. - 현재 워크스페이스의 내부 로그 인덱스만 내보냅니다.
default인덱스 및 외부 인덱스는 내보내지 않습니다.- 반환 결과는 JSON 목록이며,
/log_index_cfg/import의 입력 템플릿으로 직접 사용할 수 있습니다.
내보내기 필드
| 필드 | type | 설명 |
|---|---|---|
| name | string | 인덱스 이름 |
| desc | string | 인덱스 설명 |
| directIndex | boolean | 네이티브 직접 쓰기 인덱스 여부 |
| isFullLineIndex | int | 전체 행 인덱스 여부, 0은 message 필드 인덱스 유지, 1은 전체 행 인덱스; 로그 스토리지가 scopedb인 워크스페이스만 1로 설정 가능 |
| conditions | string | 인덱스 매칭 조건 |
| duration | string | 저장 기간 |
| storagePolicy | json | 장기 스토리지 정책 |
| extend | json | 확장 설정 |
| setting | json | 스토리지 설정 |
| fields | array | 필드 매핑 설정 |
| cloneConfig | json/null | 클론 인덱스 전체 설정; 클론 인덱스가 없으면 null |
| is_disable | boolean | 비활성화 여부 |
요청 예시¶
curl --request POST 'https://openapi.guance.com/api/v1/log_index_cfg/export?search=production&isDirectIndex=false' \
-H 'DF-API-KEY: <DF-API-KEY>'
응답¶
HTTP 200, application/json. 아래 예시는 직접 읽을 수 있는 주요 필드를 보여줍니다.
| 필드 | 타입 | 설명 |
|---|---|---|
| content | array<object> |
일치하는 내부 소스 인덱스 템플릿 배열이며, 결과가 없으면 []입니다. 클론은 A에 내장되어 독립 항목으로 제공되지 않습니다. |
| content[].name | string | 생성 시 필수입니다. 선언상 최대 256자이지만 실제 저장 컬럼은 128자이므로 128자 이내를 권장합니다. ES 로그 스토리지에서는 하이픈을 허용하지 않습니다. default 예약명 또는 다른 인덱스 UUID를 사용하지 마십시오. 일반 인덱스는 modify로 이름을 변경할 수 없습니다. |
| content[].desc | string | 선택 설명이며 최대 1024자입니다. 일반 modify에서 생략하면 유지되고, 빈 문자열이면 지워집니다. 외부 바인딩 수정에서 생략하면 지워집니다. |
| content[].duration | string | 일반 생성 시 기본값은 보통 3d입니다. 비TLS 스토리지에서 pay는 기본적으로 3d/7d/14d/30d/60d/90d를 허용하고, enterprise/unlimited는 기본적으로 1d부터 1800d까지 허용하며, 구체적인 값은 사이트 설정을 따릅니다. modify에서 생략하면 유지됩니다. TLS는 setting을 보며 이 필드로 실제 기간을 제어하지 않습니다. |
| content[].storagePolicy | json | 선택적 전체 장기 정책 객체입니다. 일반 생성에서 생략하면 {}입니다. 수정에서 생략하면 유지되고, {}는 비활성화로 정규화되며, 명시적으로 끄려면 longStorageEnabled=false를 사용합니다. 장기 기간은 표준 duration보다 반드시 커야 하며, 단위는 여전히 일(day)입니다. |
| content[].storagePolicy.longStorageEnabled | boolean | 객체 내에서 생략하면 기본값은 false입니다. 끄면 longStorageDuration이 빈 값으로 정규화되며, 기존 이력 데이터를 즉시 삭제한다는 의미는 아닙니다. |
| content[].storagePolicy.longStorageDuration | string | 활성화 시 조건부 필수입니다. 필드는 d가 포함된 문자열이며 초/시간이 아닙니다. 메트릭 rp의 3600d 범위를 로그에 적용하지 마십시오. |
| content[].directIndex | boolean | 선택 사항이며 생성 시 기본값은 false입니다. 직접 쓰기는 일반 매칭 순서에 따라 분기되지 않습니다. 일반 modify에는 이 필드가 없으며, 가져오기 recover도 기존 인덱스 모드를 변환하지 않습니다. |
| content[].isFullLineIndex | int | 0/1 또는 불리언만 허용합니다. scopedb 생성 시 기본값은 1이며 0은 허용하지 않습니다. 기존 Message는 0→1이 가능하지만 1→0은 불가능하며, 전환 시 message 필드 인덱스가 동기화되고 되돌릴 수 없습니다. modify에서 생략하면 유지됩니다. |
| content[].setting | json | 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 | json | 선택적 확장 객체로, 실제 매칭 및 표시 설정을 포함합니다. 일반 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[].conditions | string | 내보내기 호환 조건 문자열입니다. 가져오기 생성/덮어쓰기는 실제로 extend를 기준으로 다시 생성하며, 이 필드가 범위를 직접 결정하지 않습니다. |
| content[].fields | array | 필드 매핑입니다. 생략하면 기존 매핑을 유지하고, 명시적 []는 빈 값으로 덮어씁니다. 외부 modify의 빈 배열 동작과 다릅니다. |
| content[].fields[] | json | 단일 field/originalField 매핑입니다. |
| content[].fields[].field | string | 플랫폼 필드 이름입니다. |
| content[].fields[].originalField | string | 실제 소스 필드입니다. |
| content[].is_disable | boolean | 내보내기/가져오기 상태 키는 정확히 is_disable입니다. 기본값은 false이며, recover에서 원래 비활성화 상태이고 true를 전달하지 않으면 활성화됩니다. |
| content[].cloneConfig | json | 선택적 클론 B 템플릿이며, 없으면 null/생략입니다. 이로 인해 대상에 이미 있는 B가 삭제되지는 않으며, 일반 add/modify는 이 공개 파라미터를 지원하지 않습니다. |
| content[].cloneConfig.name | string | 클론 생성 시 필수이며 비어 있지 않은 이름이고 A 이름과 같을 수 없습니다. recover에서 B가 이미 있으면 대상의 원래 UUID와 이름을 사용하며, 가져오기 이름으로 이름을 변경하지 않습니다. |
| content[].cloneConfig.desc | string | 선택 설명이며 최대 1024자입니다. 일반 modify에서 생략하면 유지되고, 빈 문자열이면 지워집니다. 외부 바인딩 수정에서 생략하면 지워집니다. |
| content[].cloneConfig.duration | string | 일반 생성 시 기본값은 보통 3d입니다. 비TLS 스토리지에서 pay는 기본적으로 3d/7d/14d/30d/60d/90d를 허용하고, enterprise/unlimited는 기본적으로 1d부터 1800d까지 허용하며, 구체적인 값은 사이트 설정을 따릅니다. modify에서 생략하면 유지됩니다. TLS는 setting을 보며 이 필드로 실제 기간을 제어하지 않습니다. |
| content[].cloneConfig.storagePolicy | json | 선택적 전체 장기 정책 객체입니다. 일반 생성에서 생략하면 {}입니다. 수정에서 생략하면 유지되고, {}는 비활성화로 정규화되며, 명시적으로 끄려면 longStorageEnabled=false를 사용합니다. 장기 기간은 표준 duration보다 반드시 커야 하며, 단위는 여전히 일(day)입니다. |
| content[].cloneConfig.storagePolicy.longStorageEnabled | boolean | 객체 내에서 생략하면 기본값은 false입니다. 끄면 longStorageDuration이 빈 값으로 정규화되며, 기존 이력 데이터를 즉시 삭제한다는 의미는 아닙니다. |
| content[].cloneConfig.storagePolicy.longStorageDuration | string | 활성화 시 조건부 필수입니다. 필드는 d가 포함된 문자열이며 초/시간이 아닙니다. 메트릭 rp의 3600d 범위를 로그에 적용하지 마십시오. |
| content[].cloneConfig.isFullLineIndex | int | 0/1 또는 불리언만 허용합니다. scopedb 생성 시 기본값은 1이며 0은 허용하지 않습니다. 기존 Message는 0→1이 가능하지만 1→0은 불가능하며, 전환 시 message 필드 인덱스가 동기화되고 되돌릴 수 없습니다. modify에서 생략하면 유지됩니다. |
| content[].cloneConfig.setting | json | 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 | json | 클론은 비어 있지 않은 매칭 조건을 생성할 수 있는 extend를 반드시 제공해야 합니다. A 조건과 결합한 뒤 매칭하며 빈 그룹을 사용할 수 없습니다. recover는 전체 교체합니다. |
| 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[].cloneConfig.conditions | string | 내보내기 호환 조건 문자열입니다. 가져오기 생성/덮어쓰기는 실제로 extend를 기준으로 다시 생성하며, 이 필드가 범위를 직접 결정하지 않습니다. |
| content[].cloneConfig.fields | array | 필드 매핑입니다. 생략하면 기존 매핑을 유지하고, 명시적 []는 빈 값으로 덮어씁니다. 외부 modify의 빈 배열 동작과 다릅니다. |
| content[].cloneConfig.fields[] | json | 단일 field/originalField 매핑입니다. |
| content[].cloneConfig.fields[].field | string | 플랫폼 필드 이름입니다. |
| content[].cloneConfig.fields[].originalField | string | 실제 소스 필드입니다. |
| content[].cloneConfig.is_disable | boolean | 내보내기/가져오기 상태 키는 정확히 is_disable입니다. 기본값은 false이며, recover에서 원래 비활성화 상태이고 true를 전달하지 않으면 활성화됩니다. |
| content[].declaration | object | 비어 있지 않은 각 배열 객체에는 워크스페이스 선언이 첨부되며, 가져올 때 이 추가 필드를 제거합니다. |
{
"code": 200,
"content": [
{
"name": "production_logs",
"desc": "生产服务日志。",
"duration": "7d",
"directIndex": false,
"isFullLineIndex": 1,
"extend": {
"matchMode": "basic",
"filters": [
{
"name": "env",
"condition": "and",
"operation": "=",
"value": [
"production"
]
}
]
},
"conditions": "{ `env` = 'production' }",
"storagePolicy": {},
"setting": {},
"fields": [],
"is_disable": false,
"cloneConfig": null,
"declaration": {}
}
],
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
오류 응답¶
인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참고하십시오.
| HTTP 상태 | errorCode | 발생 조건 | 메시지 또는 응답 설명 | 처리 방법 |
|---|---|---|---|---|
| 406 | ft.ParameterValidationFailed | 선언되지 않은 Query 파라미터를 사용했거나 파라미터가 규칙을 위반함 | 파라미터 파싱 실패 | Query 파라미터 표 및 예시를 확인하십시오. |
| 404 | ft.LogIndexCfgNoExists | 내보내기에서 상세를 읽을 때 대상이 동시에 삭제됨 | 지정한 로그 인덱스 설정이 존재하지 않음 | 다시 내보내어 목록을 새로 고치십시오. |
| 500 | ft.InternalServerError | 설정 또는 매핑 읽기/포맷팅 실패 | 내부 오류 | 필터를 좁힌 후 다시 시도하고, 계속 실패하면 traceId를 제공하십시오. |
| 403 | ft.Forbidden | 권한이 부족하거나 현재 버전에서 해당 API를 허용하지 않음 | 작업 권한이 없습니다 | 해당 인덱스 권한이 있는 API Key와 지원 버전을 사용하십시오. |