워크스페이스-인덱스 템플릿 구성¶
POST /api/v1/workspace/{workspace_uuid}/update_index_setting
개요¶
지정된 워크스페이스 데이터 유형의 인덱스 템플릿, 핫 스토리지, 매핑 및 보존 정책을 업데이트합니다.
호출 전 및 사용 단계¶
먼저 인덱스 템플릿 목록을 호출하여 현재 데이터 유형, 스토리지 엔진, 병합 모드 및 대상 로그 인덱스 UUID를 확인하고, 현재 값을 백업한 후 수정하십시오. 템플릿 매개변수는 엔진 기능에 의해 제한됩니다. ES는 샤드/레플리카/고급 매핑을 지원하고, Doris는 주로 핫 스토리지를 구성하며, VolcTLS는 핫/콜드/아카이브를 구성합니다. SLS/Beaver는 이 API를 금지합니다. 템플릿 또는 mappings 변경을 적용하려면 반드시 hotRetention을 함께 전달해야 합니다. 이 경우 템플릿은 사이트 기본값에서 구성된 후 이번 매개변수로 덮어쓰며, 기존 템플릿과 필드 병합을 수행하지 않습니다. 샤드, 레플리카, 롤오버 임계값, 고급 스위치 등을 생략하면 기본값으로 복원되거나 이전 값이 제거될 수 있으며, 기존 고급 구성이 비활성화될 수도 있습니다. 반드시 먼저 읽고 전체 대상 템플릿을 제출해야 합니다. 아래 요청 예시는 datastore.logging=doris가 확인된 워크스페이스에만 적용됩니다. ES는 전체 템플릿을 사용하고, VolcTLS는 각 계층의 대상 기간을 명확히 지정하십시오. 보존 기간만 수정하는 경우 duration 또는 storagePolicy를 전달할 수 있습니다. mappings를 생략하는 것은 기존 매핑을 자동 병합하는 것이 아닙니다. 고급 구성을 활성화할 때는 먼저 전체 매핑을 확보해야 합니다. 성공 후 인덱스 템플릿을 다시 읽어 확인하십시오. 다운스트림 업데이트와 데이터베이스 커밋은 하나의 트랜잭션이 아니므로 실패 시 먼저 양쪽의 실제 상태를 확인하십시오.
경로 매개변수¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| workspace_uuid | string | Y | 대상 워크스페이스 UUID; 계정 UUID가 아니며 수집 Token도 아닙니다. 예시: wksp_example001가져오기 또는 입력 방법: 워크스페이스 목록의 content.data[].uuid 또는 생성 성공 시 content.wsInfo.uuid에서 가져오고, 사이트와 워크스페이스 이름을 확인합니다. |
요청 헤더¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| X-Df-SVersion | string | 예시와 일치해야 하며, 생략한 후 이어서 이 알고리즘을 사용할 수 없습니다. 예시: v20240417가져오기 또는 입력 방법: 이 페이지의 원본 경로 및 요청 본문 서명 알고리즘에 맞추어 입력합니다. |
|
| X-Df-Access-Key | string | Y | 여기서 일곱 항목은 모두 쓰기 작업이므로 External 쓰기 권한이 필요합니다. 예시: <external-access-key>가져오기 또는 입력 방법: 사이트 관리자가 w 권한이 있는 External API AK를 할당합니다. 워크스페이스 OpenAPI Key가 아닙니다. |
| X-Df-Nonce | string | Y | 다시 전송할 때마다 이 값과 서명도 갱신합니다. 예시: 97d275ee9f774315a7885ba7347acbd9가져오기 또는 입력 방법: 요청마다 uuid.uuid4().hex를 새로 생성합니다. |
| X-Df-Signature | string | Y | 대문자 메서드, nonce, 원본 전체 경로, timestamp 및 원본 UTF-8 요청 본문을 공백으로 연결한 후 HMAC-SHA256 hex 다이제스트를 계산합니다. 예시: <hmac-sha256-hex>가져오기 또는 입력 방법: 함께 제공된 SK를 사용하여 External API 서명 인증 및 아래 Python 템플릿에 따라 계산합니다. |
| X-Df-Timestamp | string | Y | 예시의 고정 시간을 재사용할 수 없으며, 사이트 서명 유효 기간 내에 있어야 합니다. 예시: 1785427200가져오기 또는 입력 방법: 전송 시 str(int(time.time()))로 현재 Unix 초를 생성합니다. |
Body 요청 매개변수¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| storagePolicy.longStorageEnabled | boolean | false는 명시적으로 끕니다. storagePolicy 객체를 제출하는 한 이 키를 생략하면 false로 정규화되므로 기존 정책이 꺼질 수 있습니다. 기존 정책을 유지하려면 storagePolicy 객체 전체를 생략해야 합니다. 예시: false가져오기 또는 입력 방법: JSON 불리언 값으로 켜거나 끄며, 엔진 및 버전 조건을 충족해야 합니다. |
|
| storagePolicy.longStorageDuration | string | 켤 때 제공하며, 끌 때는 생략할 수 있습니다. 예시: 180d가져오기 또는 입력 방법: 사이트에서 허용된 집합에서 선택하며, 현재 또는 이번 duration보다 커야 합니다. |
|
| mappings.{매핑 항목} | any | 자유 구조이며, 하나의 예시 매핑 키를 모든 엔진이 지원하는 통합 필드로 간주할 수 없습니다. 예시: {}가져오기 또는 입력 방법: 사이트 관리자가 인덱스 엔진의 기존 매핑 구성에서 내보내며, 해당 엔진 구조를 유지합니다. |
|
| archiveRetention | int | 선택적 정수, 단위 시간; VolcTLS 기본 범위는 60~1800일이며, 핫 스토리지는 최소 30일입니다. 핫, 콜드, 아카이브 총 기간은 1800일을 초과할 수 없으며 실제 사이트 범위가 이를 덮어쓸 수 있습니다. null 허용: False 예시: 1440가져오기 또는 입력 방법: VolcTLS에서 아카이브 스토리지 요구 사항에 따라 제공하며, 시간 단위로 전체 일수를 입력합니다. |
|
| cfg_uuid | string | 선택 사항이며, logging만 이 UUID로 독립 로그 인덱스를 선택하는 것을 지원합니다. 비로그 유형에는 제공하지 마십시오. 인덱스는 대상 워크스페이스에 속하고 삭제되지 않아야 합니다. 빈 문자열 허용: True null 허용: False 예시: 가져오기 또는 입력 방법: 기본 인덱스는 생략하거나 빈 문자열로 둡니다. 사용자 지정 로그 인덱스를 수정할 때는 인덱스 템플릿 목록의 content.otherLogIndexSettings[].uuid에서 가져옵니다. |
|
| coldRetention | int | 선택적 정수, 단위 시간, 현재 VolcTLS 검증 후 적용됩니다. 다른 엔진의 수용 여부는 다운스트림에서 결정하며 일반 기능으로 간주해서는 안 됩니다. VolcTLS 기본 범위는 30~1800일이며, 핫 스토리지를 동시에 제공해야 하고 최소 7일이어야 합니다. null 허용: False 예시: 720가져오기 또는 입력 방법: VolcTLS에서 저빈도 스토리지 요구 사항에 따라 제공하며, 시간 단위로 전체 일수를 입력합니다. |
|
| data_type | string | Y | 필수 enum rum, logging, network, tracing, profiling, keyevent, security, backup_log, apm, dialtest. 병합 모드는 일반적으로 apm을 사용하고, 분할 모드는 tracing/rum/profiling 등을 사용합니다. 이 External 선언은 rp 또는 lineage를 지원하지 않으므로 다른 실행 환경의 입력값을 그대로 복사할 수 없습니다. null 허용: False 선택 가능한 값: ['rum', 'logging', 'network', 'tracing', 'profiling', 'keyevent', 'security', 'backup_log', 'apm', 'dialtest'] 예시: logging가져오기 또는 입력 방법: 인덱스 템플릿 목록에서 datastore와 esIndexMerged를 확인한 후 해당 모드에 실제로 존재하는 데이터 유형을 선택합니다. |
| duration | string | 선택적 표준 총 보존 기간, 숫자+d; 생략하거나 빈 문자열이면 원래 값을 사용합니다. VolcTLS가 아닌 워크스페이스 수준 및 사용자 지정 로그 인덱스는 보존 기간 변경 경로를 사용하며, VolcTLS 워크스페이스 수준은 주로 hot/cold/archive로 표준 총 기간을 계산합니다. 버전에서 허용하는 집합/범위의 제한을 받습니다. null 허용: False 예시: 7d가져오기 또는 입력 방법: 인덱스 템플릿 목록의 durationSet에서 해당 유형 또는 사용자 지정 인덱스의 duration을 읽은 후 조정합니다. |
|
| hotRetention | int | 선택적 정수, 단위 시간, 0 사용 가능 여부는 엔진이 결정하며 음수는 거부됩니다. ES/Doris는 핫 데이터 기간을 구성할 수 있고, VolcTLS는 반드시 양수이며 하루를 시간으로 환산한 값이어야 합니다. 템플릿 또는 mappings를 수정해야 할 때는 반드시 이 필드를 함께 전달해야 하며, 샤드/고급 필드만 전달하면 현재 적용되지 않습니다. hotRetention이 포함되면 사이트 기본값에 따라 이번 템플릿을 보완하며, 다른 기존 필드를 생략하면 해당 필드가 재설정될 수 있습니다. 부분 병합 업데이트가 아닙니다. null 허용: False 예시: 24가져오기 또는 입력 방법: 인덱스 템플릿 목록의 현재 esIndexSettings 또는 otherLogIndexSettings[].setting.hot_retention에서 읽습니다. |
|
| mappings | json | 선택적 JSON 객체이며, 인덱스 UUID가 아닙니다. 매핑 구조는 다운스트림 엔진에서 정의하며 Studio는 객체를 그대로 전달하고 각 동적 매핑 항목에 공통 유형을 정의하지 않습니다. hotRetention이 존재하고 openAdvancedConfig가 true일 때만 업데이트를 시도하며, 생략 시 기본값은 {}입니다. 활성화할 때는 확인된 전체 매핑을 제출하여 빈 객체로 덮어쓰지 않도록 해야 합니다. null 허용: False 예시: {}가져오기 또는 입력 방법: 사이트 관리자가 현재 인덱스 고급 매핑 구성에서 전체 객체를 가져옵니다. 이 External 모듈은 mappings를 읽는 인터페이스를 공개하지 않았습니다. |
|
| number_of_replicas | int | 선택적 레플리카 수, 정수, ES에서 사용; 0은 레플리카를 구성하지 않음을 의미하며 허용 여부는 엔진이 결정합니다. Doris/VolcTLS는 이 필드의 존재를 지원하지 않으며, 템플릿 변경 시 hotRetention을 함께 전달해야 합니다. hotRetention이 포함되면 사이트 기본값에 따라 이번 템플릿을 보완하며, 다른 기존 필드를 생략하면 해당 필드가 재설정될 수 있습니다. 부분 병합 업데이트가 아닙니다. null 허용: False 예시: 1가져오기 또는 입력 방법: ES 고가용성 요구 사항에 따라 선택하고, 먼저 사이트 레플리카 정책을 확인합니다. |
|
| number_of_shards | int | 선택적 기본 샤드 수, 정수, ES에서 사용; Doris/VolcTLS는 이 필드의 존재를 지원하지 않습니다. hotRetention을 동시에 제공해야 하며, 그렇지 않으면 해당 템플릿 변경이 적용되지 않습니다. hotRetention이 포함되면 사이트 기본값에 따라 이번 템플릿을 보완하며, 다른 기존 필드를 생략하면 해당 필드가 재설정될 수 있습니다. 부분 병합 업데이트가 아닙니다. null 허용: False 예시: 1가져오기 또는 입력 방법: 먼저 인덱스 템플릿 목록에서 현재 값 및 ES 지원 기능을 확인한 후 관리자 권장 사항에 따라 선택합니다. |
|
| openAdvancedConfig | int | 선택적 정수, 0/1을 권장합니다. ES에서 설정할 수 있으며, Doris/VolcTLS는 0을 전달해도 이 필드의 존재를 지원하지 않고, SLS/Beaver는 이 API의 인덱스 구성을 금지합니다. hotRetention과 함께 제출해야만 고급 구성이 처리됩니다. hotRetention이 포함되면 사이트 기본값에 따라 이번 템플릿을 보완하며, 다른 기존 필드를 생략하면 해당 필드가 재설정될 수 있습니다. 부분 병합 업데이트가 아닙니다. null 허용: False 예시: 0가져오기 또는 입력 방법: 현재 인덱스 구성에서 읽은 후 0 비활성화 또는 1 활성화를 선택하며, 고급 구성을 지원하는 엔진에서만 사용합니다. |
|
| rollover_max_size | int | 선택적 정수, 하위 인덱스 롤오버/분할 임계값입니다. Studio는 단위 변환을 하지 않으며 로그 바이트 분할 크기 loggingCutSize로 간주해서는 안 됩니다. 이 구성을 지원하는 ES 경로에서만 사용하며 hotRetention을 함께 전달해야 합니다. hotRetention이 포함되면 사이트 기본값에 따라 이번 템플릿을 보완하며, 다른 기존 필드를 생략하면 해당 필드가 재설정될 수 있습니다. 부분 병합 업데이트가 아닙니다. null 허용: False 예시: 30가져오기 또는 입력 방법: 대상 스토리지 엔진의 샤드 롤오버 정책에 따라 제공하고, 먼저 사이트 관리자에게 해당 엔진의 임계값 단위를 확인합니다. |
|
| storagePolicy | json | 선택적 단일 유형 장기 정책 객체이며, 더 이상 logging 키로 감싸지 않습니다. 생략하면 기존 정책을 유지합니다. 단일 정책에 {}를 전달하면 longStorageEnabled=false로 정규화되어 기존 장기 스토리지가 꺼질 수 있으므로, 종료를 표현하려면 false를 명시적으로 전달하는 것이 좋습니다. 현재 공개된 유형 중에서는 logging에만 장기 스토리지를 구성하는 것이 권장되며, 로그는 scopedb에서만 활성화를 지원합니다. 장기 스토리지는 총 보존 기간이며 해당 유형의 표준 보존 기간보다 커야 합니다. 로그는 scopedb에서만 지원되며 pay/enterprise/unlimited를 지원합니다. 지표는 과금 유형에 부합해야 하며, pay와 청구 센터가 활성화된 unlimited는 metric_point_total을 요구하고 enterprise 등도 명시적인 timeseries 과금을 거부합니다. 리포지토리 기본값으로 pay 로그는 90d/120d/180d/360d를 선택할 수 있고, pay 지표는 추가로 540d/720d를 선택할 수 있습니다. enterprise/unlimited 로그는 1d~1800d, 지표는 1d~3600d를 허용하며 여전히 표준 보존 기간보다 커야 합니다. 실제 선택 가능한 집합과 범위는 사이트 구성이 덮어쓸 수 있습니다. null 허용: False 예시: {"longStorageEnabled": false}가져오기 또는 입력 방법: 인덱스 템플릿 목록에서 해당 워크스페이스 수준 또는 사용자 지정 로그 인덱스의 storagePolicy에서 가져옵니다. |
매개변수 추가 설명¶
w 권한이 있는 사이트 수준 External API 자격 증명을 사용합니다. 인증 방식은 External API 서명 인증을 참조하십시오. 예시는 v20240417에 따라 서명을 계산하며, 서명과 전송에는 동일한 경로, Query 및 원본 요청 본문을 사용합니다. 모든 예시는 데모 값이므로 실행 전에 실제 대상으로 교체하십시오. 쓰기 요청이 타임아웃되거나 500이 발생하면 먼저 현재 상태를 조회하고 확인한 후 재시도 여부를 결정해야 합니다.
VolcTLS의 핫, 콜드, 아카이브 매개변수는 모두 시간 단위로 전달하고, 표준 duration은 일 단위로 표시합니다. 기본 각 계층 범위는 사이트에서 덮어쓸 수 있습니다. 전체 규칙은 매개변수 표를 참조하십시오.
ES 전체 대상 요청 본문 예시: 먼저 인덱스 템플릿 목록에서 현재 값을 복사한 다음 조정이 필요한 값만 변경합니다. 아래 수치는 예시일 뿐입니다. openAdvancedConfig=1일 때는 관리자가 제공한 전체 mappings 객체를 동시에 제출해야 하며, 이 스위치를 생략하면 기존 고급 구성이 꺼질 수 있습니다.
{
"data_type": "logging",
"hotRetention": 24,
"number_of_shards": 1,
"number_of_replicas": 1,
"rollover_max_size": 30,
"openAdvancedConfig": 0
}
요청 예시¶
import hashlib
import hmac
import json
import time
import uuid
from urllib.parse import urlencode
from urllib.request import Request, urlopen
# 이 예시는 datastore.logging=doris가 확인된 워크스페이스에만 사용됩니다.
# ES는 먼저 전체 대상 템플릿을 읽고 제출해야 하며, 핫 스토리지 매개변수만 그대로 복사할 수 없습니다.
# 대상 사이트 주소 및 관리자가 할당한 External API AK/SK로 교체하십시오.
server = "https://external-api.guance.com"
access_key = "<external-access-key>"
secret_key = "<external-secret-key>"
method = 'POST'
path = '/api/v1/workspace/wksp_example001/update_index_setting'
query = {}
data = {'data_type': 'logging', 'hotRetention': 24}
full_path = path + ("?" + urlencode(query) if query else "")
body = "" if data is None else json.dumps(data, ensure_ascii=False, separators=(",", ":"))
timestamp = str(int(time.time()))
nonce = uuid.uuid4().hex
string_to_sign = " ".join([method, nonce, full_path, timestamp, body])
signature = hmac.new(secret_key.encode("utf-8"), string_to_sign.encode("utf-8"), hashlib.sha256).hexdigest()
headers = {
"X-Df-Access-Key": access_key,
"X-Df-Timestamp": timestamp,
"X-Df-Nonce": nonce,
"X-Df-Signature": signature,
"X-Df-SVersion": "v20240417",
}
if data is not None:
headers["Content-Type"] = "application/json"
request = Request(server + full_path, data=None if data is None else body.encode("utf-8"), headers=headers, method=method)
with urlopen(request) as result:
print(result.read().decode("utf-8"))
응답¶
HTTP 200, application/json, 공통 응답 래퍼. 비즈니스 결과는 content에 있으며 External은 declaration을 자동으로 주입하지 않습니다. 워크스페이스 객체의 declaration은 자체 저장 필드입니다.
| 필드 | 유형 | 설명 |
|---|---|---|
| content | boolean | 성공 시 true; 업데이트된 필드 목록이 아닙니다. hotRetention이 누락되면 일부 템플릿 필드가 무시될 수 있으므로 true만으로 각 항목이 모두 적용되었다고 판단할 수 없습니다. |
{
"code": 200,
"content": true,
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
오류 응답¶
인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참조하십시오.
아래 표는 이 API의 비즈니스 검증 및 확인된 주요 오류 분기를 나열합니다. 다운스트림 서비스는 구체적인 오류 매핑에 따라 다른 4xx 오류를 반환할 수 있습니다. 일반 5xx 및 알 수 없는 예외는 전역 처리되어 ft.InternalServerError를 반환합니다. 쓰기 요청은 현재 구성과 오류 content를 함께 판단하여 이미 적용되었는지 확인해야 하며, HTTP 상태만으로 롤백을 추론할 수 없습니다.
| HTTP 상태 | errorCode | 트리거 조건 | 메시지 또는 응답 설명 | 처리 방법 |
|---|---|---|---|---|
| 406 | ft.ParameterValidationFailed | 요청 필드 누락 또는 필드 값이 선언된 검증 조건을 위반함 | 매개변수 구문 분석 실패 | 매개변수 위치, 필드명, 유형 및 값을 확인합니다. |
| 400 | ft.RequestJsonFormatError | 요청 JSON 구문이 유효하지 않음 | 요청 JSON 형식 오류 | content.reason, line, column에 따라 JSON을 수정합니다. |
| 400 | ft.JsonFormatError | JSON 최상위가 객체가 아님 | 일부 json 파일 형식 오류 | 매개변수 표에 따라 JSON 객체를 제출하고 배열이나 null을 전체 요청 본문으로 사용하지 마십시오. |
| 406 | ft.NotFoundWorkspace | 워크스페이스가 없거나 삭제되었거나 현재 활성 상태 조회 조건을 충족하지 않음 | 지정된 워크스페이스를 찾을 수 없음 | 워크스페이스 목록에서 유효한 UUID를 다시 가져오고 상태를 확인합니다. |
| 429 | ft.OperationTooFrequently | 동일 워크스페이스의 스토리지 구성 잠금이 점유되었거나 실행 중 잠금 소유권이 상실됨 | 작업이 너무 빈번합니다. 잠시 후 다시 시도하십시오 | 잠시 후 먼저 현재 구성을 읽고, 새 nonce와 서명으로 재시도합니다. 실행 중 잠금을 잃은 경우 모든 쓰기가 발생하지 않았다고 단정할 수 없습니다. |
| 400 | ft.InvalidAction | data_type이 선언 enum에는 있지만 현재 병합/분할 모드 지원 집합에는 없음 | 유효하지 않은 작업 | 먼저 인덱스 템플릿을 확인하고 해당 워크스페이스가 실제로 지원하는 유형을 사용합니다. |
| 404 | ft.NamespaceDatastoreNotFound | 현재 데이터 유형에 유효한 스토리지 엔진 구성이 없음 | {}의 스토리지 유형을 찾을 수 없음 | 먼저 인덱스 템플릿에서 datastore에 해당 유형이 있는지 확인하고, 구성이 없으면 관리자에게 처리하도록 요청합니다. |
| 404 | ft.ForbiddenIndexCfg | 대상 유형이 SLS 또는 Beaver를 사용하여 이 API 인덱스 구성을 지원하지 않음 | sls/beaver 스토리지 유형의 인덱스 구성을 지원하지 않음 | 해당 스토리지 서비스의 공식 구성 기능을 사용하거나 사이트 관리자가 조정하도록 합니다. |
| 404 | ft.ForbiddenAdvancedCfg | Doris 또는 VolcTLS 요청에 openAdvancedConfig 포함 | 스토리지 유형 {}의 고급 구성을 지원하지 않음 | 이 필드 및 mappings를 제거하고 엔진 지원 기능에 따라 설정합니다. |
| 404 | ft.ForbiddenShardReplicasCfg | Doris 또는 VolcTLS 요청에 샤드/레플리카/롤오버 임계값 필드 포함 | 스토리지 유형 {}의 샤드/레플리카 구성을 지원하지 않음 | number_of_shards, number_of_replicas, rollover_max_size를 제거합니다. |
| 406 | ft.InvalidParameter | hotRetention이 음수임 | 매개변수 {}이(가) 유효하지 않음 |
엔진이 지원하는 음수가 아닌 값을 시간 단위로 제공합니다. VolcTLS는 양의 하루 시간 수여야 합니다. |
| 404 | ft.LogIndexCfgNoExists | 보존 기간 또는 핫 스토리지 업데이트에 사용되는 cfg_uuid가 현재 워크스페이스에 속하지 않거나 삭제됨 | 지정된 로그 인덱스 구성을 찾을 수 없음 | 현재 워크스페이스 인덱스 템플릿 목록에서 사용자 지정 로그 인덱스 UUID를 다시 가져옵니다. |
| 404 | ft.MissingVolctlsHotRetention | VolcTLS 요청에 유효한 hotRetention이 제공되지 않음 | Volcengine 스토리지, 표준 스토리지(핫 스토리지) 필드 누락 | 양의 정수 핫 스토리지 시간 수를 제공합니다. |
| 400 | ft.InvalidHotRetention | VolcTLS 핫 스토리지가 24의 정수 배가 아님 | Volcengine 스토리지, 유효하지 않은 핫 데이터 스토리지 기간, 하루를 시간으로 환산한 값이어야 함 | 핫 스토리지 일수에 24를 곱하여 전체 일수에 해당하는 시간을 제공합니다. |
| 400 | ft.InvalidRetentionFullDayhours | VolcTLS 콜드 스토리지 또는 아카이브가 24의 정수 배가 아님 | Volcengine 스토리지, 유효하지 않은 {} 스토리지 기간, 하루를 시간으로 환산한 값이어야 함 | 해당 일수에 24를 곱하여 제출합니다. |
| 400 | ft.InvalidRetention | VolcTLS 특정 계층 기간이 사이트 허용 범위를 초과 | Volcengine 스토리지, 유효하지 않은 {} 스토리지 기간, 범위 {}일 | 핫/콜드/아카이브 각각의 범위에 맞게 조정합니다. |
| 400 | ft.InvalidColdRententionHot | VolcTLS 콜드 스토리지를 구성했지만 핫 스토리지가 사이트 최소 요구 사항보다 작음 | 스토리지 엔진에 저빈도 스토리지가 있을 때 표준 스토리지는 {}일 이상이어야 함 | 기본 핫 스토리지는 최소 7일이어야 하며 실제 사이트 요구 사항에 맞게 조정합니다. |
| 400 | ft.InvalidArchiveRententionHot | VolcTLS 아카이브를 구성했지만 핫 스토리지가 사이트 최소 요구 사항보다 작음 | 스토리지 엔진에 아카이브 스토리지가 있을 때 표준 스토리지는 {}일 이상이어야 함 | 기본 핫 스토리지는 최소 30일이어야 하며 실제 사이트 요구 사항에 맞게 조정합니다. |
| 400 | ft.InvalidAllRetention | VolcTLS 각 계층 총 기간이 사이트 범위를 초과 | Volcengine 스토리지, 유효하지 않은 총 스토리지 기간, 범위 {}일 | 기본 총 기간은 1800일을 초과하지 않아야 하며 각 계층 조합을 조정합니다. |
| 400 | ft.FreeWKSPLimit | 무료 플랜/무료 버전에서 표준 보존 기간 또는 장기 스토리지 정책을 변경하려고 함 | 유효하지 않은 작업, 현재 워크스페이스는 무료 플랜입니다 | 원래 값을 유지하거나 공식 업그레이드 절차를 통해 처리합니다. |
| 406 | ft.InvalidDuration | 표준 또는 장기 보존 기간 형식 또는 선택 가능한 값이 유효하지 않음 | 유효하지 않은 duration | 해당 버전의 선택 가능한 값을 사용하고, 형식은 숫자+d입니다. |
| 406 | ft.InvalidDurationRange | 표준 보존 기간이 범위를 벗어났거나 장기 보존 기간이 표준 값보다 크지 않음 | 유효한 데이터 보존 기간 범위를 초과함 | 실제 버전 범위에 따라 조정합니다. |
| 400 | ft.InvalidActionForbiddenChange | 로그 장기 스토리지 엔진 또는 버전이 지원하지 않음 | 구체적인 분기에 따라 장기 스토리지 미지원 사유를 반환 | 허용된 버전의 scopedb 로그 워크스페이스에서만 활성화합니다. |
| 406 | ft.CurrentVersionUnsupportRp | 버전이 보존 기간 편집을 지원하지 않음 | 현재 버전은 rp:{}를 지원하지 않습니다 |
관리자에게 워크스페이스 버전을 확인하도록 요청합니다. |
| 500 | ft.InternalServerError | 데이터베이스, 캐시, 리소스 서비스 또는 처리되지 않은 매개변수 변환 예외, 또는 인덱스 템플릿 업데이트의 다운스트림 응답에 성공 표시가 없음 | 내부 오류 | traceId를 저장하고 관리자에게 문의합니다. 먼저 구성과 다운스트림 실제 상태를 조회하며, 실패 응답을 곧바로 저장되지 않은 것으로 간주하지 말고 무턱대고 반복 생성하거나 교체하지 마십시오. |