콘텐츠로 이동

일괄 삭제



POST /api/v1/slo/batch_delete

개요

현재 워크스페이스의 SLO를 일괄 삭제합니다.

호출 전 및 사용 단계

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

이것은 쓰기 부작용이 있는 POST 일괄 삭제 API입니다. 호출 전에 SLO 및 관련 항목을 백업하고, 상태 페이지 등에서 참조를 조정해야 하는지 확인하세요. SLO 자체, 해당 탐지/계산 구성 요소 및 SLI/알림 정책/태그 연결을 삭제합니다. 참조된 원본 SLI 모니터와 알림 정책은 삭제하지 않으며, 과거 시계열 데이터 정리를 보장하지도 않습니다. 먼저 원격 스케줄링을 삭제한 다음 로컬 삭제를 제출하며, 제출 후 정책 캐시를 비동기로 정리합니다. 각 단계는 서비스 간 트랜잭션이 아니므로 실패 시 스케줄링이 이미 중지되었거나 로컬 삭제가 이미 완료되었을 수 있습니다.

현재 워크스페이스에서 일치하는 항목이 없거나 SLO가 아닌 항목만 있으면 []를 반환하고, 실제 삭제가 발생하면 true를 반환합니다(항목별 결과 또는 삭제 수량이 아님). 일부 유효하지 않은 UUID는 무시되므로 목록을 다시 읽어 항목별로 확인해야 합니다. 확인된 SLO UUID만 제출하고 일반 모니터 그룹 등 다른 리소스를 섞지 마세요. 네트워크 실패 또는 500 발생 후에는 먼저 SLO 목록과 스케줄링 현재 상태를 확인하여 무작정 반복하지 마세요.

요청 헤더

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

Body 요청 매개변수

매개변수명 유형 필수 설명
sloUUIDs[*] string 현재 워크스페이스의 단일 SLO UUID 문자열입니다.
예: monitor_example
가져오기 또는 입력 방법: 배열과 동일한 출처입니다.
sloUUIDs array Y 필수 배열입니다. 실제 SLO UUID만 전달하며, 대상이 없으면 []를 반환합니다. 유효하지 않거나 다른 워크스페이스에 속하거나 이미 삭제된 대상은 로컬 삭제 대상으로 나열되지 않습니다. 이 API는 실패를 항목별로 반환하지 않습니다. 일반 모니터 그룹 UUID를 섞지 마세요. 배치에 유효한 SLO가 하나라도 있으면 원격 스케줄링 삭제는 제출된 모든 UUID를 순회합니다.
null 허용: False
예: ["monitor_example"]
가져오기 또는 입력 방법: 현재 워크스페이스 SLO 목록에서 각 content.data[].uuid를 가져오고, 먼저 이름과 종속성을 확인합니다.

요청 예시

curl --request POST 'https://openapi.guance.com/api/v1/slo/batch_delete' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  -H 'Content-Type: application/json' \
  --data-raw '{"sloUUIDs":["monitor_example"]}'

응답

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

필드 유형 설명
content boolean 또는 array<string> 실제 삭제가 발생하면 true이고, 삭제 가능한 SLO가 없으면 []이며 항목별 결과를 반환하지 않습니다.
{
  "code": 200,
  "content": true,
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-EXAMPLE"
}
{
  "code": 200,
  "content": [],
  "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 파일 형식 오류 sloUUIDs 배열 객체를 제출하세요.
400 ft.OuterFuncFailed 원격 스케줄링 서비스가 실패를 반환함 외부 함수 호출 실패(일부 분기는 다운스트림 message 사용) message와 traceId를 확인하고, 관리자에게 스케줄링 가용성 및 구성 현재 상태를 확인한 후 재시도하세요.
400 ft.SameSetTraggerExists 원격 스케줄링 서비스가 동일한 트리거 구성이 이미 존재한다고 보고함 동일한 구성의 트리거가 이미 존재함 먼저 해당 SLO와 원격 스케줄링을 확인하고, 잔여/중복 구성을 처리한 후 제출하세요.
500 ft.InternalServerError 데이터베이스/캐시, 작업 큐, 잘못된 배열 멤버 또는 처리되지 않은 다운스트림 예외; 실패 시 이미 원격 변경이 있었을 수 있음 내부 오류 먼저 대상 SLO 구성과 스케줄링 현재 상태를 확인하세요. 삭제 실패 시 삭제된 상태도 별도로 확인해야 하며, 무작정 반복 생성하거나 일괄 덮어쓰지 마세요.

문서 평가

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