가져오기¶
GET /api/v1/incidents/{incident_uuid}/get
개요¶
인시던트 상세, 연결 요약 및 수명 주기 통계를 가져옵니다.
호출 전 및 사용 단계¶
Key는 routine.defaultAccess 또는 incidents.incidentsQuery 중 하나에 해당해야 합니다. 현재 API Key가 속한 워크스페이스만 조작합니다. 이 모듈의 인시던트 UUID는 인시던트 목록의 content.data[].uuid에서 가져오며, 일반적으로 incident_ 접두사를 가집니다. 공개 엔드포인트는 workspaceUUID/workspaceUUIDs를 허용하지 않으므로 프런트엔드/내부 인터페이스의 크로스 워크스페이스 매개변수를 그대로 사용해서는 안 됩니다.
현재 워크스페이스의 삭제되지 않은 인시던트만 읽으며, 전체 출처 resourceContent, 첨부 파일, 담당자, 일치하는 온콜 설정, 최근 작업, 이번 라운드의 에스컬레이션 기록 및 metrics를 반환합니다. 원본 첨부 파일 내용을 반환하거나 알림 전송 완료를 보장하지는 않습니다. 상세의 scheduleInfo는 일치하는 설정이며, 이를 근거로 특정 구성원이 현재 온콜 중이라고 판단할 수 없습니다. 태그와 디멘션이 모두 설정된 경우 어느 하나라도 일치하면 포함하며, 상세의 순수 태그 일치는 모든 태그를 충족해야 하므로 목록의 순수 태그 호환(어느 하나라도 일치)과 다릅니다.
비즈니스 incidentsStatus와 데이터베이스 status, 누적 지속 초 cumulativeTime과 metrics.currentCycle.durationSeconds는 의미가 다릅니다. metrics는 작업 이력을 기반으로 재구성되며, 과거 이력이 부족하면 null을 반환할 수 있으므로 null을 0으로 간주하지 않습니다. 응답은 별도의 tagInfo 목록을 제공하지 않으며, 태그 연결은 쓰기 응답 또는 태그 관리에서 확인해야 합니다.
경로 매개변수¶
| 매개변수 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| incident_uuid | string | Y | 현재 워크스페이스의 인시던트 UUID이며, 알림 이벤트 ID, SLO UUID 또는 댓글 UUID가 아닙니다. null 허용: False 예시: incident_example가져오기 또는 입력 방법: 인시던트 목록에서 content.data[].uuid를 가져옵니다. |
요청 헤더¶
| 매개변수 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| DF-API-KEY | string | Y | 워크스페이스의 OpenAPI 인증 자격 증명입니다. 예시: <DF-API-KEY>가져오기 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다. |
요청 예시¶
curl --get 'https://openapi.guance.com/api/v1/incidents/incident_example/get' \
-H 'DF-API-KEY: <DF-API-KEY>'
응답¶
HTTP 200, application/json입니다. 아래 예시는 바로 읽을 수 있는 주요 필드를 보여줍니다.
| 필드 | 유형 | 설명 |
|---|---|---|
| content.id | integer 또는 null | 데이터베이스 행 ID입니다. 비즈니스 식별에는 uuid를 사용하며, 제출 전 스냅샷은 null일 수 있습니다. |
| content.uuid | string | 해당 리소스 UUID입니다. |
| content.status | integer | 데이터베이스 상태로 0은 활성, 3은 삭제입니다. 인시던트 비즈니스 상태 incidentsStatus와 다릅니다. |
| content.creator | string | 생성 주체이며, API Key는 일반적으로 wsak_리소스UUID입니다. |
| content.updator | string | 최근 업데이트 주체이며, 업데이트되지 않은 경우 비어 있을 수 있습니다. |
| content.createAt | integer | Unix초 생성 시간입니다. |
| content.updateAt | integer | Unix초 최근 업데이트 시간입니다. |
| content.deleteAt | integer | Unix초 삭제 시간이며, 삭제되지 않은 경우 -1입니다. |
| content.workspaceUUID | string | 인시던트가 속한 워크스페이스입니다. |
| content.name | string | 인시던트 이름입니다. |
| content.level | string | 인시던트 등급 UUID로 system_level_0 등 또는 issl_/isslm_ 레거시 식별자입니다. 등급 표시 이름과 같지 않습니다. |
| content.description | string 또는 null | 인시던트 설명입니다. |
| content.source | string | 인시던트 출처이며, 이 공개 API에서 수동 생성한 경우 현재 external이며 External API 인증을 사용했다는 의미는 아닙니다. |
| content.resourceCategory | string | 출처 리소스 클래스이며, 자동 인시던트는 출처에 따라 채워지고 수동 생성 공개 엔드포인트에서는 일반적으로 비어 있습니다. |
| content.resourceType | string | 출처 리소스 유형이며, 집계 인시던트는 incident_aggregation이고 수동 생성은 일반적으로 비어 있습니다. |
| content.resourceUUID | string | 출처 리소스 UUID이며, 수동 생성은 일반적으로 비어 있습니다. |
| content.resourceUrl | string | 저장된 출처 URL이며, 응답 필드의 첫 글자가 소문자 l인 resourceUrl로 요청의 resourceURL과 다릅니다. |
| content.resourceContent | object 또는 JSON | 출처 원본 콘텐츠이며, 유형은 모니터/이벤트/집계 출처에 따라 달라집니다. 목록에서는 이 필드가 제거됩니다. |
| content.eventRelations | array<object> |
현재 인시던트 수명 주기에 연결된 이벤트 스냅샷이며, 새 라운드로 다시 열면 비워질 수 있습니다. |
| content.eventRelations[] | object | 출처 이벤트 연결 설명이며, 이벤트 유형에 따라 동적 필드를 반환합니다. 이 API로 인시던트를 생성할 때 설정 가능한 객체가 아닙니다. |
| content.eventRelations[].사용자 정의 필드 | JSON | 이벤트 생산자가 저장한 연결 키-값이며, 실제 유형에 따라 읽으세요. |
| content.resourceIdentity | string | 출처 집계/하위 식별자이며, 수동 생성 시 비어 있을 수 있습니다. |
| content.assigner | array<string> |
담당자 식별자 목록으로 acnt_/group_/notify_를 포함할 수 있습니다. 모든 식별자가 여전히 유효하다고 보장하지 않습니다. |
| content.assigner[] | string | 하나의 저장된 담당자/그룹/알림 대상 식별자입니다. |
| content.incidentsStatus | string | 비즈니스 상태(open/working/resolved/closed)입니다. |
| content.statusTime | object | 현재 수명 주기에 기록된 상태 시간(Unix초)이며, 모든 상태가 존재하는 것은 아닙니다. |
| content.statusTime.open | integer | 이번 라운드가 열린 시간입니다. |
| content.statusTime.working | integer | 이번 라운드의 처리 시작 시간이며, 생략될 수 있습니다. |
| content.statusTime.resolved | integer | 이번 라운드의 복구 시간이며, 생략될 수 있습니다. |
| content.statusTime.closed | integer | 이번 라운드의 종료 시간이며, 생략될 수 있습니다. |
| content.statusChangeTime | integer | 현재 수명 주기 트리거 시간이며 다시 열 때 업데이트됩니다. 매 필드 수정 시간과 동일하지 않습니다. |
| content.cumulativeTime | integer | 누적 인시던트 지속 초입니다. 상세/목록에서는 현재 상태와 결합해 실시간 계산하며, 쓰기 응답에서는 저장된 값일 수 있습니다. |
| content.eventCount | integer | 연결 이벤트 수이며, 수동 생성은 일반적으로 0입니다. |
| content.eventUpdateAt | integer | 출처의 최근 이벤트 업데이트 시간(Unix초)이며, 수동 생성은 일반적으로 0입니다. |
| content.dimensionTag | object | 디멘션 이름에서 값으로의 JSON 매핑입니다. |
| content.dimensionTag.사용자 정의 키 | JSON | 호출자 또는 출처가 저장한 디멘션 값이며 문자열을 권장합니다. host/service 등에는 별도의 인덱스 필드가 있습니다. |
| content.extend | object 또는 JSON | 인시던트 확장 데이터이며, 자동 출처는 집계/이벤트 등 설정을 포함할 수 있습니다. 생성 공개 엔드포인트는 현재 전달된 extend를 저장하지 않으며, 수정 시에만 전체 교체할 수 있습니다. |
| content.extend.linkList | array<object> |
비즈니스 링크 배열이며, 저장 후 표시 용도로 사용됩니다. 이 API가 외부 URL에 접근하는 것은 아닙니다. |
| content.extend.linkList[].name | string | 링크 표시 이름입니다. |
| content.extend.linkList[].link | string | 링크 주소입니다. |
| content.extend.aggregationRuleUUID | string | 집계 출처 규칙 UUID이며, 존재하는 경우 filters.aggregationRuleUUID에 사용할 수 있습니다. |
| content.extend.사용자 정의 필드 | JSON | 기타 저장된 출처 확장 필드이며 고정 구조를 보장하지 않습니다. 전체 교체 전에 기존 객체 전체를 복사하세요. |
| content.dtHost | string 또는 null | host 인덱스 디멘션이며 생성 시 dimensionTag에서 비롯됩니다. 수정 공개 엔드포인트의 dimensionTag는 현재 적용되지 않습니다. |
| content.dtService | string 또는 null | service 인덱스 디멘션이며 생성 시 dimensionTag에서 비롯됩니다. 수정 공개 엔드포인트의 dimensionTag는 현재 적용되지 않습니다. |
| content.dtResource | string 또는 null | resource 인덱스 디멘션이며 생성 시 dimensionTag에서 비롯됩니다. 수정 공개 엔드포인트의 dimensionTag는 현재 적용되지 않습니다. |
| content.dtPodName | string 또는 null | pod_name 인덱스 디멘션이며 생성 시 dimensionTag에서 비롯됩니다. 수정 공개 엔드포인트의 dimensionTag는 현재 적용되지 않습니다. |
| content.dtAppName | string 또는 null | app_name 인덱스 디멘션이며 생성 시 dimensionTag에서 비롯됩니다. 수정 공개 엔드포인트의 dimensionTag는 현재 적용되지 않습니다. |
| content.dtAppId | string 또는 null | app_id 인덱스 디멘션이며 생성 시 dimensionTag에서 비롯됩니다. 수정 공개 엔드포인트의 dimensionTag는 현재 적용되지 않습니다. |
| content.dtEnv | string 또는 null | env 인덱스 디멘션이며 생성 시 dimensionTag에서 비롯됩니다. 수정 공개 엔드포인트의 dimensionTag는 현재 적용되지 않습니다. |
| content.dtUrl | string 또는 null | url 인덱스 디멘션이며 생성 시 dimensionTag에서 비롯됩니다. 수정 공개 엔드포인트의 dimensionTag는 현재 적용되지 않습니다. |
| content.eventRelations[].df_fault_id | string | 이벤트 수명 주기 ID로, 이벤트 df_fault_id 또는 호환 df_status_fault_id에서 생성됩니다. 인시던트 uuid가 아닙니다. |
| content.eventRelations[].status | string | 해당 연결 이벤트 스냅샷의 df_status 상태(예: critical/ok)이며 인시던트 incidentsStatus와 다릅니다. |
| content.eventRelations[].aggregationValues | object | 집계 규칙으로 연결된 경우에만 있을 수 있으며, 집계 키에서 해당 이벤트 디멘션 값으로의 매핑입니다. |
| content.eventRelations[].aggregationValues.집계 키 | JSON | 집계 규칙이 지정한 디멘션의 이벤트 내 값이며, 실제 저장 유형에 따라 읽습니다. |
| content.assignerInfo | array<object> |
실제로 성공적으로 파싱된 담당자 요약입니다. 계정은 전체 신원 필드를 포함하고, 그룹/알림 대상은 uuid/name만 포함하며, 알 수 없는 식별자는 무시될 수 있습니다. |
| content.assignerInfo[].uuid | string | 주체 UUID이며, 시스템 응답 주체는 비어 있거나 시스템 식별자일 수 있습니다. |
| content.assignerInfo[].status | integer | 주체 상태입니다. |
| content.assignerInfo[].wsAccountStatus | integer | 워크스페이스 구성원 상태이며, Key는 Key 상태를 사용합니다. 인시던트 상태가 아닙니다. |
| content.assignerInfo[].username | string | 로그인 이름/Key 이름/시스템 이름입니다. |
| content.assignerInfo[].name | string | 표시 이름이며, 시스템 AI 표시 이름은 사이트 설정을 사용합니다. |
| content.assignerInfo[].iconUrl | string | 아바타 URL이며, 시스템 요약에서는 생략될 수 있습니다. |
| content.assignerInfo[].email | string | 연락 이메일이며, Key 요약은 Key UUID일 수 있고 실제 발송 가능한 이메일이 아닙니다. |
| content.assignerInfo[].mobile | string | 연락 휴대전화 번호이며, 비어 있을 수 있습니다. |
| content.assignerInfo[].countryCode | string | 국가 코드이며, 시스템 요약에서는 생략될 수 있습니다. |
| content.assignerInfo[].acntWsNickname | string | 워크스페이스 닉네임이며, 시스템 요약에서는 생략될 수 있습니다. |
| content.workspaceInfo | object | 인시던트가 속한 워크스페이스 요약입니다. |
| content.workspaceInfo.uuid | string | 소속 워크스페이스 UUID입니다. |
| content.workspaceInfo.name | string | 워크스페이스 이름이며, 확인할 수 없으면 비어 있을 수 있습니다. |
| content.regionCode | string | 현재 사이트 코드입니다. |
| content.isExternalWorkspace | boolean | 다른 워크스페이스에서 왔는지 여부이며, 이 OpenAPI 공개 엔드포인트는 크로스 워크스페이스 대상을 받지 않으므로 일반적으로 false입니다. |
| content.aggregationRuleInfo | object 또는 null | 집계 인시던트에만 추가되며, 유효한 규칙 요약 또는 null입니다. |
| content.aggregationRuleInfo.uuid | string | 집계 규칙 UUID입니다. |
| content.aggregationRuleInfo.name | string | 집계 규칙 이름입니다. |
| content.aggregationRuleInfo.status | integer | 규칙 데이터베이스 상태입니다. |
| content.scheduleInfo | array<object> |
현재 일치한 온콜 설정의 원본 요약이며, 현재 온콜 중인 사람이 있거나 알림이 실제로 전달되었음을 의미하지 않습니다. 상세와 목록의 태그 일치 호환 규칙에는 차이가 있습니다. |
| content.scheduleInfo[].id | integer 또는 null | 데이터베이스 행 ID입니다. 비즈니스 식별에는 uuid를 사용하며, 제출 전 스냅샷은 null일 수 있습니다. |
| content.scheduleInfo[].uuid | string | 해당 리소스 UUID입니다. |
| content.scheduleInfo[].status | integer | 데이터베이스 상태로 0은 활성, 3은 삭제입니다. 인시던트 비즈니스 상태 incidentsStatus와 다릅니다. |
| content.scheduleInfo[].creator | string | 생성 주체이며, API Key는 일반적으로 wsak_리소스UUID입니다. |
| content.scheduleInfo[].updator | string | 최근 업데이트 주체이며, 업데이트되지 않은 경우 비어 있을 수 있습니다. |
| content.scheduleInfo[].createAt | integer | Unix초 생성 시간입니다. |
| content.scheduleInfo[].updateAt | integer | Unix초 최근 업데이트 시간입니다. |
| content.scheduleInfo[].deleteAt | integer | Unix초 삭제 시간이며, 삭제되지 않은 경우 -1입니다. |
| content.scheduleInfo[].workspaceUUID | string | 소속 워크스페이스입니다. |
| content.scheduleInfo[].name | string | 온콜 이름입니다. |
| content.scheduleInfo[].timezone | string | IANA 시간대입니다. |
| content.scheduleInfo[].start | string | 호환되는 일일 업무 시작 시각 HH:MM이며 일정 timezone에 따라 해석됩니다. 날짜나 Unix 시간이 아닙니다. |
| content.scheduleInfo[].end | string | 호환되는 일일 업무 종료 시각 HH:MM이며, 유효 날짜 경계는 extend.effectiveTime을 참고하세요. |
| content.scheduleInfo[].tagFilter | array<string> |
일치 태그 UUID 배열입니다. |
| content.scheduleInfo[].tagFilter[] | string | 태그 UUID입니다. |
| content.scheduleInfo[].dimensionFilter | string | 디멘션 일치 조회 표현식입니다. |
| content.scheduleInfo[].notifyTargets | array<string> |
알림 대상 식별자 목록입니다. |
| content.scheduleInfo[].notifyTargets[] | string | 계정/그룹/알림 대상 등 대상 식별자입니다. |
| content.scheduleInfo[].strategyConfig | array<object> |
에스컬레이션 정책 설정이며, 워크스페이스에 저장된 버전에 따라 읽습니다. |
| content.scheduleInfo[].strategyConfig[] | object | 하나의 설정 정책이며, 인시던트 조회 API는 실행 미리보기를 펼치지 않습니다. |
| content.scheduleInfo[].strategyConfig[].사용자 정의 필드 | JSON | 저장된 정책 레벨/대기/알림 설정이며, 전체 비즈니스 설정은 온콜 관리에서 확인하세요. |
| content.scheduleInfo[].extend | object | 스케줄/순환 등 확장 설정입니다. |
| content.scheduleInfo[].extend.사용자 정의 필드 | JSON | 저장된 온콜 확장 키-값이며, 이 API로 수정할 수 없습니다. |
| content.scheduleInfo[].isDefault | boolean | 기본 온콜 여부입니다. |
| content.scheduleInfo[].rotationUpdateAt | integer | 순환 변경 Unix초 시간이며, 과거 데이터는 -1일 수 있습니다. |
| content.scheduleInfo[].agentUUIDs | array<string> |
확장의 연결 Agent UUID 배열입니다. |
| content.scheduleInfo[].agentUUIDs[] | string | 하나의 Agent UUID입니다. |
| content.scheduleInfo[].strategyConfig[].uuid | string | 정책 UUID입니다. |
| content.scheduleInfo[].strategyConfig[].name | string | 정책 이름입니다. |
| content.scheduleInfo[].strategyConfig[].strategy | array<object> |
해당 정책의 에스컬레이션 레벨 설정 배열입니다. |
| content.scheduleInfo[].strategyConfig[].strategy[].level | integer | 레벨 순번이며 일반적으로 0부터 시작합니다. |
| content.scheduleInfo[].strategyConfig[].strategy[].levelUpTime | integer | 인시던트 상태 트리거 시간부터의 에스컬레이션 대기 초입니다. |
| content.scheduleInfo[].strategyConfig[].strategy[].incidentsLevel | array<string> |
적용 인시던트 등급 UUID 목록입니다. |
| content.scheduleInfo[].strategyConfig[].strategy[].incidentsLevel[] | string | 하나의 등급 UUID입니다. |
| content.scheduleInfo[].strategyConfig[].strategy[].incidentsStatus | array<string> |
적용 인시던트 상태 목록(예: open/working)입니다. |
| content.scheduleInfo[].strategyConfig[].strategy[].incidentsStatus[] | string | 하나의 인시던트 상태입니다. |
| content.scheduleInfo[].strategyConfig[].strategy[].ifRepeatNotify | boolean | 반복 알림 여부입니다. |
| content.scheduleInfo[].strategyConfig[].strategy[].repeatNotifyInterval | integer | 반복 알림 간격(초)입니다. |
| content.scheduleInfo[].strategyConfig[].strategy[].notifyConfig | array<object> |
해당 레벨의 알림 설정 배열입니다. |
| content.scheduleInfo[].strategyConfig[].strategy[].notifyConfig[].notifyObjectType | string | 알림 대상 분류(예: member/object/group)이며 저장된 버전에 따라 읽습니다. |
| content.scheduleInfo[].strategyConfig[].strategy[].notifyConfig[].notifyObject | array<string> |
알림 대상 식별자이며, watchkeeper는 런타임 현재 온콜 담당자를 의미하고 고정 계정 UUID가 아닙니다. |
| content.scheduleInfo[].strategyConfig[].strategy[].notifyConfig[].notifyObject[] | string | 하나의 대상 계정/그룹/알림 대상 식별자 또는 watchkeeper입니다. |
| content.scheduleInfo[].strategyConfig[].strategy[].notifyConfig[].notifyMethod | array<string> |
알림 방식이며, 일반적으로 mobile 전화/message SMS/email 이메일입니다. 대상 채널은 대상 설정에 따라 실행됩니다. |
| content.scheduleInfo[].strategyConfig[].strategy[].notifyConfig[].notifyMethod[] | string | 하나의 알림 방식입니다. |
| content.scheduleInfo[].extend.enableRotateNotification | boolean | 알림 대상 순환 여부입니다. |
| content.scheduleInfo[].extend.rotationCycle | string | day/week/month/workDay/weekend/customDay/customWeek 중 하나이며, 과거 데이터는 생략될 수 있습니다. |
| content.scheduleInfo[].extend.rotationInterval | integer | customDay 순환 간격 일수 1~31, customWeek 주수 1~4입니다. |
| content.scheduleInfo[].extend.effectiveTime | object | 일정 유효 기간 설정입니다. |
| content.scheduleInfo[].extend.effectiveTime.start | integer | 저장된 유효 시작 Unix초이며, 값이 없으면 시작 제한을 두지 않습니다. |
| content.scheduleInfo[].extend.effectiveTime.end | integer | 저장된 유효 종료 Unix초이며, 값이 없으면 종료 제한을 두지 않습니다. |
| content.scheduleInfo[].extend.workTime | object | 업무 시간 설정이며, 값이 없으면 호환 start/end와 순환 주기에서 유도합니다. |
| content.scheduleInfo[].extend.workTime.mode | string | allDay(종일) 또는 specificTimes(지정 시간)입니다. |
| content.scheduleInfo[].extend.workTime.periods | array<object> |
지정 업무 시간대 배열입니다. |
| content.scheduleInfo[].extend.workTime.periods[].weekdays | array<integer> |
적용 요일 1(월요일)~7(일요일)입니다. |
| content.scheduleInfo[].extend.workTime.periods[].weekdays[] | integer | 1~7 중 하나입니다. |
| content.scheduleInfo[].extend.workTime.periods[].start | string | 현지 일자 시작 HH:MM입니다. |
| content.scheduleInfo[].extend.workTime.periods[].end | string | 현지 일자 종료 HH:MM입니다. |
| content.scheduleInfo[].extend.agentUUIDs | array<string> |
연결 Agent UUID이며, 엔터티에는 별도의 최상위 agentUUIDs 투영이 있습니다. |
| content.scheduleInfo[].extend.agentUUIDs[] | string | 하나의 Agent UUID입니다. |
| content.operateRecord | object | 최근 작업 기록 요약이며, 기록이 없어도 operatorInfo={}가 있을 수 있습니다. |
| content.operateRecord.uuid | string | 작업 기록 UUID입니다. |
| content.operateRecord.createAt | integer | 기록 Unix초 시간입니다. |
| content.operateRecord.incidentsUUID | string | 소속 인시던트 UUID입니다. |
| content.operateRecord.workspaceUUID | string | 소속 워크스페이스입니다. |
| content.operateRecord.content | string | 로컬화된 작업 설명이며, 기계적 파싱 가능성을 보장하지 않으므로 operateType/extend로 판단하세요. |
| content.operateRecord.extend | object | operateType에 따라 달라지는 작업 확장입니다. |
| content.operateRecord.extend.before | JSON | 상태/등급/담당자 변경 전 값이며, 작업 유형에 따라 문자열 또는 배열일 수 있습니다. |
| content.operateRecord.extend.after | JSON | 상태/등급/담당자 변경 후 값입니다. |
| content.operateRecord.extend.source | string | 작업 출처이며, 기본 studio 엔드포인트에는 이 키가 없을 수 있습니다. |
| content.operateRecord.extend.사용자 정의 필드 | JSON | 에스컬레이션 정책 등 작업이 포함하는 확장 메타데이터이며, 원래 값을 유지하고 요청 매개변수로 사용하지 않습니다. |
| content.operateRecord.operator | string | 실제 작업자 계정/Key/시스템 식별자입니다. |
| content.operateRecord.operateType | string | create/status_update/level_update/assigner_update/notify_level_update 등이며, 클라이언트는 확장을 호환해야 합니다. |
| content.operateRecord.operatorInfo | object | 주체 요약이며, 해당 정보가 없으면 {}입니다. |
| content.operateRecord.operatorInfo.uuid | string | 주체 UUID이며, 시스템 응답 주체는 비어 있거나 시스템 식별자일 수 있습니다. |
| content.operateRecord.operatorInfo.status | integer | 주체 상태입니다. |
| content.operateRecord.operatorInfo.wsAccountStatus | integer | 워크스페이스 구성원 상태이며, Key는 Key 상태를 사용합니다. 인시던트 상태가 아닙니다. |
| content.operateRecord.operatorInfo.username | string | 로그인 이름/Key 이름/시스템 이름입니다. |
| content.operateRecord.operatorInfo.name | string | 표시 이름이며, 시스템 AI 표시 이름은 사이트 설정을 사용합니다. |
| content.operateRecord.operatorInfo.iconUrl | string | 아바타 URL이며, 시스템 요약에서는 생략될 수 있습니다. |
| content.operateRecord.operatorInfo.email | string | 연락 이메일이며, Key 요약은 Key UUID일 수 있고 실제 발송 가능한 이메일이 아닙니다. |
| content.operateRecord.operatorInfo.mobile | string | 연락 휴대전화 번호이며, 비어 있을 수 있습니다. |
| content.operateRecord.operatorInfo.countryCode | string | 국가 코드이며, 시스템 요약에서는 생략될 수 있습니다. |
| content.operateRecord.operatorInfo.acntWsNickname | string | 워크스페이스 닉네임이며, 시스템 요약에서는 생략될 수 있습니다. |
| content.operateRecord.extend.before_info | object 또는 array | 변경 전 등급 요약 또는 담당자 요약 배열이며, 상태 변경은 일반적으로 {}이고 등급 before 자체는 표시 이름입니다. |
| content.operateRecord.extend.after_info | object 또는 array | 변경 후 등급/담당자 요약이며, 실제 operateType과 유형에 따라 읽습니다. |
| content.operateRecord.extend.schedule_name | string | 알림 에스컬레이션 작업의 온콜/정책 이름 요약입니다. |
| content.operateRecord.extend.incidents_status | string | 알림 에스컬레이션 시 인시던트 비즈니스 상태입니다. |
| content.operateRecord.extend.strategy_info | object | 알림 에스컬레이션 정책 스냅샷입니다. |
| content.operateRecord.extend.strategy_info.name | string | 속한 일정 이름입니다. |
| content.operateRecord.extend.strategy_info.strategy | object | 이번에 선택된 레벨 및 알림 설정 스냅샷입니다. |
| content.operateRecord.extend.notify_info | object | 알림 대상 식별자에서 당시 대상 정보로의 매핑이며, 계정/그룹/알림 대상의 형태가 다릅니다. |
| content.operateRecord.extend.notify_info.대상 식별자 | object 또는 string | 해당 대상의 당시 이름/이메일/구성원 등 정보이며 실제 유형에 따라 읽습니다. 성공적인 전달을 의미하지 않습니다. |
| content.operateRecord.extend.is_muted | boolean | 인시던트 알림 음소거에 해당하면 true이며, 에스컬레이션 기록이 있어도 실제로 전송되지 않았을 수 있습니다. |
| content.operateRecord.extend.mute_rule_info | object | 일치한 음소거 규칙 요약입니다. |
| content.operateRecord.extend.mute_rule_info.uuid | string | 음소거 규칙 UUID입니다. |
| content.operateRecord.extend.mute_rule_info.name | string | 음소거 규칙 이름입니다. |
| content.operateRecord.extend.muted_notify_info | object | 원래 전송할 예정이었으나 음소거된 대상 정보 매핑입니다. |
| content.operateRecord.extend.muted_notify_info.대상 식별자 | object 또는 string | 음소거된 대상 정보입니다. |
| content.operateRecord.extend.strategy_info.strategy.level | integer | 레벨 순번이며 일반적으로 0부터 시작합니다. |
| content.operateRecord.extend.strategy_info.strategy.levelUpTime | integer | 인시던트 상태 트리거 시간부터의 에스컬레이션 대기 초입니다. |
| content.operateRecord.extend.strategy_info.strategy.incidentsLevel | array<string> |
적용 인시던트 등급 UUID 목록입니다. |
| content.operateRecord.extend.strategy_info.strategy.incidentsLevel[] | string | 하나의 등급 UUID입니다. |
| content.operateRecord.extend.strategy_info.strategy.incidentsStatus | array<string> |
적용 인시던트 상태 목록(예: open/working)입니다. |
| content.operateRecord.extend.strategy_info.strategy.incidentsStatus[] | string | 하나의 인시던트 상태입니다. |
| content.operateRecord.extend.strategy_info.strategy.ifRepeatNotify | boolean | 반복 알림 여부입니다. |
| content.operateRecord.extend.strategy_info.strategy.repeatNotifyInterval | integer | 반복 알림 간격(초)입니다. |
| content.operateRecord.extend.strategy_info.strategy.notifyConfig | array<object> |
해당 레벨의 알림 설정 배열입니다. |
| content.operateRecord.extend.strategy_info.strategy.notifyConfig[].notifyObjectType | string | 알림 대상 분류(예: member/object/group)이며 저장된 버전에 따라 읽습니다. |
| content.operateRecord.extend.strategy_info.strategy.notifyConfig[].notifyObject | array<string> |
알림 대상 식별자이며, watchkeeper는 런타임 현재 온콜 담당자를 의미하고 고정 계정 UUID가 아닙니다. |
| content.operateRecord.extend.strategy_info.strategy.notifyConfig[].notifyObject[] | string | 하나의 대상 계정/그룹/알림 대상 식별자 또는 watchkeeper입니다. |
| content.operateRecord.extend.strategy_info.strategy.notifyConfig[].notifyMethod | array<string> |
알림 방식이며, 일반적으로 mobile 전화/message SMS/email 이메일입니다. 대상 채널은 대상 설정에 따라 실행됩니다. |
| content.operateRecord.extend.strategy_info.strategy.notifyConfig[].notifyMethod[] | string | 하나의 알림 방식입니다. |
| content.attachments | array<object> |
연결된 첨부 파일 요약이며, 연결되지 않은 경우 []입니다. |
| content.attachments[].uuid | string | 첨부 파일 UUID이며, 이 모듈의 downloadAttachment API를 통해 다운로드합니다. |
| content.attachments[].fileName | string | 원본 파일 이름입니다. |
| content.attachments[].fileSuffix | string | 파일 확장자이며 점은 포함하지 않습니다. 파일 내용/직접 링크는 반환하지 않습니다. |
| content.upgradeInfo | array<object> |
이번 open 이후의 notify_level_update 작업 기록이며, 대기 중인 에스컬레이션 계획과 같지 않습니다. |
| content.upgradeInfo[].id | integer 또는 null | 데이터베이스 행 ID입니다. 비즈니스 식별에는 uuid를 사용하며, 제출 전 스냅샷은 null일 수 있습니다. |
| content.upgradeInfo[].uuid | string | 해당 리소스 UUID입니다. |
| content.upgradeInfo[].status | integer | 데이터베이스 상태로 0은 활성, 3은 삭제입니다. 인시던트 비즈니스 상태 incidentsStatus와 다릅니다. |
| content.upgradeInfo[].creator | string | 생성 주체이며, API Key는 일반적으로 wsak_리소스UUID입니다. |
| content.upgradeInfo[].updator | string | 최근 업데이트 주체이며, 업데이트되지 않은 경우 비어 있을 수 있습니다. |
| content.upgradeInfo[].createAt | integer | Unix초 생성 시간입니다. |
| content.upgradeInfo[].updateAt | integer | Unix초 최근 업데이트 시간입니다. |
| content.upgradeInfo[].deleteAt | integer | Unix초 삭제 시간이며, 삭제되지 않은 경우 -1입니다. |
| content.upgradeInfo[].incidentsUUID | string | 소속 인시던트 UUID입니다. |
| content.upgradeInfo[].workspaceUUID | string | 소속 워크스페이스입니다. |
| content.upgradeInfo[].content | string | 로컬화된 작업 설명이며, 기계적 파싱 가능성을 보장하지 않으므로 operateType/extend로 판단하세요. |
| content.upgradeInfo[].extend | object | operateType에 따라 달라지는 작업 확장입니다. |
| content.upgradeInfo[].extend.before | JSON | 상태/등급/담당자 변경 전 값이며, 작업 유형에 따라 문자열 또는 배열일 수 있습니다. |
| content.upgradeInfo[].extend.after | JSON | 상태/등급/담당자 변경 후 값입니다. |
| content.upgradeInfo[].extend.source | string | 작업 출처이며, 기본 studio 엔드포인트에는 이 키가 없을 수 있습니다. |
| content.upgradeInfo[].extend.사용자 정의 필드 | JSON | 에스컬레이션 정책 등 작업이 포함하는 확장 메타데이터이며, 원래 값을 유지하고 요청 매개변수로 사용하지 않습니다. |
| content.upgradeInfo[].operator | string | 실제 작업자 계정/Key/시스템 식별자입니다. |
| content.upgradeInfo[].operateType | string | create/status_update/level_update/assigner_update/notify_level_update 등이며, 클라이언트는 확장을 호환해야 합니다. |
| content.upgradeInfo[].extend.before_info | object 또는 array | 변경 전 등급 요약 또는 담당자 요약 배열이며, 상태 변경은 일반적으로 {}이고 등급 before 자체는 표시 이름입니다. |
| content.upgradeInfo[].extend.after_info | object 또는 array | 변경 후 등급/담당자 요약이며, 실제 operateType과 유형에 따라 읽습니다. |
| content.upgradeInfo[].extend.schedule_name | string | 알림 에스컬레이션 작업의 온콜/정책 이름 요약입니다. |
| content.upgradeInfo[].extend.incidents_status | string | 알림 에스컬레이션 시 인시던트 비즈니스 상태입니다. |
| content.upgradeInfo[].extend.strategy_info | object | 알림 에스컬레이션 정책 스냅샷입니다. |
| content.upgradeInfo[].extend.strategy_info.name | string | 속한 일정 이름입니다. |
| content.upgradeInfo[].extend.strategy_info.strategy | object | 이번에 선택된 레벨 및 알림 설정 스냅샷입니다. |
| content.upgradeInfo[].extend.notify_info | object | 알림 대상 식별자에서 당시 대상 정보로의 매핑이며, 계정/그룹/알림 대상의 형태가 다릅니다. |
| content.upgradeInfo[].extend.notify_info.대상 식별자 | object 또는 string | 해당 대상의 당시 이름/이메일/구성원 등 정보이며 실제 유형에 따라 읽습니다. 성공적인 전달을 의미하지 않습니다. |
| content.upgradeInfo[].extend.is_muted | boolean | 인시던트 알림 음소거에 해당하면 true이며, 에스컬레이션 기록이 있어도 실제로 전송되지 않았을 수 있습니다. |
| content.upgradeInfo[].extend.mute_rule_info | object | 일치한 음소거 규칙 요약입니다. |
| content.upgradeInfo[].extend.mute_rule_info.uuid | string | 음소거 규칙 UUID입니다. |
| content.upgradeInfo[].extend.mute_rule_info.name | string | 음소거 규칙 이름입니다. |
| content.upgradeInfo[].extend.muted_notify_info | object | 원래 전송할 예정이었으나 음소거된 대상 정보 매핑입니다. |
| content.upgradeInfo[].extend.muted_notify_info.대상 식별자 | object 또는 string | 음소거된 대상 정보입니다. |
| content.upgradeInfo[].extend.strategy_info.strategy.level | integer | 레벨 순번이며 일반적으로 0부터 시작합니다. |
| content.upgradeInfo[].extend.strategy_info.strategy.levelUpTime | integer | 인시던트 상태 트리거 시간부터의 에스컬레이션 대기 초입니다. |
| content.upgradeInfo[].extend.strategy_info.strategy.incidentsLevel | array<string> |
적용 인시던트 등급 UUID 목록입니다. |
| content.upgradeInfo[].extend.strategy_info.strategy.incidentsLevel[] | string | 하나의 등급 UUID입니다. |
| content.upgradeInfo[].extend.strategy_info.strategy.incidentsStatus | array<string> |
적용 인시던트 상태 목록(예: open/working)입니다. |
| content.upgradeInfo[].extend.strategy_info.strategy.incidentsStatus[] | string | 하나의 인시던트 상태입니다. |
| content.upgradeInfo[].extend.strategy_info.strategy.ifRepeatNotify | boolean | 반복 알림 여부입니다. |
| content.upgradeInfo[].extend.strategy_info.strategy.repeatNotifyInterval | integer | 반복 알림 간격(초)입니다. |
| content.upgradeInfo[].extend.strategy_info.strategy.notifyConfig | array<object> |
해당 레벨의 알림 설정 배열입니다. |
| content.upgradeInfo[].extend.strategy_info.strategy.notifyConfig[].notifyObjectType | string | 알림 대상 분류(예: member/object/group)이며 저장된 버전에 따라 읽습니다. |
| content.upgradeInfo[].extend.strategy_info.strategy.notifyConfig[].notifyObject | array<string> |
알림 대상 식별자이며, watchkeeper는 런타임 현재 온콜 담당자를 의미하고 고정 계정 UUID가 아닙니다. |
| content.upgradeInfo[].extend.strategy_info.strategy.notifyConfig[].notifyObject[] | string | 하나의 대상 계정/그룹/알림 대상 식별자 또는 watchkeeper입니다. |
| content.upgradeInfo[].extend.strategy_info.strategy.notifyConfig[].notifyMethod | array<string> |
알림 방식이며, 일반적으로 mobile 전화/message SMS/email 이메일입니다. 대상 채널은 대상 설정에 따라 실행됩니다. |
| content.upgradeInfo[].extend.strategy_info.strategy.notifyConfig[].notifyMethod[] | string | 하나의 알림 방식입니다. |
| content.metrics | object | 수명 주기 작업 기록을 기반으로 재구성한 현재 라운드 및 전체 통계이며 초 단위입니다. |
| content.metrics.currentCycle | object | 현재 라운드입니다. |
| content.metrics.currentCycle.triggerAt | integer 또는 null | 이번 라운드 트리거 Unix초입니다. |
| content.metrics.currentCycle.durationSeconds | integer 또는 null | 이번 라운드 지속 초이며, 복구되지 않은 경우 조회 시점까지 계산합니다. |
| content.metrics.currentCycle.firstAcknowledgeAt | integer 또는 null | 이번 라운드 최초 유효 담당자 확인 Unix초입니다. |
| content.metrics.currentCycle.mttaSeconds | integer 또는 null | 이번 라운드 최초 확인 소요 초이며, 아직 확인이 없으면 null입니다. |
| content.metrics.currentCycle.resolvedAt | integer 또는 null | 이번 라운드 복구 Unix초이며, 복구되지 않았으면 null입니다. |
| content.metrics.currentCycle.mttrSeconds | integer 또는 null | 이번 라운드 복구 소요 초이며, 복구되지 않았으면 null입니다. |
| content.metrics.total | object | 라운드 간 통계입니다. |
| content.metrics.total.firstTriggerAt | integer 또는 null | 가장 이른 수명 주기 트리거 Unix초입니다. |
| content.metrics.total.latestTriggerAt | integer 또는 null | 최근 라운드 트리거 Unix초입니다. |
| content.metrics.total.reopenCount | integer | 다시 연 횟수입니다. |
| content.metrics.total.avgMTTASeconds | integer 또는 null | 유효한 확인 데이터가 있는 라운드의 평균 확인 초이며 정수로 절삭됩니다. 샘플이 없으면 null입니다. |
| content.metrics.total.avgMTTRSeconds | integer 또는 null | 복구된 라운드의 평균 복구 초이며 정수로 절삭됩니다. 샘플이 없으면 null입니다. |
| content.declaration | object | 현재 워크스페이스 공통 선언입니다. |
{
"code": 200,
"content": {
"id": 123,
"uuid": "incident_example",
"status": 0,
"creator": "wsak_example",
"updator": "",
"createAt": 1785427200,
"updateAt": -1,
"deleteAt": -1,
"workspaceUUID": "wksp_example",
"name": "支付服务异常",
"level": "system_level_1",
"description": "部分请求失败",
"source": "external",
"resourceCategory": "",
"resourceType": "",
"resourceUUID": "",
"resourceUrl": "https://example.com/runbook",
"resourceContent": {},
"eventRelations": [],
"resourceIdentity": "",
"assigner": [],
"incidentsStatus": "open",
"statusTime": {
"open": 1785427200
},
"statusChangeTime": 1785427200,
"cumulativeTime": 0,
"eventCount": 0,
"eventUpdateAt": 0,
"dimensionTag": {
"service": "payment"
},
"extend": {},
"dtHost": "",
"dtResource": "",
"dtPodName": "",
"dtAppName": "",
"dtAppId": "",
"dtEnv": "",
"dtUrl": "",
"dtService": "payment",
"assignerInfo": [],
"attachments": [],
"upgradeInfo": [],
"operateRecord": {
"operatorInfo": {}
},
"scheduleInfo": [],
"workspaceInfo": {
"uuid": "wksp_example",
"name": "生产空间"
},
"regionCode": "site_example",
"isExternalWorkspace": false,
"metrics": {
"currentCycle": {
"triggerAt": 1785427200,
"durationSeconds": 60,
"firstAcknowledgeAt": null,
"mttaSeconds": null,
"resolvedAt": null,
"mttrSeconds": null
},
"total": {
"firstTriggerAt": 1785427200,
"latestTriggerAt": 1785427200,
"reopenCount": 0,
"avgMTTASeconds": null,
"avgMTTRSeconds": null
}
},
"declaration": {}
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
오류 응답¶
인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참고하세요.
| HTTP 상태 | errorCode | 트리거 조건 | 메시지 또는 응답 설명 | 처리 방법 |
|---|---|---|---|---|
| 400 | ft.IncidentsNotFound | 대상 인시던트가 현재 워크스페이스에 없거나 삭제됨 | 지정된 인시던트를 찾을 수 없음 | 인시던트 목록에서 content.data[].uuid를 다시 가져오세요. |
| 500 | ft.InternalServerError | 데이터베이스 읽기, 과거 객체/설정 형식 또는 연결 요약 구성 등에서 처리되지 않은 예외 | 내부 오류 | 쿼리 매개변수를 확인하고 traceId를 보존하세요. 백오프 후 재시도할 수 있으며, 계속 실패하면 관리자에게 관련 이력 기록과 서비스 로그 확인을 요청하세요. |