비활성화¶
POST /api/v1/monitor/mute/{mute_uuid}/disable
개요¶
현재 워크스페이스의 음소거 규칙을 비활성화합니다.
호출 전 및 사용 단계¶
먼저 현재 공간 목록에서 대상을 확인한 후 비활성화하고, 완료 후 규칙과 실제 적용 상태를 다시 조회합니다.
비활성화하면 일치하는 규칙의 status를 2로 설정하고 비동기적으로 실행 캐시를 동기화하며 후속 구성 알림을 취소합니다. 시간과 기존 구성은 유지되며, 이미 실행이 시작된 메시지는 철회가 보장되지 않습니다. 일치하는 레코드를 찾지 못한 경우에도 현재 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/disable' \
-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를 제공하십시오. |