수정¶
POST /api/v1/incidents/schedule/{schedule_uuid}/modify
개요¶
인시던트 온콜 설정을 완전히 교체합니다.
호출 전 준비 및 사용 단계¶
현재 Key에는 incidents.incidentsSchedule 권한이 필요하며 현재 워크스페이스에서만 사용할 수 있습니다. name/start/end/notifyTargets는 필수이며, 알림 대상은 비워 둘 수 있지만 이를 기준으로 담당자가 자동 보충되지는 않습니다. tagFilter 입력은 태그 이름이며 응답에서는 UUID로 변환됩니다. dimensionFilter는 쿼리 문자열을 사용하며, 태그 또는 디멘션 중 하나만 일치해도 됩니다. 둘 다 비어 있으면 모든 인시던트에 적용됩니다.
이 작업은 전체 교체입니다. 필수 필드는 여전히 제공해야 하며, timezone을 생략하면 Asia/Shanghai로 재설정되고 tagFilter/dimensionFilter/scheduleStrategy/extend를 생략하면 각각 비워집니다. 상세 조회의 tagFilter는 UUID이므로, 다시 전송하기 전에 tagFilterInfos에서 이름으로 변환해야 합니다. 응답 배열을 그대로 복사해서는 안 됩니다. 공개 extend에서는 선언된 세 개의 키만 허용됩니다. 기존 workTime/custom 주기 등은 그대로 다시 전송할 수 없으며, 기존 근무 시간 의미가 손실될 수 있습니다. 기존 Agent 연결은 별도로 유지되지만 공개 인터페이스에서는 수정할 수 없습니다. 알림 순서/시간/시간대/로테이션 확장 등 의미가 변경되면 rotationUpdateAt이 재설정되고 이력이 기록됩니다. 이름이나 필터/정책만 변경했다고 해서 로테이션이 반드시 재설정되는 것은 아닙니다.
일내 start/end는 온콜 일정 timezone에 따라 해석되며 날짜를 넘지 않습니다. effectiveTime.start/end는 Unix 초 단위의 날짜 경계입니다. 로테이션은 notifyTargets 순서와 달력 주기를 따르며 고정된 초 길이가 아닙니다. 현재 새로 생성할 때 rotationUpdateAt 기본값은 -1이며 계산 체인에서는 이를 유효한 0이 아닌 앵커로 처리합니다. 따라서 로테이션을 바로 켜도 생성 당일 첫 번째 대상부터 시작한다고 보장할 수 없습니다. 공개적으로 rotationUpdateAt을 전달해 수정할 수 없습니다. 생성 후 상세/달력에서 실제 교대조를 확인하고, 이후 유효한 의미 변경이 있을 때만 코드에 따라 앵커가 재설정됩니다. customDay/customWeek/rotationInterval/workTime은 현재 과거 응답에만 나타날 수 있으며, 공개 요청에서는 사전에 406이 발생합니다.
scheduleStrategy는 하위 객체를 완전히 검증하지 않으므로, 연속된 level=배열 인덱스, 실제 레벨/대상, 양수 반복 간격을 사용해야 합니다. 생성 알림은 0레벨 notifyConfig에서 대상을 가져오며, [] 정책이 생성 시 모든 notifyTargets로 알림을 보내는 방식으로 자동 폴백되지는 않습니다. watchkeeper는 notifyObject에 명시적으로 넣어야 합니다. 인시던트 operate=update는 온콜 일정의 유효 시간 및 필터 조건을 충족한 후 설정된 notifyTargets의 모든 대상을 사용하며, watchkeeper 로테이션/대리 근무에 따라 현재 교대조로 축소되지 않습니다. 담당자가 있으면 먼저 담당자에게 알리고, 그다음 온콜 일정 대상에서 중복을 제외합니다. 담당자에게만 알리는 것은 아닙니다. 음소거, 채널 가용성 등은 여전히 실제 전송에 영향을 주며, 저장 성공이 전달을 보장하지는 않습니다.
온콜 일정/새 태그는 먼저 커밋된 후 인시던트 매칭 큐가 비동기로 업데이트됩니다. 전송 실패 시 500이 발생할 수 있지만 본문은 이미 저장되었을 수 있습니다. 수정 시 필터만 변경된 경우 해당 큐를 업데이트하며, HTTP 200을 모든 캐시가 즉시 갱신되었다는 의미로 해석해서는 안 됩니다. 실패 시 먼저 설정과 달력을 다시 읽어 중복 생성/중복 전환을 피하십시오. 변경 전에 전체 공개 설정을 백업해야 하며, 롤백은 다시 제출해야 하고 이미 발송된 알림의 자동 취소를 보장하지 않습니다.
라우트 매개변수¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| schedule_uuid | string | Y | 현재 워크스페이스에서 삭제되지 않은 온콜 UUID이며, 정책 UUID/대리 근무 UUID/인시던트 UUID로 대체할 수 없습니다. null 허용: False 예: incsch_example가져오기 또는 입력 방법: 온콜 목록의 일반 관리 모드 content.data[].uuid에서 incsch_ UUID를 가져옵니다. |
요청 헤더¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| DF-API-KEY | string | Y | 워크스페이스의 OpenAPI 인증 자격 증명입니다. 예: <DF-API-KEY>가져오기 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다. |
Body 요청 매개변수¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| tagFilter[*] | any | 단일 비어 있지 않은 태그 이름입니다. 기존 태그 참조로 tag_ UUID를 전달하면 새 이름으로 처리되므로 전달할 수 없습니다. 하위 항목은 강제 검증되지 않으므로 클라이언트는 문자열을 사용해야 합니다.예: production가져오기 또는 입력 방법: 태그 목록의 name 또는 새 이름을 사용합니다. |
|
| notifyTargets[*] | string | 단일 acnt_/group_/notify_ 문자열 또는 이메일입니다. 역할 ID/Key UUID는 사용할 수 없으며, 문자열이 아니면 명확한 매개변수 오류 대신 500이 발생할 수 있습니다.예: acnt_example가져오기 또는 입력 방법: 워크스페이스 멤버에서 acnt_, 팀 목록에서 group_, 알림 대상 목록에서 notify_를 가져오거나 허용된 유효 이메일을 입력합니다. |
|
| extend.effectiveTime.start | integer | 선택적 정수 Unix 초입니다. 생략하거나 0이면 시작 경계를 설정하지 않습니다. 매일 start의 일내 시각과 다릅니다.예: 1785369600가져오기 또는 입력 방법: 온콜 일정 timezone 기준으로 대상 날짜 시작점의 Unix 초를 계산합니다. |
|
| extend.effectiveTime.end | integer | 선택적 정수 Unix 초입니다. 생략하거나 0이면 종료 경계를 설정하지 않습니다. 매일 end와 다릅니다.예: 1785455999가져오기 또는 입력 방법: 온콜 일정 timezone 기준으로 마감 시간의 Unix 초를 계산합니다. |
|
| extend.effectiveTime.其他键 | any | 유효 기간 객체에는 키별 화이트리스트가 없습니다. 다른 값도 저장할 수 있지만 추가 실행 계약은 제공하지 않습니다. 예: value가져오기 또는 입력 방법: 일반적으로 이러한 키는 필요하지 않으며 start/end만 사용합니다. |
|
| scheduleStrategy[*] | json | 단일 정책 객체입니다. 정책 uuid는 알림 중복 제거 캐시에 사용되며 온콜 일정 UUID가 아닙니다.예: {"uuid": "strategy_payment", "name": "支付通知", "strategy": []}가져오기 또는 입력 방법: 호출자가 안정적이고 고유한 정책 식별자와 이름을 할당하여 정책 간 uuid 재사용을 피합니다. |
|
| scheduleStrategy[*].uuid | string | 인시던트/정책별 중복 제거 캐시에 사용됩니다. 빈 값이나 여러 정책에서 동일한 값을 재사용하지 마십시오. 예: strategy_payment가져오기 또는 입력 방법: 호출자가 워크스페이스 내에서 충돌하지 않고 안정적인 정책 UUID 문자열을 생성합니다. |
|
| scheduleStrategy[*].name | string | 정책 이름이며 알림 에스컬레이션 기록 표시에 사용됩니다. 예: 支付通知가져오기 또는 입력 방법: 호출자가 정책 표시 이름을 입력합니다. |
|
| scheduleStrategy[*].strategy | array | 레벨 객체 배열이며 level은 0부터 연속으로 배열 인덱스와 일치해야 합니다. 실행 체인이 level을 직접 인덱스로 사용할 수 있으므로 번호 건너뛰기/음수를 허용하지 않습니다.예: []가져오기 또는 입력 방법: 호출자가 알림 에스컬레이션 순서에 따라 구성합니다. |
|
| scheduleStrategy[*].strategy[*] | json | 단일 레벨 알림 설정입니다. 현재 저장 시 리프 유형을 강하게 검증하지 않습니다. 예: {"level": 0, "notifyConfig": [{"notifyObject": ["watchkeeper"]}], "ifRepeatNotify": false}가져오기 또는 입력 방법: 인시던트 생성/에스컬레이션 요구 사항에 따라 구성합니다. |
|
| scheduleStrategy[*].strategy[*].level | integer | 0은 생성 알림, 이후 양의 정수는 에스컬레이션 레벨입니다. 번호를 건너뛰거나 인덱스와 대응하지 않게 재정렬할 수 없습니다. 예: 0가져오기 또는 입력 방법: 0부터 배열 순서대로 연속 번호를 지정합니다. |
|
| scheduleStrategy[*].strategy[*].levelUpTime | integer | 양수 레벨에서 인시던트 상태 변경 시간 기준 대기 초입니다. 생략하거나 0이면 기본 0레벨 선택을 따르며 무한 대기로 간주할 수 없습니다. 예: 600가져오기 또는 입력 방법: 인시던트가 미처리 상태로 얼마나 지속되면 에스컬레이션할지에 따라 초를 선택합니다. |
|
| scheduleStrategy[*].strategy[*].incidentsLevel | array | 에스컬레이션 적용 레벨 UUID 배열이며, 양수 levelUpTime 분기에서는 일치해야 합니다. P1 표시 이름이 아닙니다.예: ["system_level_1"]가져오기 또는 입력 방법: 인시던트 레벨 목록에서 uuid를 가져오고 현재 유효한 설정인지 확인합니다. |
|
| scheduleStrategy[*].strategy[*].incidentsLevel[*] | string | 단일 레벨 UUID입니다. 예: system_level_1가져오기 또는 입력 방법: 인시던트 레벨 목록의 uuid를 사용합니다. |
|
| scheduleStrategy[*].strategy[*].incidentsStatus | array | 에스컬레이션 적용 상태 배열이며 일반적으로 open/working을 사용합니다. 양수 levelUpTime 분기에서는 상태가 일치해야 합니다.예: ["open", "working"]가져오기 또는 입력 방법: 인시던트 목록의 incidentsStatus 비즈니스 상태를 사용합니다. |
|
| scheduleStrategy[*].strategy[*].incidentsStatus[*] | string | 하나의 상태 문자열입니다. 예: open가져오기 또는 입력 방법: 인시던트 비즈니스 상태이며 데이터베이스의 0/2/3이 아닙니다. |
|
| scheduleStrategy[*].strategy[*].ifRepeatNotify | boolean | 생략 시 false입니다. true이면 유효한 양수 repeatNotifyInterval을 제공해야 하며, 기본 레벨 계산에서 간격에 대해 모듈로 연산을 수행할 수 있어 0이면 작업에서 실패합니다.예: false가져오기 또는 입력 방법: 동일 레벨에서 반복 알림을 보낼지 결정합니다. |
|
| scheduleStrategy[*].strategy[*].repeatNotifyInterval | integer | 반복 간격(초)이며 >=60 및 정수 분을 권장합니다. 반복을 켠 경우에만 의미가 있으며 0/음수를 전달할 수 없습니다.예: 600가져오기 또는 입력 방법: 알림 빈도에 따라 양의 정수 초를 선택하고 60초의 양의 정수 배수를 권장합니다. |
|
| scheduleStrategy[*].strategy[*].notifyConfig | array | 알림 설정 객체 배열입니다. watchkeeper는 런타임에 현재 유효한 온콜 담당자(대리 근무 포함)로 대체되며 고정 계정이 아닙니다.예: [{"notifyObject": ["watchkeeper"]}]가져오기 또는 입력 방법: 수신 대상과 알림 방식에 따라 구성합니다. |
|
| scheduleStrategy[*].strategy[*].notifyConfig[*] | json | 알림 대상과 선택적 알림 방식의 집합입니다. 예: {"notifyObject": ["watchkeeper"]}가져오기 또는 입력 방법: 실제 알림 대상에 따라 구성합니다. |
|
| scheduleStrategy[*].strategy[*].notifyConfig[*].notifyObjectType | string | 선택적 표시 분류입니다. 실행 체인은 주로 notifyObject와 notifyMethod를 기반으로 하며 이 필드로 대상을 검증하지 않습니다.예: member가져오기 또는 입력 방법: 편집기 표시 분류 member/object/group을 그대로 사용할 수 있습니다. |
|
| scheduleStrategy[*].strategy[*].notifyConfig[*].notifyObject | array | 대상 식별자 배열입니다. 빈 []는 자동으로 모든 온콜 담당자를 사용하지 않으며 watchkeeper를 명시해야 합니다.예: ["watchkeeper"]가져오기 또는 입력 방법: 워크스페이스 멤버에서 acnt_, 팀 목록에서 group_, 알림 대상 목록에서 notify_를 가져오거나 허용된 유효 이메일을 입력합니다. 현재 교대조는 리터럴 값 watchkeeper를 사용합니다. |
|
| scheduleStrategy[*].strategy[*].notifyConfig[*].notifyObject[*] | string | 단일 대상 또는 watchkeeper 자리 표시자입니다.예: watchkeeper가져오기 또는 입력 방법: 워크스페이스 멤버에서 acnt_, 팀 목록에서 group_, 알림 대상 목록에서 notify_를 가져오거나 허용된 유효 이메일을 입력합니다. |
|
| scheduleStrategy[*].strategy[*].notifyConfig[*].notifyMethod | array | 생략하거나 []이면 범용 대상 전송을 사용하며 notify_ 객체는 해당 설정을 따릅니다. 배열을 명시하면 방식을 선택하지만 대상에 관련 연락처가 설정되어 있거나 사이트에서 유료 채널이 개통되어 있음을 보장하지 않습니다.예: ["email"]가져오기 또는 입력 방법: 대상이 사용 가능한 알림 채널에 따라 email 이메일/mobile 전화/message SMS를 선택합니다. |
|
| scheduleStrategy[*].strategy[*].notifyConfig[*].notifyMethod[*] | string | email/mobile/message와 같은 단일 방식이며 배포 환경에서 실제 사용 가능한 기능으로 검증합니다.예: email가져오기 또는 입력 방법: 개통된 알림 방식을 사용합니다. |
|
| dimensionFilter | string | 선택적 쿼리 문자열이며 JSON/SQL/DQL이 아닙니다. 프로젝트 쿼리 구문을 지원하며 구문 분석이 유효하지 않으면 400입니다. 생성 시 생략하면 비어 있고, 수정 시 생략해도 비워집니다. 태그와 디멘션 필터는 실행 체인에서 매칭됩니다. 태그 중 하나라도 일치하거나 디멘션 표현식이 일치하면 됩니다. 둘 다 비어 있으면 모두 일치하며, 반드시 동시에 충족해야 한다고 오해하지 마십시오. null 허용: False 예: service:payment가져오기 또는 입력 방법: 인시던트 dimensionTag의 실제 디멘션 필드와 값에서 쿼리 문자열을 구성합니다. |
|
| end | string | Y | 필수 HH:MM이며 start보다 늦어야 하고 최대 23:59입니다. 실제 근무 시간대에는 종료 분의 59초까지 포함됩니다.null 허용: False 최대 길이: 48 예: 18:00가져오기 또는 입력 방법: 온콜 일정 timezone에 따라 매일 종료 시각을 선택합니다. |
| extend | json | 선택적 JSON 객체이며 생략 시 {}입니다. 수정 시 기존 공개 확장을 전체 교체합니다. 현재 enableRotateNotification, rotationCycle, effectiveTime 세 개의 선언 키만 허용되며, workTime/rotationInterval/agentUUIDs 등 조회된 키는 다시 전송할 수 없고 먼저 406이 발생합니다. 수정 시 기존 Agent 연결은 유지되지만 기존 workTime 등 비공개 확장은 제거되므로 백업 및 영향 평가 후 작업하십시오.null 허용: False 예: {"enableRotateNotification": false}가져오기 또는 입력 방법: 교대 방식과 유효 날짜에 따라 구성합니다. |
|
| extend.effectiveTime | json | 선택적 객체이며 생략하거나 {}이면 유효 날짜 제한이 없습니다. 밀리초나 이전 설명의 11자리 요구 사항이 아닙니다. start/end는 각각 생략할 수 있고 0이 아닐 때만 적용됩니다. 둘 다 0이 아니고 end < start이면 400입니다. 내부 하위 필드는 유형 검증이 선언되어 있지 않으므로 반드시 정수 초를 사용하고 문자열/null 또는 임의 구조를 사용하지 마십시오.null 허용: False 예: {"start": 1785369600, "end": 1785455999}가져오기 또는 입력 방법: 온콜 일정 유효 날짜 경계를 Unix 초로 변환하며 시간대 도구로 계산할 수 있습니다. |
|
| extend.enableRotateNotification | boolean | 선택적 불리언이며 생략 시 false입니다. true이면 rotationCycle을 명시해야 하며 그렇지 않으면 400 MissingCustomParameters가 발생합니다.null 허용: False 예: false가져오기 또는 입력 방법: 모든 대상이 동시에 온콜이면 false, notifyTargets 순서대로 교대하면 true를 사용합니다. |
|
| extend.rotationCycle | string | 선택적 열거형 day/week/month/workDay/weekend이며 로테이션을 켜면 필수입니다. 온콜 일정 시간대의 달력 주기를 따르며 고정 초 수가 아닙니다. week는 월요일 기준 전환, month는 자연 월 기준 전환, workDay/weekend는 요일만 따르고 법정 공휴일은 인식하지 않습니다. 현재 공개 선언에서는 customDay/customWeek를 허용하지 않으므로 과거 응답에 있더라도 다시 전송할 수 없습니다. 기존 호환 근무 시간은 workDay에서 월요일~금요일, weekend에서 토요일~일요일만 적용되며 로테이션을 켜지 않아도 근무일에 영향을 줍니다.null 허용: False 선택 가능한 값: ['day', 'week', 'month', 'workDay', 'weekend'] 예: day가져오기 또는 입력 방법: 교대에 따라 day 일/week 주/month 월/workDay 근무일/weekend 주말을 선택합니다. |
|
| name | string | Y | 필수 비어 있지 않은 문자열입니다. 선언상 최대 256자이지만 엔터티 컬럼은 128자이므로 1–128자로 제한하는 것이 좋습니다. 동일 워크스페이스에서 삭제되지 않은 온콜 일정은 이름이 중복될 수 없습니다. 수정 시에도 필수입니다. 빈 문자열 허용: False null 허용: False 최대 길이: 256 예: 支付服务值班가져오기 또는 입력 방법: 온콜 유지 관리자가 워크스페이스 내에서 고유한 이름을 입력합니다. |
| notifyTargets | array | Y | 필수 배열이며 []도 허용되지만 알림을 받을 사람이 없을 수 있습니다. 원래 순서대로 저장되며 로테이션을 켜면 순서가 교대에 영향을 줍니다. acnt_/notify_/group_은 접두사로만 이메일 검증을 건너뛰며 대상 존재/유효성/전달 가능성을 보장하지 않으므로 반드시 원본 목록에서 확인해야 합니다. 일반 이메일은 형식을 검사하며 체험/무료 워크스페이스에서는 워크스페이스 멤버가 아닌 이메일을 허용하지 않습니다. 수정 시 전체 교체합니다.null 허용: False 예: ["acnt_example"]가져오기 또는 입력 방법: 워크스페이스 멤버에서 acnt_, 팀 목록에서 group_, 알림 대상 목록에서 notify_를 가져오거나 허용된 유효 이메일을 입력합니다. |
| scheduleStrategy | array | 선택적 정책 객체 배열입니다. 생성 시 생략하면 []이며 수정 시 생략/[]하면 기존 정책이 비워집니다. 현재 저장 측에서 하위 항목 전체 검증을 수행하지 않으므로 성공이 알림 설정의 실행 가능성을 보장하지 않습니다. 배열과 내부 레벨 구조가 올바라야 하며 최소 설정으로 먼저 검증하는 것이 좋습니다.예: []가져오기 또는 입력 방법: 현재 워크스페이스 온콜 정책 편집기에서 구성하고 JSON 구조를 확인하거나 아래 필드에 따라 구성할 수 있습니다. |
|
| start | string | Y | 필수 HH:MM 일내 시각이며 날짜나 Unix 시간이 아닙니다. end보다 빨라야 하고 자정을 넘지 않습니다. 24:00을 전달하지 말고, 날짜를 넘는 요구 사항은 일정을 분할하거나 제품에서 지원하는 다른 관리 방식을 사용하십시오.null 허용: False 최대 길이: 48 예: 09:00가져오기 또는 입력 방법: 온콜 일정 timezone에 따라 매일 시작 시각을 선택합니다. |
| tagFilter | array | 선택적 태그 이름 배열입니다. 생성 시 생략하면 태그가 없고 수정 시 생략/[]하면 비워집니다. 컨트롤러가 태그 UUID로 변환하여 응답 tagFilter에 저장합니다. 새 태그는 all 범위로 생성되고 기존 이름은 직접 재사용됩니다. 현재 체인에서는 monitor 범위 검증을 전달하지 않으므로 인시던트 태그 작성 시의 충돌 규칙을 적용하지 마십시오. 단일 이름 컨트롤러는 최대 128자이지만 엔터티 컬럼은 64자이므로 1–64자를 권장합니다.null 허용: False 예: ["production"]가져오기 또는 입력 방법: 태그 목록에서 name(uuid 아님)을 가져오거나 새 태그 이름을 입력합니다. |
|
| timezone | string | 선택적 문자열로 최대 48자이며 생략 시 Asia/Shanghai입니다. 수정 시 생략하면 유지되지 않고 이 기본값으로 재설정됩니다. 잘못된 시간대는 포맷/조회 시 500이 발생할 수 있으므로 저장 전에 검증해야 합니다.null 허용: False 최대 길이: 48 예: Asia/Shanghai가져오기 또는 입력 방법: IANA 시간대 라이브러리 식별자(예: Asia/Shanghai 또는 UTC)를 사용합니다. |
매개변수 추가 설명¶
요청은 이 페이지의 공개 매개변수를 기준으로 합니다. 일내 start/end는 HH:MM이고 유효 기간 및 대리 근무 시간은 Unix 초입니다. 전체 필드, 값 출처, 응답 분기 및 실패 처리는 아래와 같습니다.
요청 예시¶
curl --request POST 'https://openapi.guance.com/api/v1/incidents/schedule/incsch_example/modify' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json' \
--data-raw '{"name":"支付服务值班","timezone":"Asia/Shanghai","start":"09:00","end":"18:00","notifyTargets":["acnt_example"],"dimensionFilter":"service:payment","extend":{"enableRotateNotification":false},"scheduleStrategy":[]}'
응답¶
HTTP 200, application/json. 아래 예시는 바로 읽을 수 있는 주요 필드를 보여줍니다.
| 필드 | 유형 | 설명 |
|---|---|---|
| content | object | 제출 전에 조립된 온콜 일정 엔터티 스냅샷이며 목록/상세의 동적 온콜 요약은 포함하지 않습니다. |
| content.id | integer 또는 null | 데이터베이스 행 ID입니다. 비즈니스 식별에는 uuid를 사용하며 제출 전 스냅샷에서는 null일 수 있습니다. |
| content.uuid | string | 온콜 UUID이며 incsch_ 접두사를 사용합니다. |
| content.status | integer | 데이터베이스 상태이며 일반적으로 0은 활성, 3은 삭제입니다. 인시던트의 open/working이 아닙니다. |
| 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.timezone | string | IANA 시간대입니다. |
| content.start | string | 호환되는 매일 근무 시작 시각 HH:MM이며 일정 timezone에 따라 해석되고 날짜나 Unix 시간이 아닙니다. |
| content.end | string | 호환되는 매일 근무 종료 시각 HH:MM이며 유효 날짜 경계는 extend.effectiveTime을 참조하십시오. |
| content.tagFilter | array<string> |
일치하는 태그 UUID 배열입니다. |
| content.tagFilter[] | string | 태그 UUID입니다. |
| content.dimensionFilter | string | 디멘션 매칭 쿼리 표현식입니다. |
| content.notifyTargets | array<string> |
알림 대상 식별자 목록입니다. |
| content.notifyTargets[] | string | 계정/그룹/알림 대상 등의 대상 식별자입니다. |
| content.strategyConfig | array<object> |
에스컬레이션 정책 설정이며 워크스페이스에 저장된 버전에 따라 조회합니다. |
| content.strategyConfig[] | object | 하나의 설정 정책이며 인시던트 조회 인터페이스에서는 실행 미리보기를 펼치지 않습니다. |
| content.strategyConfig[].自定义字段 | JSON | 기타 저장된 정책 키이며 공개된 고정 실행 의미는 없습니다. |
| content.extend | object | 온콜 일정 확장 객체입니다. 공개 요청은 enableRotateNotification/rotationCycle/effectiveTime 세 개의 선언된 키만 허용하며 과거 조회에는 더 많은 키가 있을 수 있습니다. |
| content.extend.自定义字段 | JSON | 저장된 온콜 확장 키-값이며 이 인터페이스로 수정할 수 없습니다. |
| content.isDefault | boolean | 기본 온콜 여부입니다. |
| content.rotationUpdateAt | integer | 로테이션 앵커 Unix 초입니다. 새로 생성 시 기본값은 -1이며 현재 계산에서는 생성 시간으로 자동 폴백되지 않습니다. 최초 로테이션이 첫 번째 대상부터 시작한다고 보장하지 않으며 의미 변경 후 재설정될 수 있습니다. |
| content.agentUUIDs | array<string> |
확장의 연결된 Agent UUID 배열입니다. |
| content.agentUUIDs[] | string | 하나의 Agent UUID입니다. |
| content.strategyConfig[].uuid | string | 정책 UUID입니다. |
| content.strategyConfig[].name | string | 정책 이름입니다. |
| content.strategyConfig[].strategy | array<object> |
해당 정책의 에스컬레이션 레벨 설정 배열입니다. |
| content.strategyConfig[].strategy[].level | integer | 레벨 번호이며 일반적으로 0부터 시작합니다. |
| content.strategyConfig[].strategy[].levelUpTime | integer | 인시던트 상태 트리거 시간부터의 에스컬레이션 대기 초입니다. |
| content.strategyConfig[].strategy[].incidentsLevel | array<string> |
적용 가능한 인시던트 레벨 UUID 목록입니다. |
| content.strategyConfig[].strategy[].incidentsLevel[] | string | 하나의 레벨 UUID입니다. |
| content.strategyConfig[].strategy[].incidentsStatus | array<string> |
적용 가능한 인시던트 상태 목록(예: open/working)입니다. |
| content.strategyConfig[].strategy[].incidentsStatus[] | string | 하나의 인시던트 상태입니다. |
| content.strategyConfig[].strategy[].ifRepeatNotify | boolean | 반복 알림 여부입니다. |
| content.strategyConfig[].strategy[].repeatNotifyInterval | integer | 반복 알림 간격(초)입니다. |
| content.strategyConfig[].strategy[].notifyConfig | array<object> |
해당 레벨의 알림 설정 배열입니다. |
| content.strategyConfig[].strategy[].notifyConfig[].notifyObjectType | string | 알림 대상 분류(예: member/object/group)이며 저장된 버전에 따라 조회합니다. |
| content.strategyConfig[].strategy[].notifyConfig[].notifyObject | array<string> |
알림 대상 식별자입니다. watchkeeper는 런타임의 현재 온콜 담당자를 의미하며 고정 계정 UUID가 아닙니다. |
| content.strategyConfig[].strategy[].notifyConfig[].notifyObject[] | string | 하나의 대상 계정/그룹/알림 대상 식별자 또는 watchkeeper입니다. |
| content.strategyConfig[].strategy[].notifyConfig[].notifyMethod | array<string> |
알림 방식이며 일반적으로 mobile 전화/message SMS/email 이메일입니다. 객체 채널은 객체 설정에 따라 실행됩니다. |
| content.strategyConfig[].strategy[].notifyConfig[].notifyMethod[] | string | 하나의 알림 방식입니다. |
| content.extend.enableRotateNotification | boolean | 알림 대상 로테이션 여부입니다. |
| content.extend.rotationCycle | string | day/week/month/workDay/weekend/customDay/customWeek 중 하나이며 과거 응답에서는 생략될 수 있습니다. |
| content.extend.rotationInterval | integer | customDay 로테이션 간격 일수 1~31, customWeek 주수 1~4입니다. |
| content.extend.effectiveTime | object | 일정 유효 기간 설정입니다. |
| content.extend.effectiveTime.start | integer | 저장된 유효 시작 Unix 초이며 없으면 시작 제한을 설정하지 않습니다. |
| content.extend.effectiveTime.end | integer | 저장된 유효 종료 Unix 초이며 없으면 종료 제한을 설정하지 않습니다. |
| content.extend.workTime | object | 근무 시간 설정이며 없으면 호환 start/end 및 로테이션 주기에서 유도됩니다. |
| content.extend.workTime.mode | string | allDay 전체 일 또는 specificTimes 지정 시간입니다. |
| content.extend.workTime.periods | array<object> |
지정 근무 시간대 배열입니다. |
| content.extend.workTime.periods[].weekdays | array<integer> |
적용 요일 1 월요일~7 일요일입니다. |
| content.extend.workTime.periods[].weekdays[] | integer | 1~7 중 하나입니다. |
| content.extend.workTime.periods[].start | string | 현지 일 시작 HH:MM입니다. |
| content.extend.workTime.periods[].end | string | 현지 일 종료 HH:MM입니다. |
| content.extend.agentUUIDs | array<string> |
연결된 Agent UUID이며 엔터티에는 별도의 최상위 agentUUIDs 프로젝션도 있습니다. |
| content.extend.agentUUIDs[] | string | 하나의 Agent UUID입니다. |
| content.strategyConfig[].strategy[].notifyConfig[].notifyType | JSON | 이전 편집기에서 유지될 수 있는 표시 분류입니다. 실행 체인은 주로 notifyObject/notifyMethod를 읽으며 이 값으로 전송을 제어할 수 없습니다. |
| content.extend.effectiveTime.其他键 | JSON | 선언되지 않은 유효 기간 확장은 그대로 저장되며 클라이언트는 start/end만 사용합니다. |
| content.declaration | object 또는 null | 현재 워크스페이스의 공통 선언입니다. |
{
"code": 200,
"content": {
"id": 7,
"uuid": "incsch_example",
"status": 0,
"creator": "wsak_example",
"updator": "wsak_example",
"createAt": 1785427200,
"updateAt": 1785427260,
"deleteAt": -1,
"workspaceUUID": "wksp_example",
"name": "支付服务值班",
"timezone": "Asia/Shanghai",
"start": "09:00",
"end": "18:00",
"tagFilter": [],
"dimensionFilter": "service:payment",
"notifyTargets": [
"acnt_example"
],
"strategyConfig": [],
"extend": {
"enableRotateNotification": false,
"agentUUIDs": []
},
"isDefault": false,
"rotationUpdateAt": -1,
"agentUUIDs": [],
"declaration": {}
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
오류 응답¶
인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참조하십시오.
| HTTP 상태 | errorCode | 발생 조건 | 메시지 또는 응답 설명 | 처리 방법 |
|---|---|---|---|---|
| 406 | ft.ParameterValidationFailed | 요청 필드 누락 또는 필드 값이 선언된 검증 조건을 위반함 | 매개변수 구문 분석 실패 | 매개변수 위치, 필드명, 유형 및 값을 확인합니다. |
| 400 | ft.RequestJsonFormatError | 요청 JSON 구문이 유효하지 않음 | 요청 JSON 형식 오류 | content.reason, line, column에 따라 JSON을 수정합니다. |
| 400 | ft.JsonFormatError | JSON 최상위가 객체가 아님 | 일부 json 파일 형식 오류 | 전체 온콜 일정 매개변수 객체를 제출합니다. |
| 400 | ft.InvalidStartEndTimeFromat | 일내 시간 형식/범위가 유효하지 않거나 start >= end |
유효하지 않은 시간대 형식 | 같은 날짜의 유효한 HH:MM을 사용하고 start가 end보다 빨라야 합니다. |
| 400 | ft.InvalidEffectiveTime | 0이 아닌 유효 기간 end가 start보다 빠름 |
유효하지 않은 적용 시간 | Unix 초와 시간대를 확인하고 밀리초를 혼용하지 마십시오. |
| 400 | ft.MissingCustomParameters | extend.enableRotateNotification=true이지만 rotationCycle 누락 |
rotationCycle 필드 누락 |
공개 지원 주기를 제공합니다. |
| 406 | ft.InvalidEmail | notifyTargets가 계정/팀/알림 대상 접두사가 아니고 이메일 형식 오류 |
유효하지 않은 이메일 주소 | 원본 목록에서 식별자를 선택하거나 유효한 이메일을 사용합니다. |
| 400 | ft.UnsupportExternalEmail | 체험/무료 워크스페이스에서 해당 워크스페이스 멤버가 아닌 이메일 사용 | 체험 버전 워크스페이스, 외부 이메일을 알림 대상으로 지원하지 않음 | 워크스페이스 멤버 이메일을 선택하거나 관리자가 제품 버전 제한을 확인하도록 합니다. |
| 400 | ft.scheduleSameNameExists | 동일 워크스페이스에서 삭제되지 않은 온콜 일정 이름 중복 | 동일 이름 일정이 이미 존재 | 고유 이름을 사용하고 네트워크 실패 시 먼저 목록을 조회하여 중복 생성을 피합니다. |
| 400 | ft.ParamsValidateError | dimensionFilter 구문 분석 실패 |
매개변수 검증 실패: Field dimensionFilter is fault |
service:payment와 같은 유효한 디멘션 쿼리 문자열로 변경합니다. |
| 406 | ft.ExceedMaxCharacterLimit | tagFilter 태그 이름이 컨트롤러 128자 한도 초과 |
{} 최대 문자 길이 제한 초과 | 짧은 비어 있지 않은 태그 이름을 사용하고 엔터티 컬럼 호환을 위해 <=64를 권장합니다. |
| 500 | ft.InternalServerError | 데이터베이스/태그 잠금 캐시, 알림 하위 구조, 잘못된 시간대 또는 제출 후 큐 전송 등 처리되지 않은 예외 | 내부 오류 | 먼저 온콜 일정/태그의 실제 상태를 다시 읽습니다. 본문은 이미 커밋되었을 수 있으며 큐가 수렴되지 않았더라도 중복 생성하지 마십시오. traceId를 보존하여 처리하고 수정 전에 전체 설정을 백업합니다. |
| 400 | ft.IncidentsScheduleNotFound | 검증 후 대상 일정이 현재 워크스페이스에 없거나 삭제됨 | 지정된 인시던트 온콜을 찾을 수 없음 | 현재 워크스페이스 목록에서 uuid를 새로 고칩니다. 이름/시간 오류가 먼저 보고될 수 있으므로 오류 순서로 존재 여부를 판단할 수 없습니다. |