기본 유형 인덱스 구성 수정¶
POST /api/v1/log_index_cfg/{cfg_uuid}/modify
개요¶
기본 저장 유형 인덱스 구성을 수정합니다.
경로 매개변수¶
| 매개변수 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| cfg_uuid | string | Y | 구성 uuid |
Body 요청 매개변수¶
| 매개변수 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| desc | string | 인덱스 설명 예시: xxx Null 허용: False 빈 문자열 허용: True 최대 길이: 1024 |
|
| extend | json | 프론트엔드 사용자 지정 데이터 Null 허용: True |
|
| duration | string | 데이터 보존 기간 Null 허용: False 예시: 7d |
|
| storagePolicy | json | 장기 저장 정책, 로그는 scopedb 저장 워크스페이스에서만 활성화할 수 있습니다. pay, enterprise, unlimited는 로그 장기 저장을 지원하며, enterprise/unlimited의 logging은 최대 1800d입니다. enterprise/unlimited의 rp는 장기 저장 기간을 사용자 지정할 수 있습니다(최대 3600d). unlimited는 BossAccountSet이 활성화된 경우 metric_point_total 과금 유형만 지원하며, 비활성화된 경우 metric_point_total로 처리됩니다. longStorageEnabled 및 longStorageDuration을 포함합니다. 예시: {'longStorageEnabled': True, 'longStorageDuration': '180d'} Null 허용: False |
|
| isFullLineIndex | int | 전체 행 인덱스 여부, 정수 0/1 또는 불리언 false/true를 지원합니다. 기존 Scopedb Message 인덱스는 0/false에서 1/true로 전환할 수 있으며, 전환은 되돌릴 수 없습니다. 미전달 시 기존 구성을 유지합니다. Null 허용: False |
|
| setting | json | 관련 설정 정보 Null 허용: False |
|
| setting.hot_retention | int | Volcengine 스토리지, 표준 스토리지-핫 스토리지 Null 허용: False |
|
| setting.cold_retention | int | Volcengine 스토리지, 저빈도 스토리지-콜드 데이터 Null 허용: False |
|
| setting.archive_retention | int | Volcengine 스토리지, 아카이브 스토리지-아카이브 데이터 Null 허용: False |
매개변수 추가 설명¶
extend의 일치 조건 설명
| 매개변수 이름 | type | 필수 | 설명 |
|---|---|---|---|
| matchMode | String | 일치 모드, 선택 가능한 값: basic, advanced, 기본값은 basic으로 처리됩니다 |
|
| filters | Array[dict] | 일반 일치 필터 조건 목록, advanced 모드에서는 빈 배열 전달을 권장합니다 |
|
| advancedFilter | Dict | 고급 일치 조건 트리, matchMode=advanced일 때 적용됩니다 |
advancedFilter 루트 노드는 항상 group이며, group.filters에는 rule 또는 group을 중첩할 수 있습니다. rule.operation 선택 가능한 값: =, !=, in, not_in, match, not_match, wildcard, not_wildcard, regexp, not_regexp, >, <, >=, <=, exist, not_exist입니다. value는 항상 배열이며, exist / not_exist는 빈 배열을 사용합니다. matchMode=advanced일 때 백엔드는 DQL where 스타일로 conditions를 생성하며, 일반 filters는 기존 생성 형식을 유지합니다.
요청 예시¶
curl 'https://openapi.guance.com/api/v1/log_index_cfg/lgim_xxxx32/modify' \
-H 'Accept: application/json, text/plain, */*' \
-H 'Accept-Language: zh' \
-H 'Content-Type: application/json;charset=UTF-8' \
-H 'DF-API-KEY: <DF-API-KEY>' \
--data-raw '{"duration":"7d","isFullLineIndex":1,"extend":{"filters":[{"condition":"and","name":"host","operation":"in","value":["guance"]}]}}' \
--compressed
응답¶
{
"code": 200,
"content": {
"conditions": "{ `host` in [ 'guance' ] }",
"createAt": 1698751853,
"creator": "xxx",
"deleteAt": -1,
"duration": "7d",
"extend": {
"filters": [
{
"condition": "and",
"name": "host",
"operation": "in",
"value": [
"guance"
]
}
]
},
"exterStoreName": "",
"exterStoreProject": "",
"externalResourceAccessCfgUUID": "",
"id": 1376,
"isBindCustomStore": 0,
"isFullLineIndex": 1,
"isPublicNetworkAccess": 0,
"name": "test_index",
"queryType": "logging",
"region": "",
"setting": {},
"sortNo": 3,
"status": 0,
"storeType": "",
"updateAt": 1698752013.27368,
"updator": "xx",
"uuid": "lgim_xxxx32",
"workspaceUUID": "wksp_xxxx32"
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-09F7E56D-1DE5-48C9-A77A-108A53462A75"
}