삭제¶
POST /api/v1/monitor/mute/{mute_uuid}/delete
개요¶
현재 워크스페이스의 음소거 규칙을 삭제합니다.
호출 전 및 사용 단계¶
먼저 현재 워크스페이스 목록에서 대상을 확인한 후 삭제하고, 완료된 후 규칙과 실제 적용 상태를 다시 조회합니다.
이 작업은 음소거 규칙을 소프트 삭제하고 후속 구성 알림과 실행 캐시를 비동기적으로 정리합니다. 과거 이벤트나 모니터링 데이터는 삭제하지 않습니다. 일치하는 레코드가 없어도 true를 반환하며, 이는 해당 UUID가 존재했음을 의미하지 않습니다.
삭제가 true를 반환하면 목록에서 더 이상 해당 규칙을 제공하지 않습니다. 실제 캐시 동기화에는 비동기 지연이 있어, 이미 전송되었거나 실행 중인 메시지의 회수는 보장되지 않습니다.
경로 파라미터¶
| 파라미터 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| mute_uuid | string | Y | 현재 워크스페이스 음소거 규칙의 경로 UUID입니다. 예시: mute_example가져오기 또는 입력 방법: 음소거 규칙 목록의 content.data[].uuid에서 가져옵니다. |
요청 헤더¶
| 파라미터 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| DF-API-KEY | string | Y | 워크스페이스의 OpenAPI 인증 자격 증명입니다. 예시: <DF-API-KEY>가져오기 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다. |
요청 예시¶
curl --request POST 'https://openapi.guance.com/api/v1/monitor/mute/mute_example/delete' \
-H 'DF-API-KEY: <DF-API-KEY>'
응답¶
HTTP 200, application/json입니다. 아래 예시는 직접 읽을 수 있는 주요 필드를 보여줍니다.
| 필드 | 유형 | 설명 |
|---|---|---|
| content | boolean | 성공 시 true입니다. 실제 매칭 및 비동기 상태 경계는 사용 설명을 참고하세요. |
{
"code": 200,
"content": true,
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
오류 응답¶
인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참고하세요.
| HTTP 상태 | errorCode | 트리거 조건 | 메시지 또는 응답 설명 | 처리 방법 |
|---|---|---|---|---|
| 406 | ft.ParameterValidationFailed | 요청 필드가 누락되었거나 필드 값이 선언된 검증 조건을 위반함 | 파라미터 구문 분석 실패 | 파라미터 위치, 필드 이름, 유형 및 값을 확인하세요. |
| 500 | ft.InternalServerError | 삭제 저장 또는 동기화 작업 제출 실패 | 내부 오류 | 먼저 목록을 다시 읽어 결과를 확인하고, 지속적으로 실패하면 traceId를 제공하세요. |