콘텐츠로 이동

생성



POST /api/v1/monitor/mute/create

개요

현재 워크스페이스에 이벤트 알림 음소거 규칙을 생성하며, 단일 유지보수 기간과 시간대 기준 반복 기간을 지원합니다.

호출 전 및 사용 단계

실제 범위를 확인한 후 전체 설정을 제출합니다: custom은 이벤트 조건을, checker는 모니터/SLO 식별자를, alertPolicy는 알림 정책 식별자를, tag는 모니터 태그 식별자를 사용합니다. 범위와 이벤트 조건이 함께 음소거 대상을 제한합니다.

단일 실행은 repeatTimeSet=0을 사용하며 유한한 startTime/endTime을 명시적으로 제공하는 것이 좋습니다. 반복은 1을 사용하고 startTime, repeatCrontabSet의 5개 필드, 양수 crontabDuration, repeatExpireTime을 모두 제공합니다. 영구 반복은 문자열 "0"을 전달합니다. 마감 값을 생략해도 자동으로 영구 반복이 되지 않습니다.

규칙은 매칭된 이벤트의 알림 음소거를 제어하며, 이벤트 및 모니터링 데이터는 기존 프로세스에 따라 계속 처리됩니다. muteIncident는 인시던트 알림 확장 기능이며 현재 공개 쓰기 파라미터에는 포함되어 있지 않습니다. 조정이 필요하면 콘솔에서 작업하세요. 내부 파라미터를 공개 요청 필드로 제출하지 마세요.

저장 후 비동기 작업을 통해 실행 캐시 및 규칙 알림을 업데이트합니다. 성공이 즉시 동기화 완료 또는 메시지 전달 완료를 의미하지는 않습니다. 현재 활성 규칙을 수정하면 설정된 대상에 다시 알림이 발송될 수 있으며, 새로 추가된 대상에만 알림이 발송된다는 보장은 없습니다. 실패 후에는 먼저 규칙과 적용 상태를 확인하세요.

notifyTargets가 비어 있으면 규칙 설정 알림을 보내지 않습니다. 유효한 대상을 설정할 때는 notifyMessage도 반드시 함께 제공해야 합니다. notifyTimeStr이 비어 있으면 즉시 알림 의도를 나타내며, 발송 여부는 작업 시간대와 상태에 따라 제한됩니다. 종료가 없는 단일 규칙 실행은 유효할 수 있지만, 현재 설정 알림 작업은 이를 이미 종료된 것으로 간주합니다.

요청 헤더

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

Body 요청 파라미터

파라미터명 타입 필수 설명
muteRanges[*] json 단일 범위 객체이며, 매칭은 UUID 필드로 결정되고 name/type은 표시 정보입니다. 일반적으로 한 항목에는 하나의 리소스 키만 입력합니다.
예: {"checkerUUID": "rul_example", "name": "프로덕션 API 모니터링"}
가져오기 또는 입력 방법: 동일한 워크스페이스의 모니터/SLO, 알림 정책 또는 모니터 태그 관리에서 해당 UUID를 가져옵니다. 표시 이름을 안정적인 식별자 대신 사용하지 마세요.
muteRanges[*].checkerUUID string 모니터 UUID이며 checker 범위에서 주로 사용합니다.
예: rul_example
가져오기 또는 입력 방법: 이 워크스페이스의 모니터, 지능형 모니터링 또는 지능형 점검 설정에서 rul_ UUID를 가져옵니다.
muteRanges[*].sloUUID string SLO 식별자이며, 실행 시 해당 SLO 탐지 모니터로 매핑됩니다. 유효한 탐지 관계가 없으면 적용이 보장되지 않습니다.
예: monitor_example
가져오기 또는 입력 방법: 이 워크스페이스의 SLO 목록에서 monitor_ UUID를 가져옵니다.
muteRanges[*].alertPolicyUUID string 알림 정책 식별자이며 alertPolicy 범위에서 사용합니다.
예: altpl_example
가져오기 또는 입력 방법: 알림 정책 목록의 content.data[].uuid에서 가져옵니다.
muteRanges[*].tagUUID string 모니터 태그 식별자이며, 실행 시 태그 이름으로 이벤트 df_label을 매칭합니다.
예: tag_example
가져오기 또는 입력 방법: 모니터 태그 관리에서 태그 UUID를 가져옵니다. 임의의 이벤트 필드 값이 아닙니다.
muteRanges[*].name string 클라이언트 표시 이름이며 UUID를 대체하지 않습니다.
예: 프로덕션 API 모니터링
가져오기 또는 입력 방법: 해당 리소스의 표시 이름을 사용하며 생략할 수 있습니다.
muteRanges[*].type string 표시용 타입이며, 실제 범위 의미는 최상위 type과 UUID 필드로 결정됩니다.
예: 모니터
가져오기 또는 입력 방법: 클라이언트 필요에 따라 리소스의 표시 타입을 유지하며 생략할 수 있습니다.
tags.字段 array 해당 필드에 매칭할 실제 값 배열입니다.
예: ["production"]
가져오기 또는 입력 방법: 키에는 실제 이벤트 필드(예: env)를 사용하고, 값은 배열로 입력하는 것이 좋습니다.
tags.字段[*] string 단일 매칭 값이며 실제 데이터 타입에 따라 선택합니다.
예: production
가져오기 또는 입력 방법: 이벤트에서 동일한 필드의 값을 가져옵니다.
notifyTargets[*] json 단일 알림 대상 그룹이며 type과 to를 사용합니다.
예: {"type": "mail", "to": ["acnt_example"]}
가져오기 또는 입력 방법: 계정은 워크스페이스 멤버에서 acnt_ UUID를, 팀은 이 워크스페이스의 팀 관리에서 group_ UUID를, 알림 대상은 알림 대상 목록에서 notify_ UUID를 가져옵니다.
notifyTargets[*].type string 알림 대상 타입이며, 실행 작업이 지원하는 mail/notifyObject/memberGroup 중에서 선택합니다. 알 수 없는 타입은 저장될 수 있지만 유효한 알림을 생성하지 않을 수 있습니다.
예: mail
가져오기 또는 입력 방법: 이메일 계정은 mail, 알림 대상은 notifyObject, 팀 이메일은 memberGroup을 사용합니다.
notifyTargets[*].to array mail에는 계정 UUID, notifyObject에는 알림 대상 UUID, memberGroup에는 팀 UUID를 넣습니다. 동일한 워크스페이스의 유효한 리소스만 제출하세요.
예: ["acnt_example"]
가져오기 또는 입력 방법: 계정은 워크스페이스 멤버에서 acnt_ UUID를, 팀은 이 워크스페이스의 팀 관리에서 group_ UUID를, 알림 대상은 알림 대상 목록에서 notify_ UUID를 가져옵니다.
notifyTargets[*].to[*] string 해당 타입의 단일 UUID이며, 이메일 주소를 계정 UUID로 직접 사용하지 마세요.
예: acnt_example
가져오기 또는 입력 방법: 계정은 워크스페이스 멤버에서 acnt_ UUID를, 팀은 이 워크스페이스의 팀 관리에서 group_ UUID를, 알림 대상은 알림 대상 목록에서 notify_ UUID를 가져옵니다.
declaration.自定义字段 JSON 사용자 정의 선언 내용이며 규칙 매칭이나 권한 부여를 변경하지 않습니다.
예: MAINT-EXAMPLE
가져오기 또는 입력 방법: 비즈니스 정의에 따라 필드 이름과 값을 지정합니다.
crontabDuration int 반복 모드에서 조건부 필수이며 0보다 커야 합니다. 단일 모드에서는 endTime을 제어하지 않습니다.
null 허용: False
예: 3600
가져오기 또는 입력 방법: 각 음소거 기간의 지속 시간을 양의 정수 초로 입력합니다. 예를 들어 3600은 1시간입니다.
declaration json 선택적 규칙 사용자 정의 선언 객체입니다. 수정 시 생략하면 유지되고, {}는 비웁니다. 단일 규칙 응답의 content.declaration이 이 필드이며, 더 이상 워크스페이스 공통 선언으로 덮어쓰이지 않습니다.
null 허용: False
예: {"ticket": "MAINT-EXAMPLE"}
가져오기 또는 입력 방법: 호출자가 보존해야 하는 규칙 사용자 정의 설명 또는 비즈니스 추적 식별자를 입력합니다.
description string 선택적 설명이며 512자 이내를 권장합니다. 수정 시 생략하면 유지되고, 빈 문자열은 비웁니다.
빈 문자열 허용: True
null 허용: False
예: 프로덕션 서비스 유지보수 기간.
가져오기 또는 입력 방법: 유지보수 사유와 영향 범위를 설명합니다.
endTime string 단일 종료 시각입니다. 생성 시 생략하거나 빈 문자열로 저장하면 end=-1이 되어 종료를 설정하지 않음을 나타냅니다. 수정 시 생략하면 유지되지만, 현재 빈 문자열을 전달하면 내부 오류가 반환될 수 있습니다. 단일 규칙에는 유한한 종료 시간을 명시적으로 입력하는 것이 좋습니다.
빈 문자열 허용: True
null 허용: False
예: 2026/11/20 10:00:00
가져오기 또는 입력 방법: 단일 규칙의 실제 종료 시각을 startTime보다 늦게 입력합니다.
filterString string 선택적 이벤트 속성 조건이며, 선언 최대 길이는 2048자이지만 현재 저장 용량이 더 짧으므로 1024자 이내를 권장합니다. 비어 있지 않으면 tags보다 우선합니다. 수정 시 생략하면 유지되고, 빈 문자열은 비웁니다.
빈 문자열 허용: True
null 허용: False
최대 길이: 2048
예: service:checkout-api
가져오기 또는 입력 방법: FilterString 구문에 따라 입력하며, 콘솔의 이벤트 필터에서 복사할 수 있습니다.
muteRanges array 전체 범위 배열이며, 생성 시 생략하면 []입니다. 수정 시 생략해도 기존 범위가 비워집니다. 각 항목에는 타입에 맞는 UUID를 입력합니다. custom 범위, tags, filterString이 모두 비어 있으면 워크스페이스 전체의 이벤트 알림이 음소거될 수 있으므로 발송 전에 실제 범위를 확인하세요.
null 허용: False
예: []
가져오기 또는 입력 방법: 동일한 워크스페이스의 모니터/SLO, 알림 정책 또는 모니터 태그 관리에서 해당 UUID를 가져옵니다. 표시 이름을 안정적인 식별자 대신 사용하지 마세요.
name string 규칙 이름이며 생성 및 수정 시 명시적으로 제공하는 것이 좋습니다. 생성 시 생략하면 범위/태그/조건에 따라 짧은 이름이 생성될 수 있고, 수정 시 생략하면 원래 이름이 유지됩니다.
null 허용: False
예: 프로덕션 유지보수 음소거
가져오기 또는 입력 방법: 비즈니스 담당자가 유지보수 기간의 이름을 지정하며 64자 이내를 권장합니다.
notifyMessage string 선택적 알림 본문이며 최대 3000자입니다. 생성 시 notifyTargets의 모든 항목에 비어 있지 않은 to가 있으면 비어 있지 않은 내용을 반드시 제공해야 합니다. 수정 시에는 대상과 내용의 완전성을 직접 보장해야 합니다.
null 허용: False
최대 길이: 3000
예: 프로덕션 유지보수 음소거 기간이 설정되었습니다.
가져오기 또는 입력 방법: 음소거 규칙의 알림 내용을 입력하며 민감한 자격 증명을 포함하지 마세요.
notifyTargets array 선택적 규칙 설정 알림 대상이며, 음소거 규칙 자체의 알림에 적용되고 음소거된 알림의 수신자가 아닙니다. 수정 시 전달하면 전체 대체, []는 제거, 생략하면 유지됩니다.
null 허용: False
예: []
가져오기 또는 입력 방법: 계정은 워크스페이스 멤버에서 acnt_ UUID를, 팀은 이 워크스페이스의 팀 관리에서 group_ UUID를, 알림 대상은 알림 대상 목록에서 notify_ UUID를 가져옵니다.
notifyTimeStr string 선택적 알림 시각입니다. 생성 시 생략하거나 빈 문자열이면 즉시 알림 의도로 처리되고, 수정 시 생략하면 유지되며 빈 문자열이면 즉시 의도로 변경됩니다. 실제 발송은 유효한 대상, 규칙 상태 및 시간에 따라 달라집니다. 알림 취소 스위치는 아닙니다. 반복 규칙은 시작 시간과의 사전 간격에 따라 각 주기에서 알림을 보낼 수 있습니다.
빈 문자열 허용: True
null 허용: False
예:
가져오기 또는 입력 방법: 규칙 timezone에 따라 YYYY/MM/DD HH:MM:SS 형식으로 입력합니다.
repeatCrontabSet object 반복 모드에서 조건부 필수인 5개 필드 Cron 객체이며, 단일 모드에서는 생략합니다. 공개 선언에는 객체 타입이 없으므로 문서는 실제 객체를 기준으로 설명합니다. 필드가 누락되면 유효하지 않은 Cron이 조합될 수 있습니다.
null 허용: False
예: {"min": "0", "hour": "9", "day": "*", "month": "*", "week": "1-5"}
가져오기 또는 입력 방법: 반복 모드에서는 규칙 timezone에 따라 시작 주기를 선택하고 아래 5개 문자열 필드를 모두 제출합니다.
repeatCrontabSet.day string 반복 시 이 필드 문자열을 제출합니다: 월 내 날짜, 1-31 또는 *. 5개 필드는 직접 연결되며 실행 가능한 시점이 있는지 검증합니다.
null 허용: False
예: *
가져오기 또는 입력 방법: Cron 구문에 따라 선택하며, 예를 들어 *는 모든 값, 쉼표/범위는 여러 시점을 나타냅니다.
repeatCrontabSet.hour string 반복 시 이 필드 문자열을 제출합니다: 시간, 0-23. 5개 필드는 직접 연결되며 실행 가능한 시점이 있는지 검증합니다.
null 허용: False
예: 9
가져오기 또는 입력 방법: Cron 구문에 따라 선택하며, 예를 들어 *는 모든 값, 쉼표/범위는 여러 시점을 나타냅니다.
repeatCrontabSet.min string 반복 시 이 필드 문자열을 제출합니다: 분, 0-59. 5개 필드는 직접 연결되며 실행 가능한 시점이 있는지 검증합니다.
null 허용: False
예: 0
가져오기 또는 입력 방법: Cron 구문에 따라 선택하며, 예를 들어 *는 모든 값, 쉼표/범위는 여러 시점을 나타냅니다.
repeatCrontabSet.month string 반복 시 이 필드 문자열을 제출합니다: 월, 1-12 또는 *. 5개 필드는 직접 연결되며 실행 가능한 시점이 있는지 검증합니다.
null 허용: False
예: *
가져오기 또는 입력 방법: Cron 구문에 따라 선택하며, 예를 들어 *는 모든 값, 쉼표/범위는 여러 시점을 나타냅니다.
repeatCrontabSet.week string 반복 시 이 필드 문자열을 제출합니다: 요일, Cron 요일 필드 또는 *. 5개 필드는 직접 연결되며 실행 가능한 시점이 있는지 검증합니다.
null 허용: False
예: 1-5
가져오기 또는 입력 방법: Cron 구문에 따라 선택하며, 예를 들어 *는 모든 값, 쉼표/범위는 여러 시점을 나타냅니다.
repeatExpireTime string 반복 모드에서는 0 또는 유효한 마감 날짜를 명시적으로 제공해야 하며, 생략/빈 문자열은 영구 반복과 같지 않습니다. -1은 단일 내부 표식입니다. 반복을 생성하면서 생략하면 단일로 처리될 수 있고, 반복 수정 시 생략하면 내부 오류가 발생할 수 있습니다.
빈 문자열 허용: True
null 허용: False
예: 0
가져오기 또는 입력 방법: 영구 주기는 문자열 0을 입력하고, 유한 주기는 timezone 기준 YYYY/MM/DD HH:MM:SS를 입력하며 시작 시간보다 늦어야 합니다.
repeatTimeSet int Y 필수 반복 모드입니다. 실제 저장은 repeatExpire/crontab으로 표현되며, 응답에서 repeatTimeSet이 고정적으로 반환되지는 않습니다.
null 허용: False
예: 0
가져오기 또는 입력 방법: 한 번만 실행하면 0, 주기 반복이면 1을 입력합니다. 이 두 약속된 값만 사용하세요.
startTime string 시작 시간, YYYY/MM/DD HH:MM:SS. 생성 시 생략하면 현재 시각을 사용합니다. 단일 규칙 수정 시 생략하면 유지되며, 반복으로 수정할 때는 명시적으로 제공해야 합니다.
null 허용: False
예: 2026/11/20 09:00:00
가져오기 또는 입력 방법: 유지보수 기간 시작 시각과 선택한 timezone에 따라 로컬 시간 문자열을 입력합니다.
tags json 선택적 필드 값 조건입니다. 수정 시 생략하면 기존 tags가 비워집니다. 비어 있지 않은 filterString이 tags보다 우선하지만 muteRanges와는 계속 중첩 적용됩니다.
null 허용: False
예: {"env": ["production"]}
가져오기 또는 입력 방법: 이벤트 원본 필드 이름과 값(예: env, host, service 등)으로 구성합니다.
timezone str Y 생성/수정 시 필수 시간대이며, 로컬 시간 파싱 및 Cron 실행을 제어합니다. 유효하지 않은 시간대나 시간 문자열은 일반 내부 오류를 반환할 수 있습니다.
null 허용: False
예: Asia/Shanghai
가져오기 또는 입력 방법: IANA 시간대를 사용합니다. 예: Asia/Shanghai, UTC. 시간 텍스트는 해당 시간대로 해석됩니다.
type str Y 필수 타입입니다. custom은 사용자 정의 이벤트 범위, checker는 모니터/SLO, alertPolicy는 알림 정책, tag는 모니터 태그입니다. 이전 목록에는 monitor가 나타날 수 있지만 현재 공개 쓰기에서는 이 열거형을 허용하지 않습니다.
null 허용: False
선택 가능한 값: ['checker', 'alertPolicy', 'tag', 'custom']
예: custom
가져오기 또는 입력 방법: 음소거 범위에 따라 custom/checker/alertPolicy/tag를 선택합니다.

추가 파라미터 설명

반복 기간 요청 예시:

curl --request POST '<Endpoint>/api/v1/monitor/mute/create' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  -H 'Content-Type: application/json' \
  --data-raw '{"name":"프로덕션 유지보수 음소거","description":"프로덕션 서비스 유지보수 기간.","type":"custom","muteRanges":[],"tags":{},"filterString":"service:checkout-api","notifyTargets":[],"repeatTimeSet":1,"timezone":"Asia/Shanghai","startTime":"2026/11/20 09:00:00","repeatCrontabSet":{"min":"0","hour":"9","day":"*","month":"*","week":"1-5"},"crontabDuration":3600,"repeatExpireTime":"0"}'

요청 예시

curl --request POST 'https://openapi.guance.com/api/v1/monitor/mute/create' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  -H 'Content-Type: application/json' \
  --data-raw '{"name":"프로덕션 유지보수 음소거","description":"프로덕션 서비스 유지보수 기간.","type":"custom","muteRanges":[],"tags":{},"filterString":"service:checkout-api","notifyTargets":[],"repeatTimeSet":0,"timezone":"Asia/Shanghai","startTime":"2026/11/20 09:00:00","endTime":"2026/11/20 10:00:00"}'

응답

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

필드 타입 설명
content object 저장된 전체 규칙 엔터티 및 포맷된 시간입니다. 기존 규칙 declaration이 있으면 공통 선언을 추가로 삽입하지 않습니다.
content.id integer 규칙 레코드 번호이며 작업에는 uuid를 사용합니다.
content.uuid string mute_ 규칙 UUID.
content.workspaceUUID string 소속 워크스페이스.
content.name string 규칙 이름.
content.description string 설명.
content.type string custom/checker/alertPolicy/tag이며, 이전 레코드에는 monitor가 나타날 수 있습니다.
content.tags object 저장된 필드 값 조건.
content.tags.字段 JSON 해당 이벤트 필드의 매칭 값입니다.
content.filterString string 이벤트 속성 조건이며, 비어 있지 않으면 tags보다 우선합니다.
content.muteRanges array<object> 저장된 범위 배열이며, 각 UUID의 의미는 요청 파라미터를 참조하세요.
content.muteRanges[].checkerUUID string 또는 array 모니터 식별자이며, 이전 레코드에서는 배열일 수 있습니다.
content.muteRanges[].sloUUID string 또는 array SLO 식별자이며, 이전 레코드에서는 배열일 수 있습니다.
content.muteRanges[].alertPolicyUUID string 알림 정책 UUID.
content.muteRanges[].tagUUID string 또는 array 모니터 태그 UUID.
content.muteRanges[].name string 표시 이름이며 생략할 수 있습니다.
content.muteRanges[].type string 표시 타입이며 생략할 수 있습니다.
content.notifyTargets array<object> 음소거 규칙 알림 대상.
content.notifyTargets[].type string mail/notifyObject/memberGroup.
content.notifyTargets[].to array<string> 해당 타입의 UUID 배열입니다.
content.notifyTargets[].to[] string 단일 대상 UUID.
content.notifyMessage string 음소거 규칙 알림 본문.
content.notifyTime integer 알림 시간(Unix 초)이며 -1은 즉시 의도를 나타내고, 실제 발송 여부는 작업이 판단합니다.
content.notifyTimeStr string timezone에 따라 포맷된 알림 시각이며, 즉시 의도인 경우 빈 문자열입니다.
content.start integer 시작 Unix 초.
content.end integer 단일 종료 Unix 초이며 -1은 종료 없음입니다.
content.startTime string timezone 기준 YYYY/MM/DD HH:MM:SS입니다.
content.endTime string 동일 형식의 종료 시간이며 end=-1이면 빈 문자열입니다.
content.repeatExpire integer -1은 단일, 0은 영구 반복, 양수는 주기 마감 Unix 초입니다.
content.repeatExpireTime string -1/0 또는 timezone 기준으로 포맷된 마감 시간입니다.
content.crontab string 반복 시 5개 필드 Cron 문자열이며, 단일 실행에서는 일반적으로 비어 있습니다.
content.crontabDuration integer 각 반복 기간의 지속 시간(초)입니다.
content.cycleNotifyAt integer 가장 최근 주기 설정 알림 시각(Unix 초)이며, 아직 알림이 없으면 -1입니다.
content.timezone string 규칙 시간대.
content.declaration object 규칙 사용자 정의 선언이며, 이 워크스페이스의 공통 선언이 아닙니다.
content.declaration.自定义字段 JSON 호출자가 저장한 사용자 정의 값입니다.
content.muteIncident boolean 인시던트 알림도 함께 음소거할지 여부입니다. 현재 OpenAPI에는 이 쓰기 파라미터가 선언되어 있지 않으며, 생성 시 기본값은 false이고 기존 규칙은 콘솔 설정을 반영할 수 있습니다. alertPolicy 범위는 이 인시던트 매칭을 지원하지 않습니다.
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.repeatCrontabSet object 목록 및 반복 규칙 생성 시 제공되는 Cron 역파싱 객체이며, 수정 응답에서는 고정적으로 제공되지 않습니다.
content.repeatCrontabSet.min string 해당 Cron 세그먼트.
content.repeatCrontabSet.hour string 해당 Cron 세그먼트.
content.repeatCrontabSet.day string 해당 Cron 세그먼트.
content.repeatCrontabSet.month string 해당 Cron 세그먼트.
content.repeatCrontabSet.week string 해당 Cron 세그먼트.
{
  "code": 200,
  "content": {
    "id": 42,
    "uuid": "mute_example",
    "workspaceUUID": "wksp_example",
    "name": "프로덕션 유지보수 음소거",
    "description": "프로덕션 서비스 유지보수 기간.",
    "type": "custom",
    "tags": {},
    "filterString": "service:checkout-api",
    "muteRanges": [],
    "notifyTargets": [],
    "notifyMessage": "",
    "notifyTime": -1,
    "start": 1795136400,
    "end": 1795140000,
    "repeatExpire": -1,
    "cycleNotifyAt": -1,
    "crontab": "",
    "crontabDuration": 0,
    "declaration": {},
    "muteIncident": false,
    "timezone": "Asia/Shanghai",
    "status": 0,
    "creator": "wsak_example",
    "updator": "",
    "createAt": 1785430800,
    "updateAt": -1,
    "deleteAt": -1,
    "startTime": "2026/11/20 09:00:00",
    "endTime": "2026/11/20 10:00:00",
    "notifyTimeStr": "",
    "repeatExpireTime": "-1"
  },
  "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.muteStartEndError 단일 종료가 시작보다 늦지 않음, 또는 반복 crontabDuration이 0보다 크지 않음 음소거 시작 시간은 음소거 종료 시간보다 작아야 합니다 순서를 조정하고 반복 기간에는 양수 초를 제공하세요.
406 ft.InvalidCrontabFormat Cron을 파싱할 수 없거나 실행 가능한 시점이 없거나 시간대로 인해 스케줄 검사가 실패함 유효하지 않은 crontab 형식 5개 Cron 문자열 필드와 올바른 timezone을 완전히 제출하세요.
400 ft.ErrorFilterString 이벤트 속성 조건을 파싱할 수 없음 filterString 파싱 실패: {} 콘솔에서 생성한 유효한 FilterString을 사용하거나 예시에 따라 수정하세요.
406 ft.ExceedTimestampLimit 음소거 시작/종료/반복 마감 Unix 초가 2147483647을 초과함 시간이 2038-01-19 제한을 초과 해당 시각을 2038-01-19 상한 이전으로 제한하고 밀리초를 초로 착각하지 마세요.
500 ft.InternalServerError 반복 모드 필수 필드 누락, 시간/시간대 형식 오류, 배열 요소 형태 오류, 또는 저장/작업 처리 실패 내부 오류 단일/반복 전체 조건에 따라 자체 점검하고, 먼저 저장된 규칙을 확인한 후 재시도 여부를 결정하세요. 계속 실패하면 traceId를 제공하세요.
406 ft.InvalidEventData 반복 규칙 생성 시 repeatExpireTime에서 변환된 양수 Unix 초가 10/13/16자리가 아니어서 시간 정규화 실패 유효하지 않은 이벤트 데이터 정상적으로 표현 가능한 유지보수 날짜를 사용하고 양수 Unix 초 길이를 확인하세요. 이 분기는 반복 규칙 생성 시에만 발생합니다.
406 ft.MissingNotifyMessage 생성 시 알림 대상에 비어 있지 않은 to가 있지만 notifyMessage가 비어 있음 알림 대상을 선택한 경우 알림 내용을 입력해야 합니다 알림 본문을 제공하거나 대상 배열을 비우세요.

문서 평가

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