자동 검색 구성 삭제¶
POST /api/v1/issue_auto_discovery/{cfg_uuid}/delete
개요¶
Issue 자동 검색 규칙을 소프트 삭제합니다.
호출 전 및 사용 단계¶
이 모듈은 기존 인시던트 Issue 자동 검색 구성이며, 인시던트 센터 Incidents의 온콜 일정/자동 집계가 아니고 오류 센터 ErrorTrack 규칙도 아닙니다. 현재 공개 쓰기 dqlNamespace는 keyevent만 지원하며, rum/tracing의 기존 예시는 현재 선언과 일치하지 않습니다. 백그라운드에서 issueUpgrade=true로 마이그레이션된 워크스페이스는 이 v2 자동 검색 작업을 건너뛰므로, 구성 성공만으로 해당 워크스페이스에서 새 Issue가 생성된다고 약속할 수 없습니다.
권한은 trace.issueDiscovery/rum.issueDiscovery/anomaly.issueDiscovery 중 하나를 충족해야 합니다. 대상은 현재 워크스페이스의 삭제되지 않은 규칙이어야 하며, 알 수 없는 삭제/중복 삭제는 멱등 성공이 아니고 404 ft.LogIndexCfgNoExists가 발생합니다. 소프트 삭제 시 status3이 되며, 이미 생성된 Issue/기존 답변/채널은 삭제하지 않습니다. 이 공개 API로는 복구할 수 없고, 재생성하면 새 iatdc_가 생성됩니다. 기존 Issue의 후속 이벤트 연결/알림은 더 이상 이 규칙에서 조건을 보완할 수 없습니다. 동일 차원의 중복 제거 식별자에는 규칙 UUID가 포함되지 않으며, 재생성해도 완전히 새로운 독립 Issue가 생성된다고 보장하지 않습니다. 삭제는 먼저 제출된 후 등급/채널/담당자 감사 자료를 정리하므로, 이후 발생하는 404/400/500에서도 이미 삭제되었을 수 있습니다. 먼저 다시 읽어 확인하십시오.
true를 반환하며, 매칭 수/실행 작업/알림 상태는 반환하지 않습니다. 구성 저장은 즉시 쿼리를 실행하거나 생성 작업을 반환하지 않습니다. 정기 실행은 Asia/Shanghai 달력 기준으로 주기를 맞추어 직전 every초 윈도우를 처리하며, 작업 큐/쿼리 소요 시간으로 인해 지연될 수 있습니다. keyevent는 monitor 이벤트에서 집계되며, dimensions에 따라 최대 1000개의 그룹을 생성하고, 넓은 범위의 완전한 커버리지를 보장하지 않습니다. 그룹 차원을 정렬한 JSON으로 중복 식별자를 생성하며, 규칙 UUID는 이 식별자에 포함되지 않습니다. 여러 규칙이 동일 워크스페이스에서 동일한 차원 값을 사용하면 동일한 기존 Issue에 연결될 수 있고, 차원/필터를 수정하면 그룹 결과가 달라질 수 있습니다. 이를 규칙별로 독립적이며 절대 교차하지 않는 Issue 집합으로 간주하지 마십시오. Open/Pending은 답변이 추가되고, Resolved는 다시 열려 회귀할 수 있으며, Closed는 재사용되지 않습니다. 기존 Working 분기는 실제 구현에 따라 처리되며, 작업 중 완전한 격리를 보장하지 않습니다. 알림은 비동기이며, HTTP 200은 데이터 쿼리 성공/새 Issue 생성/알림 전달을 의미하지 않습니다.
라우트 매개변수¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| cfg_uuid | string | Y | 현재 Key 워크스페이스의 삭제되지 않은 규칙이며, 상태 0(활성화) 또는 2(비활성화) 모두 읽기/수정할 수 있습니다. 누락 시 이전 버전 호환을 위해 ft.LogIndexCfgNoExists를 사용하지만, 메시지에서는 로그 인덱스라고 표시되므로 실제로는 이 규칙 UUID를 확인해야 합니다. 예: iatdc_example가져오거나 입력하는 방법: Issue 자동 검색 규칙 목록에서 content.data[].uuid(iatdc_)를 가져오며, Issue UUID나 ErrorTrack 규칙 UUID를 사용하지 마십시오. |
요청 헤더¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| DF-API-KEY | string | Y | 워크스페이스의 OpenAPI 인증 자격 증명입니다. 예: <DF-API-KEY>가져오거나 입력하는 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다. |
매개변수 추가 설명¶
현재 공개 범위는 keyevent입니다. 구성 저장, 정기 실행, 알림 전달은 서로 다른 단계이며, 매개변수와 전체 응답/오류 경계는 아래에서 확인할 수 있습니다.
요청 예시¶
curl --request POST 'https://openapi.guance.com/api/v1/issue_auto_discovery/iatdc_example/delete' \
-H 'DF-API-KEY: <DF-API-KEY>'
응답¶
HTTP 200, application/json. 아래 예시는 바로 읽을 수 있는 주요 필드를 보여줍니다.
| 필드 | 유형 | 설명 |
|---|---|---|
| content | boolean | 성공 시 true이며, declaration 또는 작업/개별 항목 정보를 포함하지 않습니다. |
{
"code": 200,
"content": true,
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
오류 응답¶
인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참조하십시오.
| HTTP 상태 | errorCode | 발생 조건 | 메시지 또는 응답 설명 | 처리 방법 |
|---|---|---|---|---|
| 404 | ft.LogIndexCfgNoExists | 현재 워크스페이스에 삭제되지 않은 자동 검색 규칙이 없음/삭제됨/워크스페이스 간 | 지정한 로그 인덱스 구성이 존재하지 않습니다 | 현재 워크스페이스의 자동 검색 목록에서 iatdc_ UUID를 새로 고치십시오. 이는 이전에 재사용된 오류 문구이므로 로그 인덱스를 새로 생성하러 가지 마십시오. |
| 500 | ft.InternalServerError | 구성 소프트 삭제 또는 제출 후 등급/채널/담당자 감사 자료 구성 중 처리되지 않은 예외 발생 | 내부 오류 | 먼저 다시 읽어 규칙이 삭제되었는지 확인한 다음 기존 템플릿/채널/담당자를 점검하십시오. 500만으로 삭제 롤백을 판단하지 말고 traceId를 보관하십시오. |
| 404 | ft.NotFoundChannel | 삭제 제출 후 채널 자료를 읽었지만 워크스페이스에 활성 채널이 없음 | 지정한 채널을 찾을 수 없습니다 | 먼저 규칙이 삭제되었는지 조회하십시오. 관리자가 채널을 복구해야 하며, 결과가 불명확한 삭제를 반복하지 마십시오. |
| 400 | ft.UnsupportFreeIssueManager | 삭제 제출 후 기존 담당자를 정리하는 과정에서 무료/체험 워크스페이스에 외부 이메일이 남아 있음 | 체험 버전 워크스페이스, 인시던트 담당자를 외부 이메일로 지정하는 것은 지원되지 않음 | 먼저 삭제 상태를 다시 읽어 확인하고, 관리자는 기존 담당자/제품 버전을 점검하십시오. 이 오류는 삭제 롤백을 의미하지 않습니다. |