추가¶
POST /api/v1/issue/notification_policy/add
개요¶
알림 정책을 생성하고 Issue 알림 범위, 스케줄 및 에스컬레이션 규칙을 구성합니다.
호출 전 준비 및 사용 단계¶
생성 시 최소한 비어 있지 않은 name과 notificationScheduleUUIDs:[]를 제출해야 합니다. 이 배열은 런타임 선언에서는 여전히 선택 사항이지만, 현재 생략하면 정책 본문이 이미 저장된 후 500이 반환될 수 있으므로 클라이언트는 배열을 명시적으로 전달해야 합니다. 스케줄을 연결하지 않으려면 []를 사용합니다. 알림을 발생시키려면 실제 스케줄, 알림 유형 및 필요한 에스컬레이션 설정을 선택해야 합니다. 생성 시 전체 에스컬레이션 규칙을 구성하는 것이 좋습니다. 정책은 콘솔에서 대상 채널에 연결해야 하며 유효한 알림 스케줄과 연결해야 합니다. 실제 수신자는 스케줄의 타임존, 당일 시간대, 유효 기간, 교대 및 알림 대상에 따라 결정됩니다. 정책을 저장하는 것만으로는 테스트 알림이 즉시 전송되지 않습니다. 에스컬레이션은 사이트 정기 작업에서 검사하며 정확한 카운트다운이 아닙니다. 트리거 설정이 생성되거나 업데이트된 후 새로 생성된 Issue만 검사합니다. 스케줄에 당시 유효한 대상이 없어도 트리거 1회로 기록될 수 있으므로 트리거 횟수를 전달 횟수로 간주해서는 안 됩니다. 알림 대상과 실제 메시지를 함께 확인하세요. 정책 본문, 연결 관계 및 에스컬레이션 트리거 설정은 단계별로 저장됩니다. 실패하거나 시간 초과된 후에는 먼저 상세 정보를 읽어 기존 변경 사항을 확인한 다음 재시도 여부를 결정하세요.
요청 헤더¶
| 파라미터 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| DF-API-KEY | string | Y | 워크스페이스의 OpenAPI 인증 자격 증명입니다. 예시: <DF-API-KEY>획득 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 획득합니다. |
Body 요청 파라미터¶
| 파라미터 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| notificationScheduleUUIDs[*] | string | 단일 알림 스케줄 UUID입니다. 알림 대상 UUID로 대체할 수 없습니다. 예시: nsche_example획득 또는 입력 방법: 알림 스케줄 목록에서 단일 스케줄 UUID를 복사합니다. 알림 스케줄 상세에서 설정 및 대상을 확인할 수 있습니다. |
|
| extend.notifyTypes[*] | string | 단일 트리거 유형입니다. openProcessTimeout도 issueUpgrade.processTimeout으로 활성화되며, issueUpgrade.openProcessTimeout을 별도로 전달하지 않습니다. 예시: issueUpgrade.eventStorm획득 또는 입력 방법: 트리거 의도에 따라 위 이벤트 유형 중 하나를 선택합니다. 이벤트 유형 자체는 수신자를 지정하지 않습니다. |
|
| extend.upgradeCfg.noManager | json | Issue 생성 시 유효한 담당자가 없어 담당자 없음 후보에 진입하고 상태가 Open/Working/Pending이면 Issue 생성 시점부터 대기합니다. 기존 Issue에서 담당자만 제거해도 후보에 다시 진입한다고 보장하지 않습니다. 양의 정수 초를 입력하며 60의 배수여야 합니다. 생략하거나 빈 객체를 사용하면 이 규칙은 활성화되지 않습니다. 예시: {"duration": 600, "notifyType": "once"}획득 또는 입력 방법: extend.notifyTypes에 issueUpgrade.noManager를 포함한 후 비즈니스 요구에 맞게 입력합니다. |
|
| extend.upgradeCfg.noManager.duration | integer | 활성화 시 양의 정수 초가 필수이며 60의 배수여야 하고 최대 31622400초입니다. 생략하거나 0이면 해당 규칙을 생성하지 않습니다. 예시: 600획득 또는 입력 방법: 비즈니스 대기 시간을 초로 환산합니다. 예를 들어 600은 10분입니다. |
|
| extend.upgradeCfg.noManager.notifyType | string | 알림 방식은 once 또는 cycle이며, 생략 시 기본값은 once입니다. 예시: once획득 또는 입력 방법: 한 번만 알림을 보내려면 once를, 반복 검사 및 전송이 필요하면 cycle을 입력합니다. |
|
| extend.upgradeCfg.noManager.cycleDuration | integer | cycle 모드에서 필수인 순환 간격(초)입니다. 매번 duration을 증가시키는 것이 아니며, 실제로는 정기 작업과 스케줄 유효성의 영향을 받습니다. 예시: 600획득 또는 입력 방법: cycle 모드에서는 양의 정수 초 간격을 선택합니다. 예를 들어 600은 10분입니다. once 모드에서는 생략합니다. |
|
| extend.upgradeCfg.noManager.cycleTimes | integer | cycle 모드에서 필수이며 최대 트리거 횟수에 최초 트리거를 포함합니다. 검증 범위는 1~30이며, 실제 기록 횟수는 성공 전달 횟수와 같지 않습니다. 예시: 3획득 또는 입력 방법: cycle 모드에서는 1~30의 정수를 입력합니다. once 모드에서는 생략합니다. |
|
| extend.upgradeCfg.processTimeout | json | Issue가 Open/Working 상태에 있는 연속 미완료 시간입니다. 최초에는 생성 시점부터 시간을 측정하며, Pending/Resolved/Closed에서 처리 상태로 다시 진입하면 재진입 후 상태가 기록된 시점부터 시간을 측정합니다. 생략하거나 빈 객체를 사용하면 이 규칙은 활성화되지 않습니다. 예시: {"duration": 1800, "notifyType": "cycle", "cycleDuration": 600, "cycleTimes": 3}획득 또는 입력 방법: extend.notifyTypes에 issueUpgrade.processTimeout을 포함한 후 비즈니스 요구에 맞게 입력합니다. |
|
| extend.upgradeCfg.processTimeout.duration | integer | 활성화 시 양의 정수 초가 필수이며 60의 배수여야 하고 최대 31622400초입니다. 생략하거나 0이면 해당 규칙을 생성하지 않습니다. 예시: 1800획득 또는 입력 방법: 비즈니스 대기 시간을 초로 환산합니다. 예를 들어 600은 10분입니다. |
|
| extend.upgradeCfg.processTimeout.notifyType | string | 알림 방식은 once 또는 cycle이며, 생략 시 기본값은 once입니다. 예시: cycle획득 또는 입력 방법: 한 번만 알림을 보내려면 once를, 반복 검사 및 전송이 필요하면 cycle을 입력합니다. |
|
| extend.upgradeCfg.processTimeout.cycleDuration | integer | cycle 모드에서 필수인 순환 간격(초)입니다. 매번 duration을 증가시키는 것이 아니며, 실제로는 정기 작업과 스케줄 유효성의 영향을 받습니다. 예시: 600획득 또는 입력 방법: cycle 모드에서는 양의 정수 초 간격을 선택합니다. 예를 들어 600은 10분입니다. once 모드에서는 생략합니다. |
|
| extend.upgradeCfg.processTimeout.cycleTimes | integer | cycle 모드에서 필수이며 최대 트리거 횟수에 최초 트리거를 포함합니다. 검증 범위는 1~30이며, 실제 기록 횟수는 성공 전달 횟수와 같지 않습니다. 예시: 3획득 또는 입력 방법: cycle 모드에서는 1~30의 정수를 입력합니다. once 모드에서는 생략합니다. |
|
| extend.upgradeCfg.openProcessTimeout | json | Issue가 Open 상태를 유지할 때만 적용되며 마지막 상태 변경 시점부터 시간을 측정합니다. 상태 기록이 없으면 생성 시점부터 시간을 측정합니다. 생략하거나 빈 객체를 사용하면 이 규칙은 활성화되지 않습니다. 예시: {"duration": 900, "notifyType": "once"}획득 또는 입력 방법: extend.notifyTypes에 issueUpgrade.processTimeout을 포함한 후 비즈니스 요구에 맞게 입력합니다. |
|
| extend.upgradeCfg.openProcessTimeout.duration | integer | 활성화 시 양의 정수 초가 필수이며 60의 배수여야 하고 최대 31622400초입니다. 생략하거나 0이면 해당 규칙을 생성하지 않습니다. 예시: 900획득 또는 입력 방법: 비즈니스 대기 시간을 초로 환산합니다. 예를 들어 600은 10분입니다. |
|
| extend.upgradeCfg.openProcessTimeout.notifyType | string | 알림 방식은 once 또는 cycle이며, 생략 시 기본값은 once입니다. 예시: once획득 또는 입력 방법: 한 번만 알림을 보내려면 once를, 반복 검사 및 전송이 필요하면 cycle을 입력합니다. |
|
| extend.upgradeCfg.openProcessTimeout.cycleDuration | integer | cycle 모드에서 필수인 순환 간격(초)입니다. 매번 duration을 증가시키는 것이 아니며, 실제로는 정기 작업과 스케줄 유효성의 영향을 받습니다. 예시: 600획득 또는 입력 방법: cycle 모드에서는 양의 정수 초 간격을 선택합니다. 예를 들어 600은 10분입니다. once 모드에서는 생략합니다. |
|
| extend.upgradeCfg.openProcessTimeout.cycleTimes | integer | cycle 모드에서 필수이며 최대 트리거 횟수에 최초 트리거를 포함합니다. 검증 범위는 1~30이며, 실제 기록 횟수는 성공 전달 횟수와 같지 않습니다. 예시: 3획득 또는 입력 방법: cycle 모드에서는 1~30의 정수를 입력합니다. once 모드에서는 생략합니다. |
|
| extend.upgradeCfg.eventStorm | json | Issue에 기록된 eventCount가 exceedTimes를 엄격히 초과하면 트리거됩니다. Open/Working 상태로 제한되지 않으며 완료된 Issue도 수량 조건을 충족할 수 있습니다. 생략하거나 빈 객체를 사용하면 이 규칙은 활성화되지 않습니다. 예시: {"exceedTimes": 60, "notifyType": "once"}획득 또는 입력 방법: extend.notifyTypes에 issueUpgrade.eventStorm을 포함한 후 비즈니스 요구에 맞게 입력합니다. |
|
| extend.upgradeCfg.eventStorm.exceedTimes | integer | 이벤트 수량 임계값이며 시간이 아닙니다. 활성화 시 양의 정수가 필수이며 31622400을 초과할 수 없습니다. 예시: 60획득 또는 입력 방법: 허용 가능한 연결 이벤트 수에 따라 양의 정수 임계값을 설정합니다. 예를 들어 60은 eventCount가 60을 초과해야 트리거됨을 의미합니다. |
|
| extend.upgradeCfg.eventStorm.notifyType | string | 알림 방식은 once 또는 cycle이며, 생략 시 기본값은 once입니다. 예시: once획득 또는 입력 방법: 한 번만 알림을 보내려면 once를, 반복 검사 및 전송이 필요하면 cycle을 입력합니다. |
|
| extend.upgradeCfg.eventStorm.cycleDuration | integer | cycle 모드에서 필수인 순환 간격(초)입니다. 매번 duration을 증가시키는 것이 아니며, 실제로는 정기 작업과 스케줄 유효성의 영향을 받습니다. 예시: 600획득 또는 입력 방법: cycle 모드에서는 양의 정수 초 간격을 선택합니다. 예를 들어 600은 10분입니다. once 모드에서는 생략합니다. |
|
| extend.upgradeCfg.eventStorm.cycleTimes | integer | cycle 모드에서 필수이며 최대 트리거 횟수에 최초 트리거를 포함합니다. 검증 범위는 1~30이며, 실제 기록 횟수는 성공 전달 횟수와 같지 않습니다. 예시: 3획득 또는 입력 방법: cycle 모드에서는 1~30의 정수를 입력합니다. once 모드에서는 생략합니다. |
|
| extend | json | 선택적 알림 설정입니다. 생략하면 {}로 저장되며 알림 동작을 활성화하지 않습니다. null 허용: False 예시: {"notifyTypes": ["issue.add", "issue.modify", "issueReply.add", "issueUpgrade.noManager", "issueUpgrade.processTimeout", "issueUpgrade.eventStorm"], "upgradeCfg": {"noManager": {"duration": 600, "notifyType": "once"}, "processTimeout": {"duration": 1800, "notifyType": "cycle", "cycleDuration": 600, "cycleTimes": 3}, "openProcessTimeout": {"duration": 900, "notifyType": "once"}, "eventStorm": {"exceedTimes": 60, "notifyType": "once"}}}획득 또는 입력 방법: 수신하려는 Issue 동작 및 에스컬레이션 규칙에 맞게 입력합니다. 내용이 없으면 {}를 전달할 수 있습니다. |
|
| extend.notifyTypes | array | 알림 트리거 유형 배열입니다. issue.add=Issue 생성 알림, issue.modify=Issue 수정 알림, issueReply.add=답글 생성 알림, issueReply.modify=답글 수정 알림, issueReply.delete=답글 삭제 알림, issueUpgrade.noManager=담당자 없음 에스컬레이션 알림, issueUpgrade.processTimeout=처리 시간 초과 에스컬레이션으로 processTimeout 및 openProcessTimeout 두 항목을 제어합니다, issueUpgrade.eventStorm=연결된 이벤트 수가 임계값을 엄격히 초과한 후의 이벤트 스톰 알림, dailySummary=사이트 집계 작업에서 전송하는 일일 요약. null 허용: False 예시: ["issue.add", "issue.modify", "issueReply.add", "issueUpgrade.noManager", "issueUpgrade.processTimeout", "issueUpgrade.eventStorm"]획득 또는 입력 방법: 아래 실제 지원되는 이벤트 유형 중에서 선택하며, 필요한 유형의 문자열을 포함합니다. 생략하거나 []이면 이러한 동작을 활성화하지 않습니다. |
|
| extend.upgradeCfg | json | 네 가지 에스컬레이션 규칙 객체이며 각각 구성할 수 있습니다. 에스컬레이션 규칙이 없으면 생략하거나 {}를 사용합니다. null 허용: False 예시: {"noManager": {"duration": 600, "notifyType": "once"}, "processTimeout": {"duration": 1800, "notifyType": "cycle", "cycleDuration": 600, "cycleTimes": 3}, "openProcessTimeout": {"duration": 900, "notifyType": "once"}, "eventStorm": {"exceedTimes": 60, "notifyType": "once"}}획득 또는 입력 방법: 먼저 notifyTypes에서 해당 에스컬레이션 유형을 활성화한 다음 규칙을 입력합니다. 규칙만 입력하고 유형을 활성화하지 않으면 유효한 에스컬레이션 트리거가 생성되지 않습니다. |
|
| name | string | Y | 필수이며 비어 있지 않은 정책 이름입니다. 최대 256자이며 수정 시에도 제출해야 합니다. 빈 문자열 허용: False null 허용: False 최대 길이: 256 예시: 生产异常通知획득 또는 입력 방법: 알림 정책 목록에서 기존 정책 이름을 확인하고 현재 공간에서 사용되지 않는 이름을 선택합니다. |
| notificationScheduleUUIDs | array | 런타임 선언에서는 선택 사항입니다. 클라이언트가 생성할 때는 배열을 명시적으로 제출하세요. 스케줄이 없으면 []를 전달합니다. 생략하면 본문이 저장된 후 500이 반환될 수 있습니다. null 허용: False 예시: ["nsche_example"]획득 또는 입력 방법: 알림 스케줄 목록의 content.data[].uuid에서 동일 공간의 알림 스케줄을 가져옵니다. 하나의 정책에 여러 스케줄을 연결할 수 있습니다. |
파라미터 추가 설명¶
noManager는 담당자 없음 대기, processTimeout은 Open/Working 연속 처리 시간 초과, openProcessTimeout은 Open 상태 시간 초과만 해당합니다. 뒤의 두 항목은 모두 issueUpgrade.processTimeout으로 활성화됩니다. eventStorm은 대기 초 수가 아니라 연결된 이벤트 수 임계값을 사용합니다. 순환 규칙은 cycleDuration과 cycleTimes를 동시에 제공해야 하며, 필드가 누락되면 설정만 저장되고 유효한 규칙은 생성되지 않을 수 있습니다. 중첩 필드는 항목별로 엄격하게 검증되지 않으며, 잘못된 유형도 일반 내부 오류를 반환할 수 있습니다.
요청 예시¶
curl --request POST 'https://openapi.guance.com/api/v1/issue/notification_policy/add' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json' \
--data-raw '{"name":"生产异常通知","notificationScheduleUUIDs":["nsche_example"],"extend":{"notifyTypes":["issue.add","issue.modify","issueReply.add","issueUpgrade.noManager","issueUpgrade.processTimeout","issueUpgrade.eventStorm"],"upgradeCfg":{"noManager":{"duration":600,"notifyType":"once"},"processTimeout":{"duration":1800,"notifyType":"cycle","cycleDuration":600,"cycleTimes":3},"openProcessTimeout":{"duration":900,"notifyType":"once"},"eventStorm":{"exceedTimes":60,"notifyType":"once"}}}}'
응답¶
HTTP 200, application/json. 아래 예시는 바로 읽을 수 있는 주요 필드를 보여줍니다.
| 필드 | 유형 | 설명 |
|---|---|---|
| content.id | integer 또는 null | 정책 레코드 번호입니다. 생성 응답이 저장 전에 구성되는 경우 null일 수 있으며 작업에는 uuid를 사용합니다. |
| content.uuid | string | 알림 정책 UUID로 inpy_로 시작합니다. |
| content.workspaceUUID | string | 소속 워크스페이스 UUID입니다. |
| content.name | string | 정책 이름입니다. |
| content.status | integer | 레코드 상태입니다. 0 활성화, 2 비활성화, 3 삭제. 목록에는 삭제되지 않은 활성화 및 비활성화 정책이 포함됩니다. |
| content.creator | string | 생성 호출 주체입니다. |
| content.updator | string | 최근 업데이트 주체입니다. 업데이트되지 않은 경우 빈 문자열입니다. |
| content.createAt | integer | 생성 시간, Unix 초입니다. |
| content.updateAt | integer | 업데이트 시간, Unix 초입니다. 업데이트되지 않은 경우 -1입니다. |
| content.deleteAt | integer | 삭제 시간, Unix 초입니다. 삭제되지 않은 경우 -1입니다. |
| content.extend | object | 저장된 알림 범위 및 에스컬레이션 규칙입니다. {}일 수 있습니다. |
| content.extend.notifyTypes | array<string> |
활성화된 동작 유형입니다. |
| content.extend.notifyTypes[] | string | 단일 동작 유형입니다. 구체적인 역할은 파라미터 표를 참조하세요. |
| content.extend.upgradeCfg | object | 트리거 유형별로 저장된 규칙입니다. |
| content.extend.upgradeCfg.noManager | object | Issue 생성 시 유효한 담당자가 없어 담당자 없음 후보에 진입하고 상태가 Open/Working/Pending이면 Issue 생성 시점부터 대기합니다. 기존 Issue에서 담당자만 제거해도 후보에 다시 진입한다고 보장하지 않습니다. 양의 정수 초를 입력하며 60의 배수여야 합니다. 활성화 유형은 issueUpgrade.noManager이며 구성되지 않은 경우 생략됩니다. |
| content.extend.upgradeCfg.noManager.duration | integer | 최초 대기 시간(초)입니다. |
| content.extend.upgradeCfg.noManager.notifyType | string | once 또는 cycle이며, 이 값을 저장하지 않은 경우 once로 처리합니다. |
| content.extend.upgradeCfg.noManager.cycleDuration | integer | 순환 간격(초), cycle 모드에서 사용합니다. |
| content.extend.upgradeCfg.noManager.cycleTimes | integer | 순환 트리거 총 횟수 상한, 1~30, 최초 트리거 포함입니다. |
| content.extend.upgradeCfg.processTimeout | object | Issue가 Open/Working 상태에 있는 연속 미완료 시간입니다. 최초에는 생성 시점부터 시간을 측정하며, Pending/Resolved/Closed에서 처리 상태로 다시 진입하면 재진입 후 상태가 기록된 시점부터 시간을 측정합니다. 활성화 유형은 issueUpgrade.processTimeout이며 구성되지 않은 경우 생략됩니다. |
| content.extend.upgradeCfg.processTimeout.duration | integer | 최초 대기 시간(초)입니다. |
| content.extend.upgradeCfg.processTimeout.notifyType | string | once 또는 cycle이며, 이 값을 저장하지 않은 경우 once로 처리합니다. |
| content.extend.upgradeCfg.processTimeout.cycleDuration | integer | 순환 간격(초), cycle 모드에서 사용합니다. |
| content.extend.upgradeCfg.processTimeout.cycleTimes | integer | 순환 트리거 총 횟수 상한, 1~30, 최초 트리거 포함입니다. |
| content.extend.upgradeCfg.openProcessTimeout | object | Issue가 Open 상태를 유지할 때만 적용되며 마지막 상태 변경 시점부터 시간을 측정합니다. 상태 기록이 없으면 생성 시점부터 시간을 측정합니다. 활성화 유형은 issueUpgrade.processTimeout이며 구성되지 않은 경우 생략됩니다. |
| content.extend.upgradeCfg.openProcessTimeout.duration | integer | 최초 대기 시간(초)입니다. |
| content.extend.upgradeCfg.openProcessTimeout.notifyType | string | once 또는 cycle이며, 이 값을 저장하지 않은 경우 once로 처리합니다. |
| content.extend.upgradeCfg.openProcessTimeout.cycleDuration | integer | 순환 간격(초), cycle 모드에서 사용합니다. |
| content.extend.upgradeCfg.openProcessTimeout.cycleTimes | integer | 순환 트리거 총 횟수 상한, 1~30, 최초 트리거 포함입니다. |
| content.extend.upgradeCfg.eventStorm | object | Issue에 기록된 eventCount가 exceedTimes를 엄격히 초과하면 트리거됩니다. Open/Working 상태로 제한되지 않으며 완료된 Issue도 수량 조건을 충족할 수 있습니다. 활성화 유형은 issueUpgrade.eventStorm이며 구성되지 않은 경우 생략됩니다. |
| content.extend.upgradeCfg.eventStorm.exceedTimes | integer | 수량 임계값이며 eventCount가 엄격히 초과해야 트리거됩니다. |
| content.extend.upgradeCfg.eventStorm.notifyType | string | once 또는 cycle이며, 이 값을 저장하지 않은 경우 once로 처리합니다. |
| content.extend.upgradeCfg.eventStorm.cycleDuration | integer | 순환 간격(초), cycle 모드에서 사용합니다. |
| content.extend.upgradeCfg.eventStorm.cycleTimes | integer | 순환 트리거 총 횟수 상한, 1~30, 최초 트리거 포함입니다. |
| content.extend.기타 필드 | JSON | 소스에 저장된 기타 확장 필드이며, 모두 알림 동작을 제어할 수 있음을 의미하지는 않습니다. |
| content.notificationScheduleUUIDs | array<string> |
성공 시 연결된 스케줄 UUID 배열이며 연결이 없으면 []입니다. 생성 시 필드를 생략하면 500이 반환될 수 있으므로 성공적인 null 구조로 간주해서는 안 됩니다. |
| content.notificationScheduleUUIDs[] | string | 스케줄 UUID입니다. |
| content.declaration | object 또는 null | 워크스페이스 공통 선언입니다. |
{
"code": 200,
"content": {
"id": null,
"uuid": "inpy_example",
"workspaceUUID": "wksp_example",
"name": "生产异常通知",
"extend": {
"notifyTypes": [
"issue.add",
"issue.modify",
"issueReply.add",
"issueUpgrade.noManager",
"issueUpgrade.processTimeout",
"issueUpgrade.eventStorm"
],
"upgradeCfg": {
"noManager": {
"duration": 600,
"notifyType": "once"
},
"processTimeout": {
"duration": 1800,
"notifyType": "cycle",
"cycleDuration": 600,
"cycleTimes": 3
},
"openProcessTimeout": {
"duration": 900,
"notifyType": "once"
},
"eventStorm": {
"exceedTimes": 60,
"notifyType": "once"
}
}
},
"status": 0,
"creator": "wsak_example",
"updator": "",
"createAt": 1785430800,
"updateAt": -1,
"deleteAt": -1,
"notificationScheduleUUIDs": [
"nsche_example"
],
"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 파일 형식 오류 | 단일 JSON 객체를 제출합니다. |
| 400 | ft.PolicySameNameExists | 현재 공간에 동일 이름의 삭제되지 않은 정책(비활성화 정책 포함)이 있음 | 동일 이름의 알림 정책이 이미 존재함 | 사용되지 않은 이름을 선택합니다. 시간 초과 후 먼저 저장 여부를 확인합니다. |
| 400 | ft.InvalidFieldValue | notifyType이 once/cycle이 아니거나 cycleTimes가 1~30 범위를 벗어남 | 필드 {} 값: {}이(가) 유효하지 않습니다 | 규칙에 따라 notifyType 및 횟수를 입력합니다. 중첩 객체에는 올바른 유형을 사용하세요. |
| 400 | ft.UpgradeTimeTooLarge | 시간 유형 duration 중 하나라도 31622400초 초과 | 에스컬레이션 시간 설정이 너무 큽니다. 적절한 에스컬레이션 트리거 시간을 설정하세요 | 대기 시간을 줄이세요. 최대 31622400초입니다. |
| 400 | ft.InvalidUpgradeTimeDuration | 시간 유형 duration이 60초의 정수 배가 아님 | 에스컬레이션 시간 설정은 60(s)의 양의 정수 배여야 합니다 | 양의 정수 분에 60을 곱한 초 값을 사용합니다. |
| 400 | ft.exceedTimesTooLarge | eventStorm.exceedTimes가 31622400 초과 | 연결된 이벤트 트리거 횟수가 너무 큽니다. 적절한 트리거 횟수를 설정하세요 | 31622400을 초과하지 않는 양의 정수 이벤트 수 임계값을 사용합니다. |
| 500 | ft.InternalServerError | notificationScheduleUUIDs 생략 또는 관계 저장, 에스컬레이션 규칙 처리 등 내부 실패. 정책 본문이 이미 저장되었을 수 있음 | 내부 오류 | 먼저 정책 목록에서 동일 이름 레코드가 생성되었는지 확인합니다. 생성 요청에 notificationScheduleUUIDs 배열을 명시적으로 제공한 다음 재시도 여부를 결정합니다. |