콘텐츠로 이동

삭제



GET /api/v1/slo/{slo_uuid}/delete

개요

지정한 SLO 및 해당 탐지 컴포넌트를 삭제합니다.

호출 전 확인 및 사용 단계

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

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

삭제된 이름 배열을 반환하며 일반적으로 한 항목입니다. 대상이 없거나/이미 삭제되었거나/다른 워크스페이스인 경우 NotFoundSLO를 반환하며, 재시도한 404를 최초 삭제 실패로 간주해서는 안 됩니다. 네트워크 실패 또는 500 발생 후에는 먼저 SLO 목록과 스케줄 현재 상태를 확인하여 무분별한 반복을 피합니다.

라우트 파라미터

파라미터 이름 타입 필수 설명
slo_uuid string Y 대상 SLO UUID이며 SLI 모니터 UUID 또는 metricQueryInfo.sloId가 아닙니다.
예시: monitor_example
가져오기 또는 입력 방법: SLO 목록 가져오기에서 content.data[].uuid를 읽습니다.

요청 헤더

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

요청 예시

curl --get 'https://openapi.guance.com/api/v1/slo/monitor_example/delete' \
  -H 'DF-API-KEY: <DF-API-KEY>'

응답

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

필드 타입 설명
content array<string> 실제 삭제된 SLO의 이름 배열입니다.
content[] string 삭제된 SLO 이름이며, 단일 삭제 시 일반적으로 한 항목입니다.
{
  "code": 200,
  "content": [
    "支付服务可用性"
  ],
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-EXAMPLE"
}

오류 응답

인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참조하세요.

HTTP 상태 errorCode 트리거 조건 메시지 또는 응답 설명 처리 방법
404 ft.NotFoundSLO 대상이 현재 워크스페이스에 없거나, 이미 삭제되었거나, SLO가 아닌 경우, 수정의 경우 필요한 탐지/계산 컴포넌트가 없는 경우도 포함 지정한 SLO를 찾을 수 없습니다 현재 워크스페이스의 SLO 목록에서 uuid를 가져오고, 대상이 여전히 존재하는지 확인하며, 컴포넌트 누락 시 관리자에게 복구를 요청합니다.
400 ft.OuterFuncFailed 원격 스케줄 서비스가 실패를 반환 외부 함수 호출 실패(일부 분기는 다운스트림 message 사용) message와 traceId를 확인하고, 관리자가 스케줄 가용성 및 구성 현재 상태를 점검한 후 재시도합니다.
400 ft.SameSetTraggerExists 원격 스케줄 서비스가 동일한 트리거 구성이 이미 존재한다고 보고 동일한 구성의 트리거가 이미 존재합니다 먼저 해당 SLO와 원격 스케줄을 확인하고, 잔여/중복 구성을 처리한 후 제출합니다.
500 ft.InternalServerError 데이터베이스/캐시, 작업 큐, 잘못된 배열 멤버 또는 처리되지 않은 다운스트림 예외이며, 실패 시에도 원격 변경이 이미 적용되었을 수 있음 내부 오류 먼저 대상 SLO 구성과 스케줄 현재 상태를 확인하고, 삭제 실패 시에는 삭제된 상태를 별도로 확인하며, 무분별하게 반복 생성하거나 일괄 덮어쓰지 않습니다.

문서 평가

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