콘텐츠로 이동

수정



POST /api/v1/issue/notification_policy/{issue_notification_policy_uuid}/modify

개요

알림 정책의 알림 범위, 연결된 일정 및 에스컬레이션 설정을 전체 업데이트합니다.

호출 전 및 사용 단계

수정 시 전체 대상 name, 일정 UUID 배열 및 extend를 제출해야 하며, 일정 관계와 extend는 전체 교체됩니다. notificationScheduleUUIDs를 생략하면 일정이 비워지고, extend를 생략하면 알림 범위와 규칙이 비워집니다. 파라미터 표의 notification_schedule_uuid는 레거시 경로 이름이며, 여기에 입력하는 값은 URL의 실제 issue_notification_policy_uuid에 대응하는 동일한 정책 UUID입니다. 일정 UUID도 아니고 별도의 Query 파라미터도 아닙니다. 정책은 콘솔에서 대상 채널에 연결해야 하며 유효한 알림 일정에도 연결해야 합니다. 실제 수신자는 일정의 시간대, 당일 시간대, 유효 기간, 교대 및 알림 대상에 의해 결정됩니다. 정책 저장 자체로 테스트 알림이 즉시 전송되지는 않습니다. 에스컬레이션은 사이트 스케줄 작업에서 확인하며 정확한 카운트다운이 아닙니다. 트리거 설정이 생성되거나 업데이트된 후 새로 생성된 Issue만 확인합니다. 일정에 당시 유효한 대상이 없어도 트리거가 한 번 기록될 수 있으므로, 트리거 횟수를 전달 횟수로 간주해서는 안 됩니다. 알림 대상과 실제 메시지를 함께 확인하십시오. 정책 본문, 연결 관계 및 에스컬레이션 트리거 설정은 단계별로 저장됩니다. 실패 또는 시간 초과 후에는 먼저 상세 정보를 조회하여 기존 변경 사항을 확인한 뒤 재시도 여부를 결정하십시오. 현재 버전에서는 기존 정책에 noManager/processTimeout/openProcessTimeout 시간형 규칙을 새로 추가하고 해당 유형에 이전에 트리거 설정이 없었던 경우에만 트리거 설정 저장이 실패할 수 있으며, 정책 본문은 이미 저장되었을 수 있습니다. 기존 동일 유형 설정 업데이트와 eventStorm 신규 추가는 이 조건에 해당하지 않으므로, 실패 후에는 상세 정보를 조회하여 실제 트리거 효과를 확인해야 합니다.

경로 파라미터

파라미터 이름 유형 필수 설명
notification_schedule_uuid string Y 경로의 알림 정책 UUID입니다. 일정 UUID가 아니며 별도의 Query를 전달하지 않습니다.
예시: inpy_example
가져오기 또는 입력 방법: 알림 정책 목록에서 정책 UUID를 가져옵니다. 이 이름은 레거시 선언일 뿐이며 실제 URL의 issue_notification_policy_uuid에 대응합니다.

요청 헤더

파라미터 이름 유형 필수 설명
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 전체 대상 일정 UUID 배열입니다. 생략하거나 []이면 모든 일정 연결을 비웁니다.
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/inpy_example/modify' \
  -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": 42,
    "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": "wsak_example",
    "createAt": 1785430800,
    "updateAt": 1785430860,
    "deleteAt": -1,
    "notificationScheduleUUIDs": [
      "nsche_example"
    ],
    "declaration": {}
  },
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-EXAMPLE"
}

오류 응답

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

HTTP 상태 errorCode 트리거 조건 메시지 또는 응답 설명 처리 방법
404 ft.ObjectNotExists 정책이 존재하지 않거나, 삭제되었거나, 현재 API Key 워크스페이스에 속하지 않음 지정한 객체가 존재하지 않습니다 알림 정책 목록에서 현재 워크스페이스의 UUID를 다시 가져옵니다.
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 배열을 명시적으로 제공한 후 재시도 여부를 결정합니다.

문서 평가

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