생성¶
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가 비어 있음 | 알림 대상을 선택한 경우 알림 내용을 입력해야 합니다 | 알림 본문을 제공하거나 대상 배열을 비우세요. |