기본 유형 인덱스 구성 수정¶
POST /api/v1/log_index_cfg/{cfg_uuid}/modify
개요¶
기본 저장소 유형 인덱스 구성 수정
경로 매개변수¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| cfg_uuid | string | Y | 구성 UUID |
본문 요청 매개변수¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| desc | string | 인덱스 설명 예시: xxx 빈 값 허용: False 빈 문자열 허용: True 최대 길이: 1024 |
|
| extend | json | 프론트엔드 사용자 정의 데이터 빈 값 허용: True |
|
| duration | string | 데이터 보존 기간 빈 값 허용: False 예시: 7d |
|
| storagePolicy | json | 장기 저장 정책. 로그가 scopedb 저장소를 사용하는 워크스페이스에서만 활성화 가능. pay, enterprise, unlimited는 로그 장기 저장 지원. enterprise/unlimited의 logging 최대 1800일. enterprise/unlimited의 rp는 사용자 정의 장기 저장 기간 지원(최대 3600일). unlimited는 BossAccountSet 활성화 시 metric_point_total 과금 유형만 지원, 비활성화 시 metric_point_total로 처리. longStorageEnabled 및 longStorageDuration 포함 예시: {'longStorageEnabled': True, 'longStorageDuration': '180d'} 빈 값 허용: False |
|
| isFullLineIndex | int | 전체 라인 인덱스 여부. 0/false는 message 필드 인덱스 유지, 1/true는 전체 라인 인덱스, 기본값 0. 로그 저장소가 scopedb인 워크스페이스만 1로 설정 가능 빈 값 허용: False |
|
| setting | json | 관련 설정 정보 빈 값 허용: False |
|
| setting.hot_retention | int | Volcengine 스토리지, 표준 스토리지-핫 스토리지 빈 값 허용: False |
|
| setting.cold_retention | int | Volcengine 스토리지, 저주파 스토리지-콜드 데이터 빈 값 허용: False |
|
| setting.archive_retention | int | Volcengine 스토리지, 아카이브 스토리지-아카이브 데이터 빈 값 허용: 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"
}