콘텐츠로 이동

수정



POST /api/v1/slo/{slo_uuid}/modify

개요

기존 SLO의 변경 가능한 설정 및 연결 관계를 수정합니다.

호출 전 및 사용 단계

현재 API Key에는 monitor.sloCfgManage 권한이 필요합니다. 메트릭 유형 저장에는 대상 메트릭 namespace 조회 권한도 필요하며, SLO 관리 권한만으로는 이 사전 검사를 통과할 수 없습니다. Key가 속한 워크스페이스에서만 작업할 수 있습니다. 경로의 SLO UUID는 SLO 목록 가져오기의 content.data[].uuid(일반적으로 monitor_ 접두사)에서 가져오며, 연결된 모니터의 Rule UUID 또는 metricQueryInfo.sloId가 아닙니다.

name/goal/minGoal/sliType은 변경할 수 없으며, 생략하거나 원래 값을 그대로 전달해야 합니다. checkRange, interval, 설명, 상태 및 연결은 변경할 수 있습니다. sliUUIDs/alertPolicyUUIDs/tags가 포함되면 전체를 교체하므로, 새로 추가하려는 항목 하나만 전달해서는 안 됩니다. 기존 연결은 먼저 상세 정보를 읽어 백업해야 합니다. 일반 {} 요청도 기존 설정을 검증하고 실행 설정 및 업데이트 시간을 갱신하므로 아무 작업도 하지 않는 것과 같지 않습니다. 기존의 유효하지 않은 주기는 7/30일을 명시적으로 선택해야 합니다.

메트릭 유형의 metricQueries는 total/good을 동시에 제출해야 합니다. 조회 언어 또는 실행 텍스트, checkRange를 수정하거나 다시 활성화하면 통계 적용 하한이 앞당겨지며, 기존 결과를 새 정의와 직접 혼합 계산할 수 없습니다. editor만 변경한 경우에는 앞당겨지지 않습니다. 모니터 유형에서 차원을 변경할 때는 원본 이벤트/메트릭 차원이 완전한지 동시에 확인해야 합니다. 메트릭 유형은 good/total로 가용성을 계산하며, 비즈니스 백분율을 카운트로 직접 혼용해서는 안 됩니다. DQL은 각각 비교 가능한 단일 값으로 집계되어야 하며, 실제 데이터 조회와 권한은 먼저 검증해야 합니다. PromQL은 sum(...) 등의 집계를 사용할 수 있으며, 이 인터페이스는 promqlType을 일괄 즉시 조회로 처리합니다. 모니터 유형은 SLI 모니터를 참조하여 감점을 계산하고 SLO 결과를 생성합니다. groupBy를 구성하면 project/env/service 차원별로 각각 계산합니다. 알림 정책이 구성되지 않은 경우 해당 정책의 알림 연결이 없으며, 저장에 성공하더라도 알림 전송이 보장되지는 않습니다.

생성, 수정 및 활성화/비활성화는 로컬 트랜잭션 마지막에 커밋되며, 실패하면 원격 스케줄링과 캐시 복구를 시도합니다. 원격 보상도 실패할 수 있으므로 HTTP 실패만으로 모든 시스템에 변경이 없다고 판단해서는 안 됩니다. 네트워크 타임아웃/500 발생 후에는 먼저 SLO 상세 가져오기로 설정과 상태를 확인하고, 필요한 경우 관리자에게 스케줄링 확인을 요청한 후 다시 시도합니다. 저장 성공이 이미 탐지 결과가 생성되었음을 의미하지는 않으며, 탐지 빈도를 기다린 후 실제 데이터를 확인해야 합니다. 이 진입점은 전체 태그/정책/사용자 요약을 반환하지 않으므로 상세 정보를 다시 읽어 검수합니다.

metricResultValidAfter/metricResultStoppedAt/metricQueryInfo 등 서버 전용 필드를 제출하지 마십시오. 공개되지 않은 Body 필드는 라우트 선언에서 공통 406 매개변수 오류로 먼저 거부됩니다.

라우트 매개변수

매개변수 이름 유형 필수 설명
slo_uuid string Y 대상 SLO UUID이며 SLI 모니터 UUID 또는 metricQueryInfo.sloId가 아닙니다.
null 허용: False
예시: monitor_example
가져오기 또는 입력 방법: SLO 목록 가져오기에서 content.data[].uuid를 읽습니다.

요청 헤더

매개변수 이름 유형 필수 설명
DF-API-KEY string Y 워크스페이스의 OpenAPI 인증 자격 증명입니다.
예시: <DF-API-KEY>
가져오기 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다.

Body 요청 매개변수

매개변수 이름 유형 필수 설명
metricQueries.total object 총량 조회 객체이며 dql이 반드시 있어야 하고 editor만 제공할 수는 없습니다.
예시: {"dql": "M::http_requests:(SUM(`total`))"}
가져오기 또는 입력 방법: 대상 메저먼트와 해당 비즈니스 필드에서 구성합니다.
metricQueries.total.dql string 필수 비어 있지 않은 조회 문자열이며 최대 65536자입니다. queryType=dql인 경우 현재 워크스페이스 M 메트릭의 단일 출력 SELECT 또는 유효한 eval 표현식만 지원하며, SHOW/기타 실행 함수, 교차 워크스페이스 메트릭 또는 DQL 자체 윈도는 지원하지 않습니다. 호출자는 먼저 비교 가능한 단일 값으로 집계하고 결과를 검증하여 GROUP BY로 인한 다중 시계열 생성을 피해야 합니다. queryType=promql인 경우 이 필드의 이름은 여전히 dql이며 유효한 PromQL을 입력합니다.
예시: M::http_requests:(SUM(`total`))
가져오기 또는 입력 방법: 해당 메트릭 조회의 언어와 비즈니스 필드로 결정합니다.
metricQueries.total.queryType string 선택 사항인 dql/promql이며 기본값은 dql입니다. dql 문자열의 파싱 및 실행 언어를 결정합니다.
예시: dql
가져오기 또는 입력 방법: 해당 메트릭 조회의 언어와 비즈니스 필드로 결정합니다.
metricQueries.total.promqlType string queryType=promql인 경우에만 나타날 수 있습니다. instantQuery/rangeQuery를 입력할 수 있지만 실제 저장 및 실행은 일괄 instantQuery로 처리되며, rangeQuery를 전달했다고 해서 범위 결과를 요구할 수는 없습니다. DQL 분기에서 이 키가 나타나면 거부됩니다.
예시: instantQuery
가져오기 또는 입력 방법: 해당 메트릭 조회의 언어와 비즈니스 필드로 결정합니다.
metricQueries.total.editor object 선택 사항인 에코 객체이며 기본값은 {}입니다. 편집기 상태를 저장하며 실행 조회 비교에는 참여하지 않고, 수정 시 조회 객체가 전체 교체됩니다.
예시: {}
가져오기 또는 입력 방법: 해당 메트릭 조회의 언어와 비즈니스 필드로 결정합니다.
metricQueries.good object 성공량 조회 객체이며 dql이 반드시 있어야 하고 editor만 제공할 수는 없습니다.
예시: {"dql": "M::http_requests:(SUM(`good`))"}
가져오기 또는 입력 방법: 대상 메저먼트와 해당 비즈니스 필드에서 구성합니다.
metricQueries.good.dql string 필수 비어 있지 않은 조회 문자열이며 최대 65536자입니다. queryType=dql인 경우 현재 워크스페이스 M 메트릭의 단일 출력 SELECT 또는 유효한 eval 표현식만 지원하며, SHOW/기타 실행 함수, 교차 워크스페이스 메트릭 또는 DQL 자체 윈도는 지원하지 않습니다. 호출자는 먼저 비교 가능한 단일 값으로 집계하고 결과를 검증하여 GROUP BY로 인한 다중 시계열 생성을 피해야 합니다. queryType=promql인 경우 이 필드의 이름은 여전히 dql이며 유효한 PromQL을 입력합니다.
예시: M::http_requests:(SUM(`good`))
가져오기 또는 입력 방법: 해당 메트릭 조회의 언어와 비즈니스 필드로 결정합니다.
metricQueries.good.queryType string 선택 사항인 dql/promql이며 기본값은 dql입니다. dql 문자열의 파싱 및 실행 언어를 결정합니다.
예시: dql
가져오기 또는 입력 방법: 해당 메트릭 조회의 언어와 비즈니스 필드로 결정합니다.
metricQueries.good.promqlType string queryType=promql인 경우에만 나타날 수 있습니다. instantQuery/rangeQuery를 입력할 수 있지만 실제 저장 및 실행은 일괄 instantQuery로 처리되며, rangeQuery를 전달했다고 해서 범위 결과를 요구할 수는 없습니다. DQL 분기에서 이 키가 나타나면 거부됩니다.
예시: instantQuery
가져오기 또는 입력 방법: 해당 메트릭 조회의 언어와 비즈니스 필드로 결정합니다.
metricQueries.good.editor object 선택 사항인 에코 객체이며 기본값은 {}입니다. 편집기 상태를 저장하며 실행 조회 비교에는 참여하지 않고, 수정 시 조회 객체가 전체 교체됩니다.
예시: {}
가져오기 또는 입력 방법: 해당 메트릭 조회의 언어와 비즈니스 필드로 결정합니다.
sliUUIDs[*] string 단일 문자열 항목이며 배열에는 객체/배열/null이 포함되어서는 안 됩니다.
예시: rul_example
가져오기 또는 입력 방법: 모니터 목록에서 content.data[].uuid를 가져오며, search로 이름을 검색할 수 있습니다. 동일 워크스페이스에 있고 삭제되지 않았으며 SLI로 사용할 수 있는 모니터인지 확인해야 합니다.
alertPolicyUUIDs[*] string 단일 문자열 항목이며 배열에는 객체/배열/null이 포함되어서는 안 됩니다.
예시: altpl_example
가져오기 또는 입력 방법: 알림 정책 목록에서 현재 워크스페이스의 유효한 정책 uuid를 가져옵니다.
tags[*] string 단일 문자열 항목이며 배열에는 객체/배열/null이 포함되어서는 안 됩니다.
예시: production
가져오기 또는 입력 방법: 태그 목록에서 scope에 monitor 또는 all이 포함된 태그 이름을 선택합니다. 새 이름을 전달할 수도 있습니다.
groupBy[*] string 단일 문자열 항목이며 배열에는 객체/배열/null이 포함되어서는 안 됩니다. project/env/service만 가능합니다.
예시: service
가져오기 또는 입력 방법: 수집된 project/env/service 차원을 선택하며, 원본 모니터 이벤트/서비스 데이터에 해당 필드가 있는지 보장해야 합니다.
alertPolicyUUIDs array 선택 사항인 배열입니다. 생성 시 생략하면 연결하지 않고, 수정 시 생략하면 유지하며, []는 모든 연결을 해제합니다. 전달 시 전체를 교체하고 중복을 제거하며, 알 수 없거나 삭제되었거나 다른 워크스페이스의 정책은 거부됩니다. 이 인터페이스로 알림 대상 또는 alertOpt를 직접 구성하지 않습니다.
null 허용: False
예시: ["altpl_example"]
가져오기 또는 입력 방법: 알림 정책 목록에서 현재 워크스페이스의 유효한 정책 uuid를 가져옵니다.
checkRange integer 집계 창의 초 수이며 604800/2592000만 가능합니다. 생성 시 생략하면 604800, 수정 시 생략하면 유지됩니다. 기존 90일 등 이전 설정은 지원되는 값으로 명시적으로 변경해야 저장할 수 있습니다.
null 허용: False
선택 가능한 값: [604800, 2592000]
예시: 604800
가져오기 또는 입력 방법: SLO 집계 요구 사항에 따라 7일 또는 30일을 선택합니다.
describe string 선택 사항인 문자열이며 최대 3000자입니다. 생성 시 생략하면 빈 문자열, 수정 시 생략하면 유지되며, 빈 문자열은 내용을 비웁니다. null은 허용되지 않습니다.
빈 문자열 허용: True
null 허용: False
최대 길이: 3000
예시: 支付服务生产环境SLO
가져오기 또는 입력 방법: 호출자가 용도/유지 관리 설명을 입력합니다.
goal float 생성 시 필수 숫자이며 0<goal<100입니다. 수정 시에는 생략하거나 원래 값만 전달할 수 있습니다. 예: 99.9는 99.9%를 의미하며 0.999가 아닙니다.
null 허용: False
예시: 99.9
가져오기 또는 입력 방법: 비즈니스 SLA에 따라 예상 목표를 설정하며 단위는 백분율입니다.
groupBy array 모니터 유형에서만 지원합니다. 배열 내에는 project/env/service만 허용되며 중복될 수 없고 순서는 유지됩니다. 생성 시 기본값은 [], 수정 시 생략하면 유지되며 []는 그룹화를 취소합니다. 메트릭 유형은 생략하거나 []입니다.
null 허용: False
예시: ["service"]
가져오기 또는 입력 방법: 수집된 project/env/service 차원을 선택하며, 원본 모니터 이벤트/서비스 데이터에 해당 필드가 있는지 보장해야 합니다.
ignoreBadGroupEvents boolean 모니터 유형에서만 전달할 수 있으며 기본값은 true입니다. groupBy가 비어 있지 않을 때만 저장되고 계산에 참여합니다. 수정 시 생략하면 유지되며, 그룹을 새로 추가하고 원래 값이 없으면 true입니다. groupBy를 취소하면 이 설정이 제거됩니다. 메트릭 유형은 false를 전달해도 거부됩니다.
null 허용: False
예시: true
가져오기 또는 입력 방법: groupBy가 있을 때 비정상 그룹 이벤트를 무시할지 여부에 따라 선택합니다.
interval string 생성 시 필수이며 5m 또는 10m이고, 수정 시 생략하면 유지됩니다. checkRange 집계 창과는 같은 개념이 아닙니다.
null 허용: False
선택 가능한 값: ['5m', '10m']
예시: 5m
가져오기 또는 입력 방법: 필요에 따라 탐지 빈도를 선택합니다.
metricQueries object 메트릭 유형에서만 사용합니다. 생성 시 필수이고, 수정 시 생략하면 유지되며, 포함되면 total/good 전체 그룹이 교체되고 부분 patch 또는 null은 허용되지 않습니다. 객체는 정확히 total과 good을 포함해야 합니다. 각 항목은 dql/queryType/editor 및 PromQL의 promqlType을 지원하며 다른 실행 옵션은 허용되지 않습니다. 두 항목은 동일한 비즈니스 범위/시간 단위의 총량과 성공량을 측정해야 비교 가능하며, 인터페이스 저장은 고객의 비즈니스 정확성을 대신 검증하지 않습니다.
null 허용: False
예시: {"total": {"dql": "M::http_requests:(SUM(`total`))"}, "good": {"dql": "M::http_requests:(SUM(`good`))"}}
가져오기 또는 입력 방법: 메트릭 데이터에서 총량과 성공량 필드를 결정하고, 먼저 데이터 조회로 각 조회 값과 수집 범위를 검증합니다.
minGoal float 생성 시 필수 숫자이며 0<minGoal<goal<100입니다. 수정 시에는 생략하거나 원래 값만 전달할 수 있습니다. minGoal 미만은 critical, minGoal 이상이지만 goal 미만은 warning입니다.
null 허용: False
예시: 99.5
가져오기 또는 입력 방법: 최소 허용 가용성에 따라 설정하며 단위는 백분율입니다.
name string 생성 시 필수 문자열이며 최대 256자이고, 동일 워크스페이스의 활성 SLO는 이름이 중복될 수 없습니다. 호출자는 비어 있지 않은 이름을 사용해야 합니다. 수정 시 생략할 수 있으며, 제출 시 원래 이름과 정확히 일치해야 합니다.
null 허용: False
예시: 支付服务可用性
가져오기 또는 입력 방법: 호출자가 SLO에 이름을 지정하며, 수정 전에 먼저 상세 정보를 읽습니다.
sliType string 생성 시 기본값은 monitor이며 monitor/metric을 선택할 수 있습니다. 생성 후에는 전환할 수 없고, 수정 시 생략하면 유지되며 값을 전달하는 경우 원래 값만 허용됩니다.
null 허용: False
선택 가능한 값: ['monitor', 'metric']
예시: monitor
가져오기 또는 입력 방법: 기존 모니터 계산 또는 메트릭 조회 계산을 선택합니다.
sliUUIDs array 모니터 유형 생성 시 반드시 비어 있지 않아야 합니다. 수정 시 생략하면 참조를 유지하고, []는 참조를 비웁니다(SLO에 유효한 SLI가 없어질 수 있으므로 먼저 확인하십시오). 전체를 교체하고 중복을 제거하며 순서는 보장되지 않습니다. 메트릭 유형은 생략하거나 []이며 비어 있지 않을 수 없습니다. 동일 워크스페이스의 활성 type=trigger 또는 기존 빈 type 규칙만 SLI로 사용합니다. 현재 저장은 유효하지 않거나 다른 워크스페이스의 UUID를 개별적으로 거부하지 않으므로, 성공이 각 항목의 계산 가능성을 보장하지 않습니다. null은 허용되지 않습니다.
null 허용: False
예시: ["rul_example"]
가져오기 또는 입력 방법: 모니터 목록에서 content.data[].uuid를 가져오며, search로 이름을 검색할 수 있습니다. 동일 워크스페이스에 있고 삭제되지 않았으며 SLI로 사용할 수 있는 모니터인지 확인해야 합니다.
status integer 선택 사항이며 0 활성화/2 비활성화입니다. 생성 시 기본값은 0, 수정 시 생략하면 유지됩니다. null은 허용되지 않습니다.
null 허용: False
선택 가능한 값: [0, 2]
예시: 0
가져오기 또는 입력 방법: 즉시 탐지를 시작할지 여부에 따라 선택합니다.
tags array 이름 배열이며 각각 최대 128자이고 대소문자를 구분합니다. 새 이름은 monitor scope로 생성됩니다. 생성 시 생략하면 태그가 없고, 수정 시 생략하면 유지되며 []는 비웁니다. 전체를 교체하고 중복을 제거합니다. 동일 이름의 기존 태그가 monitor를 지원하지 않으면 400이며 null은 허용되지 않습니다.
null 허용: False
예시: ["production"]
가져오기 또는 입력 방법: 태그 목록에서 scope에 monitor 또는 all이 포함된 태그 이름을 선택합니다. 새 이름을 전달할 수도 있습니다.

요청 예시

curl --request POST 'https://openapi.guance.com/api/v1/slo/monitor_example/modify' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  -H 'Content-Type: application/json' \
  --data-raw '{"describe":"更新生产SLO维护说明","interval":"10m"}'

응답

HTTP 200, application/json입니다. 아래 예시는 직접 읽을 수 있는 주요 필드를 보여 줍니다.

필드 유형 설명
content.id integer 또는 null 데이터베이스 행 ID입니다. 생성 응답은 커밋 전에 생성되므로 null일 수 있으며, 비즈니스 식별자로는 uuid를 사용합니다.
content.uuid string SLO UUID이며 이후 상세, 수정, 활성화/비활성화, 삭제에 사용합니다.
content.workspaceUUID string 대상 워크스페이스 UUID입니다.
content.name string SLO 이름입니다.
content.type string 고정 값 slo입니다.
content.score integer 리소스 정렬 가중치이며 SLO 가용성 백분율이 아닙니다.
content.status integer 0 활성화/2 비활성화입니다.
content.creator string 생성 Key 리소스 UUID 또는 기존 계정 식별자입니다.
content.updator string 최근 업데이트 주체이며 생성 시 비어 있을 수 있습니다.
content.createAt integer 생성 시간(Unix 초)입니다.
content.updateAt integer 최근 업데이트 시간(Unix 초)이며 업데이트되지 않은 경우 -1일 수 있습니다.
content.deleteAt integer 삭제 시간이며 정상 활성 레코드는 -1입니다.
content.config object 저장된 SLO 계산 설정이며 직접 알림 대상 설정 alertOpt는 포함하지 않습니다.
content.config.sliType string monitor 또는 metric이며, 기존 설정에 누락된 경우 monitor로 표시됩니다.
content.config.checkRange integer 집계 창의 초 수이며 604800 또는 2592000입니다.
content.config.goal number 예상 목표 백분율입니다.
content.config.minGoal number 최소 목표 백분율입니다.
content.config.interval string 5m 또는 10m입니다.
content.config.describe string 용도 설명입니다.
content.config.groupBy array<string> 모니터 유형 그룹화 차원 배열이며 메트릭 유형은 비어 있습니다.
content.config.groupBy[] string project/env/service 중 하나입니다.
content.config.ignoreBadGroupEvents boolean 그룹화 차원이 존재할 때만 반환되며, 비정상 그룹 이벤트 무시 여부입니다.
content.config.sli_infos array<object> 또는 object 이번에 SLI 요약을 로드할 때 존재합니다. 모니터 유형은 일반적으로 객체 배열이고, 메트릭 유형 생성 시 현재 {}입니다. 수정 시 sliUUIDs를 제출하지 않으면 생략될 수 있습니다. 이 필드를 전체 참조 UUID 목록으로 간주해서는 안 됩니다.
content.config.sli_infos[].id string 실제로 이 워크스페이스의 유효한 SLI 모니터에 매칭된 Rule UUID입니다.
content.config.sli_infos[].name string 또는 null SLI 모니터 이름입니다.
content.config.sli_infos[].status integer 연결된 모니터 상태이며 0 또는 2일 수 있습니다. 존재하지 않는 참조는 요약에 포함되지 않습니다.
content.config.metricResultValidAfter integer 또는 null 메트릭 유형 전용: 이번 통계 적용 하한(Unix 밀리초)입니다. 생성, 창/실행 조회 변경, 비활성화에서 활성화로 전환 시 재설정되며, editor만 변경하면 재설정되지 않습니다.
content.config.metricResultStoppedAt integer 또는 null 메트릭 유형 전용: 계산 중지 시간(Unix 밀리초)입니다. 실행 중에는 null이고 비활성화 시 기록됩니다.
content.metricQueryInfo object 메트릭 유형 전용: 조회 결과 위치 정보이며 원시 비즈니스 메트릭 값이 아닙니다.
content.metricQueryInfo.measurement string 고정 값 slo_metric입니다.
content.metricQueryInfo.sloId string 실제 탐지 Rule UUID이며 slo_metric.slo_id 조회에 사용합니다. content.uuid와 다릅니다.
content.metricQueryInfo.validAfter integer 또는 null config.metricResultValidAfter와 같습니다.
content.metricQueryInfo.stoppedAt integer 또는 null config.metricResultStoppedAt과 같습니다.
content.declaration object 현재 워크스페이스의 공통 선언입니다.
content.config.metricQueries.total.dql string 정규화된 실행 조회입니다.
content.config.metricQueries.total.queryType string dql 또는 promql입니다.
content.config.metricQueries.total.promqlType string PromQL인 경우에만 반환되며 고정 값 instantQuery입니다.
content.config.metricQueries.total.editor object 호출자 편집기 에코 정보입니다.
content.config.metricQueries.total.editor.自定义字段 JSON 호출자가 전달한 동적 편집 상태이며 서버 측 실행 옵션으로 해석되지 않습니다.
content.config.metricQueries.good.dql string 정규화된 실행 조회입니다.
content.config.metricQueries.good.queryType string dql 또는 promql입니다.
content.config.metricQueries.good.promqlType string PromQL인 경우에만 반환되며 고정 값 instantQuery입니다.
content.config.metricQueries.good.editor object 호출자 편집기 에코 정보입니다.
content.config.metricQueries.good.editor.自定义字段 JSON 호출자가 전달한 동적 편집 상태이며 서버 측 실행 옵션으로 해석되지 않습니다.
content.config.metricQueries object 메트릭 유형 전용이며 total과 good의 전체 정규화 설정입니다.
content.config.metricQueries.total object 총량 조회 설정입니다.
content.config.metricQueries.good object 성공량 조회 설정입니다.
{
  "code": 200,
  "content": {
    "id": 123,
    "uuid": "monitor_example",
    "workspaceUUID": "wksp_example",
    "name": "支付服务可用性",
    "type": "slo",
    "score": 0,
    "status": 0,
    "creator": "wsak_example",
    "updator": "wsak_example",
    "createAt": 1785427200,
    "updateAt": 1785427260,
    "deleteAt": -1,
    "config": {
      "goal": 99.9,
      "minGoal": 99.5,
      "interval": "5m",
      "checkRange": 604800,
      "sliType": "monitor",
      "describe": "支付服务生产环境SLO",
      "groupBy": []
    },
    "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 파일 형식 오류 객체를 제출합니다.
404 ft.NotFoundSLO 대상이 현재 워크스페이스에 없거나, 삭제되었거나, SLO가 아님; 수정의 경우 필요한 탐지/계산 구성 요소 누락도 포함 지정된 SLO를 찾을 수 없음 현재 워크스페이스 SLO 목록에서 uuid를 가져오고, 대상이 여전히 존재하는지 확인하며, 누락된 구성 요소는 관리자가 복구하도록 합니다.
400 ft.ParamsValidateError 메트릭 조회/주기/차원 등 공개된 필드의 비즈니스 조합이 잘못됨 매개변수 검증 실패: {} 두 유형의 매개변수 제약에 따라 수정하고, 원래 이름, 목표, 유형을 유지하며, 서버 측 필드를 제출하지 마십시오.
400 ft.SloImmutableField name/goal/minGoal/sliType이 원래 설정과 다름 SLO 생성 후 필드 수정이 허용되지 않음: name 원래 값을 유지하고, 정의를 변경하려면 별도 SLO를 생성한 후 종속 항목을 마이그레이션합니다.
406 ft.SloMinGoalGreaterThanGoal minGoal이 goal보다 크거나 같음 minGoal은 goal보다 작아야 합니다. 현재 minGoal: 99.9 goal: 99.9 0<minGoal<goal<100을 보장합니다.
400 ft.InvalidAlertPolicyUUID alertPolicyUUIDs에 현재 워크스페이스의 유효한 정책이 아닌 항목이 포함됨 유효하지 않은 알림 정책 UUID 현재 워크스페이스의 알림 정책 목록에서 다시 가져옵니다.
400 ft.TagScopeMismatch 동일 이름의 기존 태그 scope에 monitor 또는 all이 포함되지 않음 production: ['scene'] -> monitor 모니터링에 사용할 수 있는 태그를 선택하고, 다른 전용 범위의 동일 이름 태그를 직접 재사용하지 마십시오.
406 ft.ExceedMaxCharacterLimit 태그 이름이 128자를 초과함 {}이(가) 최대 문자 길이 제한을 초과함 태그 이름을 줄이되 비즈니스 식별 가능성을 유지합니다.
400 ft.FiledCreateTrigger 생성 스케줄링 응답에 작업 ID가 누락됨 트리거 설정 생성 실패, 다시 시도하십시오 먼저 SLO와 잔여 작업을 확인한 후 스케줄링을 복구하거나 다시 시도합니다.
400 ft.OuterFuncFailed 원격 스케줄링 서비스가 실패를 반환함 외부 함수 호출 실패(일부 분기에서는 다운스트림 message 사용) message와 traceId를 확인하고, 관리자가 스케줄링 가용성 및 현재 설정 상태를 확인한 후 다시 시도하도록 합니다.
400 ft.SameSetTraggerExists 원격 스케줄링 서비스가 동일한 트리거 설정이 이미 존재한다고 보고함 동일한 설정의 트리거가 이미 존재함 먼저 해당 SLO와 원격 스케줄링을 확인하고, 잔여/중복 설정을 처리한 후 제출합니다.
500 ft.InternalServerError 데이터베이스/캐시, 작업 큐, 잘못된 배열 멤버 또는 처리되지 않은 다운스트림 예외; 실패했더라도 이미 원격 변경이 발생했을 수 있음 내부 오류 먼저 대상 SLO 설정과 현재 스케줄링 상태를 확인합니다. 삭제 실패의 경우 삭제된 상태도 별도로 확인하며, 무작정 반복 생성하거나 일괄 덮어쓰지 마십시오.
403 ft.ForbiddenQuery 메트릭 유형 조회가 namespace 권한 검사를 통과했지만 현재 Key에 메트릭 조회 권한이 없음 {} 권한이 없습니다 Key 역할에 대상 메트릭 조회 권한을 보완하고, 동일 Key로 조회를 먼저 검증한 후 저장합니다.

문서 평가

이 페이지가 도움이 되었나요?