콘텐츠로 이동

인시던트 AI 자동 분석 설정 조회



GET /api/v1/incidents/config/ai_analysis/get

개요

현재 워크스페이스의 인시던트 AI 자동 분석 스위치를 조회합니다.

호출 전 및 사용 단계

Key 권한은 routine.defaultAccess 또는 incidents.incidentsManage 중 하나를 충족해야 합니다. 현재 Key가 속한 워크스페이스에만 적용되며 workspaceUUID 또는 플랫폼의 일괄 워크스페이스 목록은 허용되지 않습니다. 이 스위치는 인시던트 AI 자동 분석만 제어하며, 인시던트 집계 스위치, AI 전체 활성화 또는 분석 1회 즉시 실행이 아닙니다. 실제 작업에서는 워크스페이스 AI 기능/서비스 가용성도 추가로 확인합니다. 활성화한다고 해서 모든 인시던트에 대해 응답이 생성되는 것은 아니며, 이 설정 요청으로 모든 과거 인시던트가 즉시 재분석되는 것도 아닙니다. 비활성화하면 새 작업/아직 시작되지 않은 분석에서 스위치를 다시 확인하며, 저장 성공만으로 실행 중인 AI 요청이 종료되었거나 과거 응답이 삭제되었음을 입증할 수는 없습니다.

enableAIAnalysis 불리언 값만 조회하며, 집계 스위치, 모델 설정 또는 자격 증명은 반환하지 않습니다. 활성 설정이 없으면 false를 반환하며, 조회 요청으로 레코드가 생성되지는 않습니다.

요청 헤더

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

요청 예시

curl --get 'https://openapi.guance.com/api/v1/incidents/config/ai_analysis/get' \
  -H 'DF-API-KEY: <DF-API-KEY>'

응답

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

필드 유형 설명
content.enableAIAnalysis boolean 현재 워크스페이스의 인시던트 AI 자동 분석 설정입니다. 활성 설정 레코드가 없으면 false입니다.
content.declaration object 현재 워크스페이스의 공통 선언입니다.
{
  "code": 200,
  "content": {
    "enableAIAnalysis": false,
    "declaration": {}
  },
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-EXAMPLE"
}

오류 응답

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

HTTP 상태 errorCode 발생 조건 메시지 또는 응답 설명 처리 방법
500 ft.InternalServerError 데이터베이스 읽기 또는 기존 설정 형식 이상 내부 오류 traceId를 보존하고 백오프 재시도하세요. 계속 실패하면 관리자에게 설정 및 서비스 로그 점검을 요청하세요.

문서 평가

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