수정 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를 사용하십시오. |