콘텐츠로 이동

수정 v2



POST /api/v1/alert_policy/{alert_policy_uuid}/modify_v2

개요

알림 정책을 수정하고 모니터/SLO/보안 규칙 바인딩을 완전하게 유지합니다.

호출 전 및 사용 단계

먼저 상세 정보를 읽고 전체 대상 alertOpt로 교체합니다. alertOpt를 생략하면 원래 구성을 유지하고, {}를 전달하면 해당 객체를 비웁니다. 심층 검증을 트리거하려면 기존 name, 필수 ruleTimezone 및 전체 alertOpt를 함께 제출하는 것이 좋습니다. 순수 알림 구성 수정은 현재 코드에서 심층 검증을 건너뛸 수 있으므로 성공이 대상 구조의 실행 가능성을 보장하지 않습니다. v2는 동시에 바인딩을 유지합니다. 수정 시 checkerUUIDs와 securityRuleUUIDs는 모두 전체 대상 집합을 의미하며, 어느 하나라도 생략하면 해당 바인딩을 []로 비웁니다. 유지하려면 먼저 상세 정보를 조회하고 전체를 그대로 반환해야 합니다. 클라이언트는 동일 워크스페이스의 모니터/SLO/보안 규칙을 항목별로 검증해야 합니다. 서버는 존재하지 않는 식별자를 필터링할 수 있지만 모든 UUID의 워크스페이스 소속을 완전히 검증하지는 않으므로, 성공이 바인딩의 유효성을 증명하지 않으며 항목별 확인도 제공하지 않습니다. 현재 버전에서는 최상위 ruleTimezone이 저장되고 표시되지만, 실행 캐시는 이전 alertOpt.ruleTimezone을 읽으며 기본값은 Asia/Shanghai입니다. 다른 시간대는 저장 성공만으로 적용되었다고 판단할 수 없으며, 연동 측은 실제 실행 시간대로 검증해야 합니다. 선언되지 않은 추가 필드로 공개 파라미터를 우회하지 마십시오. 저장 및 캐시 새로고침은 알림 전달을 의미하지 않으며, 실제 전송은 유효한 대상, 이벤트 등급, 시간대, 필터, 중복 억제 및 알림 실행 서비스에 의존합니다. 실패 또는 타임아웃 후에는 먼저 정책 및 바인딩 상태를 읽어 중복 생성이나 부분 업데이트 오판을 피하십시오.

라우트 파라미터

파라미터명 유형 필수 설명
alert_policy_uuid string Y 현재 워크스페이스 알림 정책 UUID입니다.
예: altpl_example
가져오거나 입력하는 방법: 알림 정책 목록의 content.data[].uuid에서 가져오고, 수정 전에 알림 정책 상세로 확인합니다.

요청 헤더

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

Body 요청 파라미터

파라미터명 유형 필수 설명
permissionSet[*] string 단일 작업 가능 주체 식별자입니다. 적용 여부는 ID 및 리소스의 현재 상태에 따라 달라집니다.
예: wsAdmin
가져오거나 입력하는 방법: 역할 UUID(예: wsAdmin/general/readOnly/role_), acnt_ 계정 또는 group_ 팀을 사용합니다. 계정/팀은 이 워크스페이스의 실제 리소스를 기준으로 합니다.
alertOpt.silentTimeoutByStatus[*] json 등급별 간격 객체입니다.
예: {"status": "critical,error", "silentTimeout": 600}
가져오거나 입력하는 방법: 각 항목은 등급 집합과 해당 초 수를 정의합니다.
alertOpt.silentTimeoutByStatus[*].status string 비보안에서는 fatal/critical/error/warning/nodata/info/ALL을 사용할 수 있고, 보안에서는 security_critical/security_high/security_medium/security_low/security_info/security_ALL을 사용합니다. 여러 개는 영문 쉼표로 연결하며 공백을 넣지 않습니다.
예: critical,error
가져오거나 입력하는 방법: 이벤트 등급에서 선택합니다. 보안 등급은 security_ 접두사를 사용합니다(예: security_high).
alertOpt.silentTimeoutByStatus[*].silentTimeout integer 각 그룹에 필수인 반복 간격이며 단위는 초입니다. 잘못된 등급은 내부 오류를 유발할 수 있으므로 전송 전에 검증하십시오.
예: 600
가져오거나 입력하는 방법: 해당 등급의 음이 아닌 정수 초를 입력하며, 0은 더 이상 주기적으로 반복하지 않음을 의미합니다.
alertOpt.aggFields[*] string 단일 집계 필드입니다. byCustom은 실제 이벤트 필드를 기준으로 선택하며 표시 이름만으로 필드를 추측하지 마십시오.
예: df_monitor_checker_id
가져오거나 입력하는 방법: 이벤트 모니터는 df_monitor_checker_id, 탐지 차원은 df_dimension_tags, 태그는 df_label, 과거 지능형 집계는 CLUSTER를 사용합니다.
alertOpt.aggLabels[*] string 단일 태그 값입니다.
예: production
가져오거나 입력하는 방법: 실제 이벤트의 태그 값에서 가져옵니다.
alertOpt.aggClusterFields[*] string 단일 텍스트 필드입니다.
예: df_title
가져오거나 입력하는 방법: 제목은 df_title, 내용은 df_message를 사용합니다.
alertOpt.alertTarget[*] json 규칙 객체입니다. 폴백이 필요하면 시간 구성이 없는 규칙을 명시적으로 추가하며, 시스템이 자동으로 보완한다고 가정하지 마십시오.
예: {"name": "默认通知", "targets": [{"status": "critical", "to": ["notify_example"]}]}
가져오거나 입력하는 방법: 각 항목은 하나의 시간 창 또는 시간대 제한이 없는 폴백 규칙을 구성합니다.
alertOpt.alertTarget[*].name string 선택적 규칙 이름이며 최대 256자입니다.
예: 默认通知
가져오거나 입력하는 방법: 업무 용도에 맞게 이름을 지정합니다.
alertOpt.alertTarget[*].crontab string 주기 시작 시간 표현식이며 crontabDuration과 쌍을 이루어야 합니다. 사용자 지정 날짜 방식과 둘 중 하나를 선택합니다.
예: 0 9 * * 1-5
가져오거나 입력하는 방법: 반복 시작 시간에 따라 Cron 표현식을 입력합니다(예: 평일 9시). 동시에 crontabDuration을 제공합니다.
alertOpt.alertTarget[*].crontabDuration integer 주기 창 지속 시간(초)이며 crontab을 제공할 때 반드시 함께 제공해야 합니다. 반복 시간대를 구성하지 않으면 둘 다 생략합니다.
예: 28800
가져오거나 입력하는 방법: 시간 창 길이를 양의 정수 초로 환산합니다. 예를 들어 28800은 8시간입니다.
alertOpt.alertTarget[*].customDateUUIDs array 사용자 지정 날짜 집합 참조이며 최대 366개 항목입니다. customStartTime, customDuration과 함께 제공하며 crontabDuration으로 대체하지 않습니다.
예: ["ndate_example"]
가져오거나 입력하는 방법: 사용자 지정 알림 날짜의 content.data[].uuid에서 날짜 집합을 가져옵니다. 각 항목은 날짜 문자열이 아니라 날짜 구성 UUID입니다.
alertOpt.alertTarget[*].customDateUUIDs[*] string 단일 날짜 구성 UUID입니다.
예: ndate_example
가져오거나 입력하는 방법: 사용자 지정 알림 날짜에서 동일 워크스페이스의 유효한 날짜 구성 UUID를 복사합니다.
alertOpt.alertTarget[*].customStartTime string 사용자 지정 날짜 당일의 시작 시각이며 customDateUUIDs/customDuration과 함께 사용합니다.
예: 09:30:00
가져오거나 입력하는 방법: 선택한 날짜의 로컬 시각에 따라 HH:MM:SS로 입력하며 실제 실행 시간대 기준으로 해석됩니다.
alertOpt.alertTarget[*].customDuration integer 사용자 지정 날짜 창 지속 시간(초)이며 날짜 집합 및 시작 시각과 반드시 함께 제공해야 합니다.
예: 3600
가져오거나 입력하는 방법: 창 길이를 양의 정수 초로 입력합니다. 예: 3600은 1시간입니다.
alertOpt.alertTarget[*].targets array 등급 모드 동작 배열입니다.
예: [{"status": "critical", "to": ["notify_example"]}]
가져오거나 입력하는 방법: 계정은 워크스페이스 멤버의 content.data[].uuid에서 가져옵니다. 팀은 멤버의 member_group 또는 팀 관리에서 group_ UUID를 가져옵니다. 알림 대상은 알림 대상 목록에서 UUID를 가져옵니다. 모두 현재 워크스페이스의 실제 리소스를 사용합니다.
alertOpt.alertTarget[*].targets[*] json 단일 등급 동작입니다.
예: {"status": "critical", "to": ["notify_example"]}
가져오거나 입력하는 방법: 각 이벤트 소스와 등급별로 하나의 동작을 설정합니다.
alertOpt.alertTarget[*].targets[*].status string 필수 등급 선택: fatal, critical, error, warning, nodata, info, 전체는 대문자 ALL입니다. 여러 개는 영문 쉼표로 연결하며 공백을 넣지 않습니다. security 소스는 critical, high, medium, low, info 또는 ALL을 사용합니다.
예: critical
가져오거나 입력하는 방법: 실제 이벤트의 df_status를 사용합니다. 보안 이벤트는 df_source=security도 함께 설정합니다.
alertOpt.alertTarget[*].targets[*].df_source string 선택 사항이며 공개 대상 구조는 security만 지원합니다. 생략하면 실행 계층에서 보안 소스를 제외합니다.
예: security
가져오거나 입력하는 방법: 보안 모니터링 이벤트에만 security를 입력하고 일반 이벤트에서는 생략합니다.
alertOpt.alertTarget[*].targets[*].to array 필수 수신 대상 배열이며 멤버, 팀, 알림 대상 또는 이메일을 사용할 수 있습니다. 에이전트 계정은 유효한 기본 Webhook을 사용할 수 있습니다.
예: ["notify_example"]
가져오거나 입력하는 방법: 계정은 워크스페이스 멤버의 content.data[].uuid에서 가져옵니다. 팀은 멤버의 member_group 또는 팀 관리에서 group_ UUID를 가져옵니다. 알림 대상은 알림 대상 목록에서 UUID를 가져옵니다. 모두 현재 워크스페이스의 실제 리소스를 사용합니다.
alertOpt.alertTarget[*].targets[*].to[*] string member 모드에서는 주로 email/sms/notify_를 사용하고, status 모드에서는 acnt_/agent_/group_/notify_ 또는 이메일을 사용합니다. SMS 등 채널의 사용 가능 여부는 사이트 및 대상 구성에 따릅니다.
예: notify_example
가져오거나 입력하는 방법: 계정은 워크스페이스 멤버의 content.data[].uuid에서 가져옵니다. 팀은 멤버의 member_group 또는 팀 관리에서 group_ UUID를 가져옵니다. 알림 대상은 알림 대상 목록에서 UUID를 가져옵니다. 모두 현재 워크스페이스의 실제 리소스를 사용합니다.
alertOpt.alertTarget[*].targets[*].tags json status 모드는 필드 값으로 이벤트를 필터링합니다. member 모드는 상위 alertInfo.filterString을 사용해야 하며, 여기의 tags는 멤버 선택 조건으로 사용되지 않습니다.
예: {"env": ["production"]}
가져오거나 입력하는 방법: 이벤트 원본 필드와 값으로 딕셔너리를 구성합니다.
alertOpt.alertTarget[*].targets[*].tags.字段 array 단일 필드의 일치 값 배열입니다.
예: ["production"]
가져오거나 입력하는 방법: 키에는 실제 이벤트 필드(예: env)를 사용하고, 값에는 일치시킬 실제 필드 값 배열을 사용합니다.
alertOpt.alertTarget[*].targets[*].tags.字段[*] string 단일 일치 값입니다.
예: production
가져오거나 입력하는 방법: 이벤트의 동일한 필드에서 값을 가져옵니다.
alertOpt.alertTarget[*].targets[*].filterString string status 모드에서 비어 있지 않으면 tags보다 우선하며 승격 동작에도 사용됩니다. member 모드는 상위 alertInfo.filterString을 사용하며, 이 대상 내 필드는 유효한 필터 진입점으로 사용되지 않습니다.
예: env:production
가져오거나 입력하는 방법: 서버 FilterString 문법을 사용합니다(예: env:production). 복잡한 조건은 콘솔에서 생성한 후 복사합니다.
alertOpt.alertTarget[*].targets[*].upgradeTargets array 선택적 승격 동작입니다. 이벤트가 해당 등급에 duration 동안 지속되면 실행되며, []는 승격을 구성하지 않습니다.
예: [{"to": ["acnt_example"], "duration": 600}]
가져오거나 입력하는 방법: 계정은 워크스페이스 멤버의 content.data[].uuid에서 가져옵니다. 팀은 멤버의 member_group 또는 팀 관리에서 group_ UUID를 가져옵니다. 알림 대상은 알림 대상 목록에서 UUID를 가져옵니다. 모두 현재 워크스페이스의 실제 리소스를 사용합니다.
alertOpt.alertTarget[*].targets[*].upgradeTargets[*] json 단일 승격 동작입니다.
예: {"to": ["acnt_example"], "duration": 600}
가져오거나 입력하는 방법: 각 승격에 대해 수신 대상과 대기 초를 선택합니다.
alertOpt.alertTarget[*].targets[*].upgradeTargets[*].to array member 모드는 승격 수신 멤버/팀이고, status 모드는 승격 알림 대상이며 멤버/팀/알림 대상/이메일을 사용할 수 있습니다.
예: ["acnt_example"]
가져오거나 입력하는 방법: 계정은 워크스페이스 멤버의 content.data[].uuid에서 가져옵니다. 팀은 멤버의 member_group 또는 팀 관리에서 group_ UUID를 가져옵니다. 알림 대상은 알림 대상 목록에서 UUID를 가져옵니다. 모두 현재 워크스페이스의 실제 리소스를 사용합니다.
alertOpt.alertTarget[*].targets[*].upgradeTargets[*].to[*] string 단일 승격 수신 식별자입니다.
예: acnt_example
가져오거나 입력하는 방법: 계정은 워크스페이스 멤버의 content.data[].uuid에서 가져옵니다. 팀은 멤버의 member_group 또는 팀 관리에서 group_ UUID를 가져옵니다. 알림 대상은 알림 대상 목록에서 UUID를 가져옵니다. 모두 현재 워크스페이스의 실제 리소스를 사용합니다.
alertOpt.alertTarget[*].targets[*].upgradeTargets[*].duration integer 필수 지속 시간이며 단위는 초입니다. 각 승격은 이벤트 지속 상태를 기준으로 구성하며 여러 duration을 자동으로 누적하지 않습니다.
예: 600
가져오거나 입력하는 방법: 업무 요구에 따라 양의 정수 초를 입력합니다. 예를 들어 600은 해당 등급이 10분 지속됨을 의미합니다.
alertOpt.alertTarget[*].targets[*].upgradeTargets[*].toWay array member 승격 알림 방식 배열이며 status 모드에서는 이 필드를 사용하지 않습니다.
예: ["email"]
가져오거나 입력하는 방법: member 모드는 email/sms 또는 알림 대상 목록의 notify_ 객체 중에서 선택하고, status 모드에서는 생략합니다.
alertOpt.alertTarget[*].targets[*].upgradeTargets[*].toWay[*] string 단일 승격 알림 방식입니다.
예: email
가져오거나 입력하는 방법: 실제 사용 가능한 email/sms 또는 알림 대상 UUID를 선택합니다.
alertOpt.alertTarget[*].alertInfo array member 모드에서만 사용하는 멤버 그룹 배열이며 status 모드에서는 사용하지 않습니다.
예: [{"name": "生产负责人", "memberInfo": ["acnt_example"], "filterString": "env:production", "targets": [{"status": "critical", "to": ["email"]}]}]
가져오거나 입력하는 방법: 계정은 워크스페이스 멤버의 content.data[].uuid에서 가져옵니다. 팀은 멤버의 member_group 또는 팀 관리에서 group_ UUID를 가져옵니다. 알림 대상은 알림 대상 목록에서 UUID를 가져옵니다. 모두 현재 워크스페이스의 실제 리소스를 사용합니다.
alertOpt.alertTarget[*].alertInfo[*] json 멤버 그룹 객체입니다.
예: {"name": "生产负责人", "memberInfo": ["acnt_example"], "targets": [{"status": "critical", "to": ["email"]}]}
가져오거나 입력하는 방법: 각 그룹에 멤버 범위, 이벤트 조건 및 알림 방식을 입력합니다.
alertOpt.alertTarget[*].alertInfo[*].name string 선택적 멤버 그룹 이름이며 최대 256자입니다.
예: 生产负责人
가져오거나 입력하는 방법: 멤버 그룹의 업무 용도에 맞게 이름을 지정합니다.
alertOpt.alertTarget[*].alertInfo[*].memberInfo array 멤버 모드 일반 알림의 수신 멤버/팀 배열이며 에이전트 계정을 포함할 수 있습니다. targets.to 알림 방식과 조합합니다.
예: ["acnt_example"]
가져오거나 입력하는 방법: 계정은 워크스페이스 멤버의 content.data[].uuid에서 가져옵니다. 팀은 멤버의 member_group 또는 팀 관리에서 group_ UUID를 가져옵니다. 알림 대상은 알림 대상 목록에서 UUID를 가져옵니다. 모두 현재 워크스페이스의 실제 리소스를 사용합니다.
alertOpt.alertTarget[*].alertInfo[*].memberInfo[*] string 단일 멤버 또는 팀 식별자입니다.
예: acnt_example
가져오거나 입력하는 방법: 계정은 워크스페이스 멤버의 content.data[].uuid에서 가져옵니다. 팀은 멤버의 member_group 또는 팀 관리에서 group_ UUID를 가져옵니다. 알림 대상은 알림 대상 목록에서 UUID를 가져옵니다. 모두 현재 워크스페이스의 실제 리소스를 사용합니다.
alertOpt.alertTarget[*].alertInfo[*].filterString string 멤버 그룹 수준 이벤트 필터이며 일반 및 승격 동작 모두 이 조건을 사용합니다.
예: env:production
가져오거나 입력하는 방법: 실제 이벤트 필드로 구성합니다(예: env:production).
alertOpt.alertTarget[*].alertInfo[*].targets array 멤버 모드의 알림 방식/등급 동작 배열입니다.
예: [{"status": "critical", "to": ["email"]}]
가져오거나 입력하는 방법: 계정은 워크스페이스 멤버의 content.data[].uuid에서 가져옵니다. 팀은 멤버의 member_group 또는 팀 관리에서 group_ UUID를 가져옵니다. 알림 대상은 알림 대상 목록에서 UUID를 가져옵니다. 모두 현재 워크스페이스의 실제 리소스를 사용합니다.
alertOpt.alertTarget[*].alertInfo[*].targets[*] json 단일 등급 동작입니다.
예: {"status": "critical", "to": ["email"]}
가져오거나 입력하는 방법: 각 이벤트 소스와 등급별로 하나의 동작을 설정합니다.
alertOpt.alertTarget[*].alertInfo[*].targets[*].status string 필수 등급 선택: fatal, critical, error, warning, nodata, info, 전체는 대문자 ALL입니다. 여러 개는 영문 쉼표로 연결하며 공백을 넣지 않습니다. security 소스는 critical, high, medium, low, info 또는 ALL을 사용합니다.
예: critical
가져오거나 입력하는 방법: 실제 이벤트의 df_status를 사용합니다. 보안 이벤트는 df_source=security도 함께 설정합니다.
alertOpt.alertTarget[*].alertInfo[*].targets[*].df_source string 선택 사항이며 공개 대상 구조는 security만 지원합니다. 생략하면 실행 계층에서 보안 소스를 제외합니다.
예: security
가져오거나 입력하는 방법: 보안 모니터링 이벤트에만 security를 입력하고 일반 이벤트에서는 생략합니다.
alertOpt.alertTarget[*].alertInfo[*].targets[*].to array member 모드는 주로 email, sms 또는 notify_ 알림 대상을 사용하며 알림 방식을 나타냅니다. 실행 계층은 직접 계정/팀 등의 대상도 호환하지만 memberInfo와 알림 방식 조합을 우선 사용하는 것이 좋습니다.
예: ["email"]
가져오거나 입력하는 방법: 계정은 워크스페이스 멤버의 content.data[].uuid에서 가져옵니다. 팀은 멤버의 member_group 또는 팀 관리에서 group_ UUID를 가져옵니다. 알림 대상은 알림 대상 목록에서 UUID를 가져옵니다. 모두 현재 워크스페이스의 실제 리소스를 사용합니다.
alertOpt.alertTarget[*].alertInfo[*].targets[*].to[*] string member 모드에서는 주로 email/sms/notify_를 사용하고, status 모드에서는 acnt_/agent_/group_/notify_ 또는 이메일을 사용합니다. SMS 등 채널의 사용 가능 여부는 사이트 및 대상 구성에 따릅니다.
예: email
가져오거나 입력하는 방법: 계정은 워크스페이스 멤버의 content.data[].uuid에서 가져옵니다. 팀은 멤버의 member_group 또는 팀 관리에서 group_ UUID를 가져옵니다. 알림 대상은 알림 대상 목록에서 UUID를 가져옵니다. 모두 현재 워크스페이스의 실제 리소스를 사용합니다.
alertOpt.alertTarget[*].alertInfo[*].targets[*].tags json status 모드는 필드 값으로 이벤트를 필터링합니다. member 모드는 상위 alertInfo.filterString을 사용해야 하며, 여기의 tags는 멤버 선택 조건으로 사용되지 않습니다.
예: {"env": ["production"]}
가져오거나 입력하는 방법: 이벤트 원본 필드와 값으로 딕셔너리를 구성합니다.
alertOpt.alertTarget[*].alertInfo[*].targets[*].tags.字段 array 단일 필드의 일치 값 배열입니다.
예: ["production"]
가져오거나 입력하는 방법: 키에는 실제 이벤트 필드(예: env)를 사용하고, 값에는 일치시킬 실제 필드 값 배열을 사용합니다.
alertOpt.alertTarget[*].alertInfo[*].targets[*].tags.字段[*] string 단일 일치 값입니다.
예: production
가져오거나 입력하는 방법: 이벤트의 동일한 필드에서 값을 가져옵니다.
alertOpt.alertTarget[*].alertInfo[*].targets[*].filterString string status 모드에서 비어 있지 않으면 tags보다 우선하며 승격 동작에도 사용됩니다. member 모드는 상위 alertInfo.filterString을 사용하며, 이 대상 내 필드는 유효한 필터 진입점으로 사용되지 않습니다.
예: env:production
가져오거나 입력하는 방법: 서버 FilterString 문법을 사용합니다(예: env:production). 복잡한 조건은 콘솔에서 생성한 후 복사합니다.
alertOpt.alertTarget[*].alertInfo[*].targets[*].upgradeTargets array 선택적 승격 동작입니다. 이벤트가 해당 등급에 duration 동안 지속되면 실행되며, []는 승격을 구성하지 않습니다.
예: [{"to": ["acnt_example"], "duration": 600, "toWay": ["email"]}]
가져오거나 입력하는 방법: 계정은 워크스페이스 멤버의 content.data[].uuid에서 가져옵니다. 팀은 멤버의 member_group 또는 팀 관리에서 group_ UUID를 가져옵니다. 알림 대상은 알림 대상 목록에서 UUID를 가져옵니다. 모두 현재 워크스페이스의 실제 리소스를 사용합니다.
alertOpt.alertTarget[*].alertInfo[*].targets[*].upgradeTargets[*] json 단일 승격 동작입니다.
예: {"to": ["acnt_example"], "duration": 600, "toWay": ["email"]}
가져오거나 입력하는 방법: 각 승격에 대해 수신 대상과 대기 초를 선택합니다.
alertOpt.alertTarget[*].alertInfo[*].targets[*].upgradeTargets[*].to array member 모드는 승격 수신 멤버/팀이고, status 모드는 승격 알림 대상이며 멤버/팀/알림 대상/이메일을 사용할 수 있습니다.
예: ["acnt_example"]
가져오거나 입력하는 방법: 계정은 워크스페이스 멤버의 content.data[].uuid에서 가져옵니다. 팀은 멤버의 member_group 또는 팀 관리에서 group_ UUID를 가져옵니다. 알림 대상은 알림 대상 목록에서 UUID를 가져옵니다. 모두 현재 워크스페이스의 실제 리소스를 사용합니다.
alertOpt.alertTarget[*].alertInfo[*].targets[*].upgradeTargets[*].to[*] string 단일 승격 수신 식별자입니다.
예: acnt_example
가져오거나 입력하는 방법: 계정은 워크스페이스 멤버의 content.data[].uuid에서 가져옵니다. 팀은 멤버의 member_group 또는 팀 관리에서 group_ UUID를 가져옵니다. 알림 대상은 알림 대상 목록에서 UUID를 가져옵니다. 모두 현재 워크스페이스의 실제 리소스를 사용합니다.
alertOpt.alertTarget[*].alertInfo[*].targets[*].upgradeTargets[*].duration integer 필수 지속 시간이며 단위는 초입니다. 각 승격은 이벤트 지속 상태를 기준으로 구성하며 여러 duration을 자동으로 누적하지 않습니다.
예: 600
가져오거나 입력하는 방법: 업무 요구에 따라 양의 정수 초를 입력합니다. 예를 들어 600은 해당 등급이 10분 지속됨을 의미합니다.
alertOpt.alertTarget[*].alertInfo[*].targets[*].upgradeTargets[*].toWay array member 승격 알림 방식 배열이며 status 모드에서는 이 필드를 사용하지 않습니다.
예: ["email"]
가져오거나 입력하는 방법: member 모드는 email/sms 또는 알림 대상 목록의 notify_ 객체 중에서 선택하고, status 모드에서는 생략합니다.
alertOpt.alertTarget[*].alertInfo[*].targets[*].upgradeTargets[*].toWay[*] string 단일 승격 알림 방식입니다.
예: email
가져오거나 입력하는 방법: 실제 사용 가능한 email/sms 또는 알림 대상 UUID를 선택합니다.
checkerUUIDs[*] string 단일 모니터 또는 SLO UUID입니다.
예: rul_example
가져오거나 입력하는 방법: 동일 워크스페이스의 실제 모니터 또는 SLO UUID를 가져오며, 알림 정책 UUID를 입력하지 않습니다.
securityRuleUUIDs[*] string 단일 보안 규칙 UUID입니다.
예: srul_example
가져오거나 입력하는 방법: 동일 워크스페이스의 보안 모니터링 규칙 UUID를 가져옵니다.
alertOpt json 알림 구성 객체입니다. 생성 시 생략하면 빈 구성을 저장할 수 있고, 수정 시 전달하면 전체를 교체합니다. 객체를 제공할 때 aggInterval은 필수 검증 필드입니다.
null 허용: False
예: {"alertType": "status", "aggInterval": 0, "silentTimeout": 900, "alertTarget": []}
가져오거나 입력하는 방법: 아래 대상 구조에 따라 입력합니다. 수정 전에 상세 정보에서 전체 객체를 복사한 후 조정합니다.
alertOpt.aggClusterFields array 지능형 집계 텍스트 필드입니다. CLUSTER를 포함할 때 df_title 또는 df_message 중 하나 이상을 선택해야 합니다.
null 허용: False
예: ["df_title"]
가져오거나 입력하는 방법: CLUSTER 집계가 필요할 때 제목 또는 내용 필드를 선택합니다.
alertOpt.aggFields array 필드 목록입니다. 미리 정의된 df_monitor_checker_id, df_dimension_tags, df_label, CLUSTER를 사용할 수 있습니다. byCustom 모드는 비즈니스 사용자 지정 필드를 사용할 수 있으며, v2 집계 모드는 aggType을 별도로 참조합니다.
null 허용: False
예: ["df_monitor_checker_id"]
가져오거나 입력하는 방법: 어떤 이벤트를 같은 그룹으로 묶을지에 따라 다음 필드를 선택합니다. []는 전체 집계를 의미합니다.
alertOpt.aggInterval integer 조건부 필수 alertOpt를 제공할 때 필수이며 0~1800초입니다. 0은 집계하지 않으며, byAI를 선택하더라도 유효한 AI 집계가 활성화됨을 의미하지 않습니다.
null 허용: False
$maxValue: 1800
$minValue: 0
예: 0
가져오거나 입력하는 방법: 집계가 필요하면 대기할 초를 입력하고, 집계하지 않으면 0을 입력합니다.
alertOpt.aggLabels array 태그 기준 집계의 태그 값 배열입니다. df_label을 선택할 때 비어 있지 않은 배열을 제공해야 합니다.
null 허용: False
예: ["production"]
가져오거나 입력하는 방법: 이벤트 태그에서 실제 태그 값을 가져옵니다. aggFields에 df_label이 포함된 경우에만 사용합니다.
alertOpt.aggSendFirst boolean v2 선택 사항이며, 집계 시 첫 번째 알림을 즉시 전송할지 여부이고 기본값은 false입니다. aggInterval=0일 때는 유효한 집계를 구성하지 않습니다.
null 허용: False
예: false
가져오거나 입력하는 방법: 집계와 동시에 첫 번째 알림을 즉시 보내야 하면 true를 입력합니다.
alertOpt.aggType string v2 선택 모드: byFields는 규칙 집계, byCluster는 지능형 집계, byAI는 AI 집계, byCustom은 사용자 지정 필드 규칙 집계입니다. 생략하거나 null이면 기존 aggFields 로직을 따르며, 집계에는 여전히 aggInterval>0이 필요합니다.
null 허용: True
선택 가능한 값: ['byFields', 'byCluster', 'byAI', 'byCustom']
예: byFields
가져오거나 입력하는 방법: 집계 의도에 따라 모드를 선택합니다.
alertOpt.alertTarget array 알림 규칙 배열입니다. status 모드는 targets에 등급 동작을 두고, member 모드는 alertInfo에서 멤버 및 알림 방식을 구성합니다.
null 허용: False
예: [{"name": "默认通知", "targets": [{"status": "critical", "to": ["notify_example"]}]}]
가져오거나 입력하는 방법: 업무 시간과 수신 규칙에 따라 배열을 구성하며, 동작이 없으면 []입니다.
alertOpt.alertType string status는 등급 기준, member는 멤버 기준이며 생략하면 기본값 status입니다. 두 모드는 targets 계층이 달라 혼용할 수 없습니다.
null 허용: False
선택 가능한 값: ['status', 'member']
예: status
가져오거나 입력하는 방법: 등급 기준으로 수신자를 선택하거나 멤버 기준으로 알림 방식을 선택하는 것 중 하나입니다.
alertOpt.ignoreOK boolean v2 선택 사항이며 정상 등급 알림을 무시합니다. 기본값은 false입니다.
null 허용: False
예: false
가져오거나 입력하는 방법: 복구 후에도 정상 알림을 보내야 하면 false, 정상 이벤트만 유지하고 알림은 보내지 않으려면 true를 사용합니다.
alertOpt.silentTimeout integer 통합 반복 알림 간격이며 생략하면 실행 기본값은 900초입니다. 0은 이번 주기에 더 이상 반복하지 않음을 의미합니다. 0이 아니고 300 미만이면 실행 시 300초로 처리합니다. null을 전달하지 마십시오.
null 허용: False
예: 900
가져오거나 입력하는 방법: 동일 유형 알림에 기대하는 최소 반복 전송 간격을 초 단위로 입력합니다.
alertOpt.silentTimeoutByStatus array 등급별 반복 간격 배열입니다. 활성화하면 제어가 필요한 등급을 포함해야 합니다. 이 등급별 구성은 통합 silentTimeout의 300초 정규화를 거치지 않습니다.
null 허용: False
예: [{"status": "critical,error", "silentTimeout": 600}]
가져오거나 입력하는 방법: 실제 이벤트 소스와 등급별로 설정하며 아래 등급별 배열 구조를 사용합니다.
alertOpt.silentTimeoutByStatusEnable boolean 생성 시 기본값 false이면 silentTimeout을 사용하고, true이면 silentTimeoutByStatus에 따라 상태별 간격을 펼칩니다.
null 허용: False
예: false
가져오거나 입력하는 방법: 이벤트 등급별로 반복 간격을 다르게 설정해야 하면 true를 입력합니다.
checkerUUIDs array v2 생성 시 선택 사항이고, v2 수정 시 전체 대상 바인딩입니다. 생략하거나 []를 전달하면 모니터 및 SLO 바인딩이 모두 지워집니다.
null 허용: False
예: ["rul_example"]
가져오거나 입력하는 방법: 모니터/지능형 모니터링/지능형 점검/SLO 구성에서 실제 UUID(rul_ 또는 monitor_ 등)를 가져옵니다. 또는 알림 정책 상세의 refCheckerInfo에서 기존 바인딩을 가져올 수 있습니다.
desc string 선택적 설명이며 최대 256자입니다. 생성 시 생략하면 빈 문자열, 수정 시 생략하면 유지, 빈 문자열이면 지웁니다.
빈 문자열 허용: True
null 허용: False
최대 길이: 256
예: 生产服务异常通知与升级。
가져오거나 입력하는 방법: 정책이 담당하는 업무 범위에 따라 입력합니다.
name string 선택적 새 이름이며 생략하면 유지됩니다. 심층 파라미터 검증을 트리거하려면 기존 name을 제출하는 것이 좋습니다.
null 허용: False
예: 生产服务告警
가져오거나 입력하는 방법: 알림 정책 목록에서 이 워크스페이스의 기존 이름을 확인하고 사용되지 않은 이름을 선택합니다.
openPermissionSet boolean 선택적 사용자 지정 작업 권한 스위치이며 생성 시 기본값은 false이고 수정 시 생략하면 유지됩니다. 활성화하면 생성자, owner 및 고급 작업 권한 또는 permissionSet에 해당하는 ID가 작업할 수 있습니다.
null 허용: False
예: false
가져오거나 입력하는 방법: 특정 역할, 팀, 멤버로 편집 등의 작업을 제한해야 할 때 활성화하고, 일반적으로 인터페이스 권한으로 제어할 때는 비활성화합니다.
permissionSet array 사용자 지정 작업 주체 전체 배열이며 역할, 계정, 팀 식별자를 넣을 수 있습니다. 생성 시 생략하면 [], 수정 시 전달하면 전체 교체, []이면 지웁니다. 생성자와 owner는 빈 배열 때문에 잠기지 않습니다.
null 허용: False
예: ["wsAdmin"]
가져오거나 입력하는 방법: 워크스페이스 역할에서 역할 UUID를, 워크스페이스 멤버에서 계정/팀 UUID를 가져옵니다. 역할 표시 이름을 입력하지 마십시오.
ruleTimezone str Y 생성 및 수정 모두 필수인 시간대 문자열이며 정책 엔터티에 저장됩니다. 현재 공개 버전에는 실행 시 읽는 위치 차이가 있습니다.
null 허용: False
예: Asia/Shanghai
가져오거나 입력하는 방법: 업무 요구에 따라 IANA 시간대를 선택합니다(예: Asia/Shanghai). 현재 실행 측 제한은 사용법 설명을 참조하십시오.
securityRuleUUIDs array v2 생성 시 선택 사항이고, v2 수정 시 전체 대상 보안 규칙 바인딩입니다. 생략하거나 []이면 지웁니다.
null 허용: False
예: ["srul_example"]
가져오거나 입력하는 방법: 보안 모니터링 규칙 목록/콘솔에서 srul_ UUID를 가져오거나 알림 정책 상세의 refSecurityRuleInfo에서 가져옵니다.

파라미터 추가 설명

status 모드는 alertTarget[].targets를 구성하고, member 모드는 alertTarget[].alertInfo[].memberInfo 및 targets를 구성합니다. 승격 수신자는 to, 알림 방식은 toWay를 사용합니다. 주기 창은 crontab+crontabDuration을 입력하고, 지정 날짜 창은 customDateUUIDs+customStartTime+customDuration을 입력하며 crontabDuration을 customDuration으로 사용할 수 없습니다.

멤버 모드 요청 본문 구조 예시(이 페이지 URL로 제출하며, 예시 계정/팀은 교체해야 합니다):

{
  "name": "生产服务告警",
  "ruleTimezone": "Asia/Shanghai",
  "alertOpt": {
    "alertType": "member",
    "aggInterval": 0,
    "silentTimeout": 900,
    "alertTarget": [
      {
        "name": "默认成员通知",
        "alertInfo": [
          {
            "name": "生产负责人",
            "memberInfo": [
              "acnt_example"
            ],
            "filterString": "env:production",
            "targets": [
              {
                "status": "critical",
                "to": [
                  "email"
                ],
                "upgradeTargets": [
                  {
                    "to": [
                      "group_example"
                    ],
                    "duration": 600,
                    "toWay": [
                      "email"
                    ]
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  },
  "checkerUUIDs": [],
  "securityRuleUUIDs": []
}

요청 예시

curl --request POST 'https://openapi.guance.com/api/v1/alert_policy/altpl_example/modify_v2' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  -H 'Content-Type: application/json' \
  --data-raw '{"name":"生产服务告警","ruleTimezone":"Asia/Shanghai","alertOpt":{"alertType":"status","aggInterval":0,"silentTimeout":900,"alertTarget":[{"name":"默认通知","targets":[{"status":"critical","to":["notify_example"]}]}]},"checkerUUIDs":[],"securityRuleUUIDs":[]}'

응답

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

필드 유형 설명
content.id integer 또는 null 정책 레코드 번호이며 생성 응답에서는 아직 할당되지 않았을 수 있습니다. 작업에는 uuid를 사용합니다.
content.uuid string altpl_ 알림 정책 UUID입니다.
content.workspaceUUID string 소속 워크스페이스 UUID입니다.
content.name string 정책 이름입니다.
content.desc string 정책 설명입니다.
content.ruleTimezone string 저장된 엔터티 시간대입니다. 실행 시 읽기 차이는 사용법을 참조하며, 시간대가 적용되었다는 증거로 사용하지 않습니다.
content.score integer 정책 점수 필드이며 생성 시 기본값은 0이고, 이 공개 요청에서는 해당 필드를 제공하지 않습니다.
content.openPermissionSet boolean 사용자 지정 작업 권한 스위치입니다.
content.permissionSet array<string> 작업 가능한 역할/멤버/팀 식별자입니다.
content.permissionSet[] string 단일 주체 식별자입니다.
content.status integer 레코드 상태이며 0은 활성, 2는 비활성, 3은 삭제입니다. 목록에는 삭제되지 않은 정책이 표시됩니다.
content.creator string 생성 ID입니다.
content.updator string 최근 업데이트 ID입니다.
content.createAt integer 생성 시간(Unix 초).
content.updateAt integer 업데이트 시간(Unix 초)이며 초기값은 -1입니다.
content.deleteAt integer 삭제 시간(Unix 초)이며 삭제되지 않았으면 -1입니다.
content.alertOpt object 저장된 구성: 알림 구성 객체입니다. 생성 시 생략하면 빈 구성을 저장할 수 있고, 수정 시 전달하면 전체를 교체합니다. 객체를 제공할 때 aggInterval은 필수 검증 필드입니다.
content.alertOpt.alertType string 저장된 구성: status는 등급 기준, member는 멤버 기준이며 생략하면 기본값 status입니다. 두 모드는 targets 계층이 달라 혼용할 수 없습니다.
content.alertOpt.silentTimeout integer 저장된 구성: 통합 반복 알림 간격이며 생략하면 실행 기본값은 900초입니다. 0은 이번 주기에 더 이상 반복하지 않음을 의미합니다. 0이 아니고 300 미만이면 실행 시 300초로 처리합니다. null을 전달하지 마십시오.
content.alertOpt.silentTimeoutByStatusEnable boolean 저장된 구성: 생성 시 기본값 false이면 silentTimeout을 사용하고, true이면 silentTimeoutByStatus에 따라 상태별 간격을 펼칩니다.
content.alertOpt.silentTimeoutByStatus array<object> 저장된 구성: 등급별 반복 간격 배열입니다. 활성화하면 제어가 필요한 등급을 포함해야 합니다. 이 등급별 구성은 통합 silentTimeout의 300초 정규화를 거치지 않습니다.
content.alertOpt.silentTimeoutByStatus[] object 저장된 구성: 등급별 간격 객체입니다.
content.alertOpt.silentTimeoutByStatus[].status string 저장된 구성: 비보안에서는 fatal/critical/error/warning/nodata/info/ALL을 사용할 수 있고, 보안에서는 security_critical/security_high/security_medium/security_low/security_info/security_ALL을 사용합니다. 여러 개는 영문 쉼표로 연결하며 공백을 넣지 않습니다.
content.alertOpt.silentTimeoutByStatus[].silentTimeout integer 저장된 구성: 각 그룹에 필수인 반복 간격이며 단위는 초입니다. 잘못된 등급은 내부 오류를 유발할 수 있으므로 전송 전에 검증하십시오.
content.alertOpt.aggInterval integer 저장된 구성: alertOpt를 제공할 때 필수이며 0~1800초입니다. 0은 집계하지 않으며, byAI를 선택하더라도 유효한 AI 집계가 활성화됨을 의미하지 않습니다.
content.alertOpt.aggFields array<string> 저장된 구성: 필드 목록입니다. 미리 정의된 df_monitor_checker_id, df_dimension_tags, df_label, CLUSTER를 사용할 수 있습니다. byCustom 모드는 비즈니스 사용자 지정 필드를 사용할 수 있으며, v2 집계 모드는 aggType을 별도로 참조합니다.
content.alertOpt.aggFields[] string 저장된 구성: 단일 집계 필드입니다. byCustom은 실제 이벤트 필드를 기준으로 선택하며 표시 이름만으로 필드를 추측하지 마십시오.
content.alertOpt.aggLabels array<string> 저장된 구성: 태그 기준 집계의 태그 값 배열입니다. df_label을 선택할 때 비어 있지 않은 배열을 제공해야 합니다.
content.alertOpt.aggLabels[] string 저장된 구성: 단일 태그 값입니다.
content.alertOpt.aggClusterFields array<string> 저장된 구성: 지능형 집계 텍스트 필드입니다. CLUSTER를 포함할 때 df_title 또는 df_message 중 하나 이상을 선택해야 합니다.
content.alertOpt.aggClusterFields[] string 저장된 구성: 단일 텍스트 필드입니다.
content.alertOpt.alertTarget array<object> 저장된 구성: 알림 규칙 배열입니다. status 모드는 targets에 등급 동작을 두고, member 모드는 alertInfo에서 멤버 및 알림 방식을 구성합니다.
content.alertOpt.alertTarget[] object 저장된 구성: 규칙 객체입니다. 폴백이 필요하면 시간 구성이 없는 규칙을 명시적으로 추가하며, 시스템이 자동으로 보완한다고 가정하지 마십시오.
content.alertOpt.alertTarget[].name string 저장된 구성: 선택적 규칙 이름이며 최대 256자입니다.
content.alertOpt.alertTarget[].crontab string 저장된 구성: 주기 시작 시간 표현식이며 crontabDuration과 쌍을 이루어야 합니다. 사용자 지정 날짜 방식과 둘 중 하나를 선택합니다.
content.alertOpt.alertTarget[].crontabDuration integer 저장된 구성: 주기 창 지속 시간(초)이며 crontab을 제공할 때 반드시 함께 제공해야 합니다. 반복 시간대를 구성하지 않으면 둘 다 생략합니다.
content.alertOpt.alertTarget[].customDateUUIDs array<string> 저장된 구성: 사용자 지정 날짜 집합 참조이며 최대 366개 항목입니다. customStartTime, customDuration과 함께 제공하며 crontabDuration으로 대체하지 않습니다.
content.alertOpt.alertTarget[].customDateUUIDs[] string 저장된 구성: 단일 날짜 구성 UUID입니다.
content.alertOpt.alertTarget[].customStartTime string 저장된 구성: 사용자 지정 날짜 당일의 시작 시각이며 customDateUUIDs/customDuration과 함께 사용합니다.
content.alertOpt.alertTarget[].customDuration integer 저장된 구성: 사용자 지정 날짜 창 지속 시간(초)이며 날짜 집합 및 시작 시각과 반드시 함께 제공해야 합니다.
content.alertOpt.alertTarget[].targets array<object> 저장된 구성: 등급 모드 동작 배열입니다.
content.alertOpt.alertTarget[].targets[] object 저장된 구성: 단일 등급 동작입니다.
content.alertOpt.alertTarget[].targets[].status string 저장된 구성: 필수 등급 선택: fatal, critical, error, warning, nodata, info, 전체는 대문자 ALL입니다. 여러 개는 영문 쉼표로 연결하며 공백을 넣지 않습니다. security 소스는 critical, high, medium, low, info 또는 ALL을 사용합니다.
content.alertOpt.alertTarget[].targets[].df_source string 저장된 구성: 선택 사항이며 공개 대상 구조는 security만 지원합니다. 생략하면 실행 계층에서 보안 소스를 제외합니다.
content.alertOpt.alertTarget[].targets[].to array<string> 저장된 구성: 필수 수신 대상 배열이며 멤버, 팀, 알림 대상 또는 이메일을 사용할 수 있습니다. 에이전트 계정은 유효한 기본 Webhook을 사용할 수 있습니다.
content.alertOpt.alertTarget[].targets[].to[] string 저장된 구성: member 모드에서는 주로 email/sms/notify_를 사용하고, status 모드에서는 acnt_/agent_/group_/notify_ 또는 이메일을 사용합니다. SMS 등 채널의 사용 가능 여부는 사이트 및 대상 구성에 따릅니다.
content.alertOpt.alertTarget[].targets[].tags object 저장된 구성: status 모드는 필드 값으로 이벤트를 필터링합니다. member 모드는 상위 alertInfo.filterString을 사용해야 하며, 여기의 tags는 멤버 선택 조건으로 사용되지 않습니다.
content.alertOpt.alertTarget[].targets[].tags.字段 array<object> 저장된 구성: 단일 필드의 일치 값 배열입니다.
content.alertOpt.alertTarget[].targets[].tags.字段[] string 저장된 구성: 단일 일치 값입니다.
content.alertOpt.alertTarget[].targets[].filterString string 저장된 구성: status 모드에서 비어 있지 않으면 tags보다 우선하며 승격 동작에도 사용됩니다. member 모드는 상위 alertInfo.filterString을 사용하며, 이 대상 내 필드는 유효한 필터 진입점으로 사용되지 않습니다.
content.alertOpt.alertTarget[].targets[].upgradeTargets array<object> 저장된 구성: 선택적 승격 동작입니다. 이벤트가 해당 등급에 duration 동안 지속되면 실행되며, []는 승격을 구성하지 않습니다.
content.alertOpt.alertTarget[].targets[].upgradeTargets[] object 저장된 구성: 단일 승격 동작입니다.
content.alertOpt.alertTarget[].targets[].upgradeTargets[].to array<string> 저장된 구성: member 모드는 승격 수신 멤버/팀이고, status 모드는 승격 알림 대상이며 멤버/팀/알림 대상/이메일을 사용할 수 있습니다.
content.alertOpt.alertTarget[].targets[].upgradeTargets[].to[] string 저장된 구성: 단일 승격 수신 식별자입니다.
content.alertOpt.alertTarget[].targets[].upgradeTargets[].duration integer 저장된 구성: 필수 지속 시간이며 단위는 초입니다. 각 승격은 이벤트 지속 상태를 기준으로 구성하며 여러 duration을 자동으로 누적하지 않습니다.
content.alertOpt.alertTarget[].targets[].upgradeTargets[].toWay array<string> 저장된 구성: member 승격 알림 방식 배열이며 status 모드에서는 이 필드를 사용하지 않습니다.
content.alertOpt.alertTarget[].targets[].upgradeTargets[].toWay[] string 저장된 구성: 단일 승격 알림 방식입니다.
content.alertOpt.alertTarget[].alertInfo array<object> 저장된 구성: member 모드에서만 사용하는 멤버 그룹 배열이며 status 모드에서는 사용하지 않습니다.
content.alertOpt.alertTarget[].alertInfo[] object 저장된 구성: 멤버 그룹 객체입니다.
content.alertOpt.alertTarget[].alertInfo[].name string 저장된 구성: 선택적 멤버 그룹 이름이며 최대 256자입니다.
content.alertOpt.alertTarget[].alertInfo[].memberInfo array<string> 저장된 구성: 멤버 모드 일반 알림의 수신 멤버/팀 배열이며 에이전트 계정을 포함할 수 있습니다. targets.to 알림 방식과 조합합니다.
content.alertOpt.alertTarget[].alertInfo[].memberInfo[] string 저장된 구성: 단일 멤버 또는 팀 식별자입니다.
content.alertOpt.alertTarget[].alertInfo[].filterString string 저장된 구성: 멤버 그룹 수준 이벤트 필터이며 일반 및 승격 동작 모두 이 조건을 사용합니다.
content.alertOpt.alertTarget[].alertInfo[].targets array<object> 저장된 구성: 멤버 모드의 알림 방식/등급 동작 배열입니다.
content.alertOpt.alertTarget[].alertInfo[].targets[] object 저장된 구성: 단일 등급 동작입니다.
content.alertOpt.alertTarget[].alertInfo[].targets[].status string 저장된 구성: 필수 등급 선택: fatal, critical, error, warning, nodata, info, 전체는 대문자 ALL입니다. 여러 개는 영문 쉼표로 연결하며 공백을 넣지 않습니다. security 소스는 critical, high, medium, low, info 또는 ALL을 사용합니다.
content.alertOpt.alertTarget[].alertInfo[].targets[].df_source string 저장된 구성: 선택 사항이며 공개 대상 구조는 security만 지원합니다. 생략하면 실행 계층에서 보안 소스를 제외합니다.
content.alertOpt.alertTarget[].alertInfo[].targets[].to array<string> 저장된 구성: member 모드는 주로 email, sms 또는 notify_ 알림 대상을 사용하며 알림 방식을 나타냅니다. 실행 계층은 직접 계정/팀 등의 대상도 호환하지만 memberInfo와 알림 방식 조합을 우선 사용하는 것이 좋습니다.
content.alertOpt.alertTarget[].alertInfo[].targets[].to[] string 저장된 구성: member 모드에서는 주로 email/sms/notify_를 사용하고, status 모드에서는 acnt_/agent_/group_/notify_ 또는 이메일을 사용합니다. SMS 등 채널의 사용 가능 여부는 사이트 및 대상 구성에 따릅니다.
content.alertOpt.alertTarget[].alertInfo[].targets[].tags object 저장된 구성: status 모드는 필드 값으로 이벤트를 필터링합니다. member 모드는 상위 alertInfo.filterString을 사용해야 하며, 여기의 tags는 멤버 선택 조건으로 사용되지 않습니다.
content.alertOpt.alertTarget[].alertInfo[].targets[].tags.字段 array<object> 저장된 구성: 단일 필드의 일치 값 배열입니다.
content.alertOpt.alertTarget[].alertInfo[].targets[].tags.字段[] string 저장된 구성: 단일 일치 값입니다.
content.alertOpt.alertTarget[].alertInfo[].targets[].filterString string 저장된 구성: status 모드에서 비어 있지 않으면 tags보다 우선하며 승격 동작에도 사용됩니다. member 모드는 상위 alertInfo.filterString을 사용하며, 이 대상 내 필드는 유효한 필터 진입점으로 사용되지 않습니다.
content.alertOpt.alertTarget[].alertInfo[].targets[].upgradeTargets array<object> 저장된 구성: 선택적 승격 동작입니다. 이벤트가 해당 등급에 duration 동안 지속되면 실행되며, []는 승격을 구성하지 않습니다.
content.alertOpt.alertTarget[].alertInfo[].targets[].upgradeTargets[] object 저장된 구성: 단일 승격 동작입니다.
content.alertOpt.alertTarget[].alertInfo[].targets[].upgradeTargets[].to array<string> 저장된 구성: member 모드는 승격 수신 멤버/팀이고, status 모드는 승격 알림 대상이며 멤버/팀/알림 대상/이메일을 사용할 수 있습니다.
content.alertOpt.alertTarget[].alertInfo[].targets[].upgradeTargets[].to[] string 저장된 구성: 단일 승격 수신 식별자입니다.
content.alertOpt.alertTarget[].alertInfo[].targets[].upgradeTargets[].duration integer 저장된 구성: 필수 지속 시간이며 단위는 초입니다. 각 승격은 이벤트 지속 상태를 기준으로 구성하며 여러 duration을 자동으로 누적하지 않습니다.
content.alertOpt.alertTarget[].alertInfo[].targets[].upgradeTargets[].toWay array<string> 저장된 구성: member 승격 알림 방식 배열이며 status 모드에서는 이 필드를 사용하지 않습니다.
content.alertOpt.alertTarget[].alertInfo[].targets[].upgradeTargets[].toWay[] string 저장된 구성: 단일 승격 알림 방식입니다.
content.alertOpt.aggType string 저장된 구성: v2 선택 모드: byFields는 규칙 집계, byCluster는 지능형 집계, byAI는 AI 집계, byCustom은 사용자 지정 필드 규칙 집계입니다. 생략하거나 null이면 기존 aggFields 로직을 따르며, 집계에는 여전히 aggInterval>0이 필요합니다.
content.alertOpt.ignoreOK boolean 저장된 구성: v2 선택 사항이며 정상 등급 알림을 무시합니다. 기본값은 false입니다.
content.alertOpt.aggSendFirst boolean 저장된 구성: v2 선택 사항이며, 집계 시 첫 번째 알림을 즉시 전송할지 여부이고 기본값은 false입니다. aggInterval=0일 때는 유효한 집계를 구성하지 않습니다.
content.declaration object 또는 null 워크스페이스 공통 선언입니다. 쓰기 인터페이스는 저장된 엔터티만 반환하며 조회 시의 추가 필드는 포함하지 않습니다.
{
  "code": 200,
  "content": {
    "id": 42,
    "uuid": "altpl_example",
    "workspaceUUID": "wksp_example",
    "name": "生产服务告警",
    "desc": "生产服务异常通知与升级。",
    "alertOpt": {
      "alertType": "status",
      "aggInterval": 0,
      "silentTimeout": 900,
      "alertTarget": [
        {
          "name": "默认通知",
          "targets": [
            {
              "status": "critical",
              "to": [
                "notify_example"
              ]
            }
          ]
        }
      ]
    },
    "ruleTimezone": "Asia/Shanghai",
    "score": 0,
    "openPermissionSet": false,
    "permissionSet": [],
    "status": 0,
    "creator": "wsak_example",
    "updator": "wsak_example",
    "createAt": 1785430800,
    "updateAt": 1785430860,
    "deleteAt": -1,
    "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.AlertPolicyNameRepeat 삭제되지 않은 동일 이름 정책이 있거나 짧은 시간 내 동시 생성이 해당 이름을 선점했습니다 알림 정책 이름 중복 먼저 생성되었는지 조회하고, 잠시 기다린 후 이름을 바꿔 재시도할 필요가 있는지 확인하십시오.
400 ft.ParamsValidateError status/member 동작 구조 또는 시간 필드 의존성이 규칙에 맞지 않습니다 파라미터 검증 실패: {} 이 페이지의 해당 모드에 따라 필수 필드를 보완하십시오. custom 날짜에는 customDuration이 필요하며 crontabDuration으로 대체하지 않습니다.
400 ft.InvalidEventStatus status 모드 이벤트 등급이 해당 일반/보안 열거형에 없습니다 유효하지 않은 이벤트 상태: {} 이 페이지의 대문자 ALL 및 올바른 소스 열거형을 사용하고, 쉼표 사이에 공백을 넣지 마십시오.
406 ft.InvalidCrontabFormat 주기 표현식을 파싱할 수 없습니다 유효하지 않은 crontab 형식 유효한 Cron 표현식을 사용하고 crontabDuration을 제공하십시오.
400 ft.ErrorFilterString filterString을 파싱할 수 없습니다 filterString 파싱 실패: {} 먼저 콘솔 필터로 유효한 조건을 생성하거나 예시에 따라 수정하십시오.
400 ft.InvalidCustomNoticeDateUUID 참조한 날짜 구성이 존재하지 않거나 삭제되었거나 현재 워크스페이스에 속하지 않습니다 유효하지 않은 사용자 지정 날짜 UUIDs: {} 사용자 지정 알림 날짜를 통해 유효한 UUID를 다시 가져오십시오.
400 ft.InvalidAggFields byCustom 모드가 아닌데 검증에 맞지 않는 집계 필드를 제공했습니다 유효하지 않은 집계 유형 미리 정의된 필드에서 선택하거나 v2에서 byCustom을 명시적으로 선택하고 실제 비즈니스 필드를 사용하십시오.
400 ft.TagFieldMissing df_label 집계를 선택했지만 비어 있지 않은 aggLabels를 제공하지 않았습니다 태그 누락 실제 태그 값 배열을 제공하십시오.
400 ft.InvalidAggClusterFields CLUSTER를 선택했지만 제목 또는 내용 집계 필드를 제공하지 않았습니다 유효하지 않은 집계 필드 aggClusterFields에 df_title 또는 df_message가 하나 이상 포함되어야 합니다.
400 ft.UnsupportExternalEmail 제한된 워크스페이스 버전에서 status 대상에 외부 이메일을 사용했습니다 무료 플랜 워크스페이스에서는 알림 대상이 외부 이메일인 것을 지원하지 않습니다 현재 워크스페이스 멤버를 선택하거나 버전 및 채널 지원을 확인하십시오.
500 ft.InternalServerError 등급별 반복 알림 상태 등의 값이 직접 예외를 유발했거나 저장/캐시/기타 내부 처리에 실패했습니다 내부 오류 이 페이지의 열거형과 전체 구조로 먼저 자체 점검하고, 저장된 상태를 조회한 후 재시도 여부를 결정하십시오. 지속적으로 실패하면 traceId를 제공하십시오.
404 ft.NotFound 정책이 존재하지 않거나 삭제되었거나 현재 워크스페이스에 속하지 않습니다 비즈니스 라우트를 찾을 수 없음 알림 정책 목록에서 유효한 UUID를 다시 가져오십시오.
403 ft.ForbiddenAlertPolicyOperation 현재 ID가 정책의 사용자 지정 작업 권한을 통과하지 못했습니다 알림 정책【{}】에 대한 작업 권한이 없습니다 생성자, owner 또는 권한을 부여받은 주체가 작업하며, 먼저 permissionSet을 확인하십시오.
403 ft.Forbidden 사용자 지정 권한이 꺼져 있을 때 현재 ID에 인터페이스 작업 권한이 없습니다 작업 권한이 없습니다 작업 권한이 있는 API Key를 사용하십시오.

문서 평가

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