v2 수정¶
POST /api/v1/alert_policy/{alert_policy_uuid}/modify_v2
개요¶
alert_policy_uuid를 기반으로 지정된 알림 정책의 구성 정보를 수정합니다. v2는 연결된 모니터/지능형 모니터/지능형 점검/SLO 및 보안 모니터링의 동기 업데이트를 지원합니다.
라우팅 매개변수¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| alert_policy_uuid | string | Y | 알림 정책 UUID |
본문 요청 매개변수¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| name | string | 모니터 이름 빈 값 허용: False |
|
| desc | string | 설명 빈 값 허용: False 빈 문자열 허용: True 최대 길이: 256 |
|
| openPermissionSet | boolean | 사용자 정의 권한 구성 활성화 (기본값 false: 비활성화). 활성화 시 해당 규칙의 작업 권한은 permissionSet에 따라 결정됨 빈 값 허용: False |
|
| permissionSet | array | 작업 권한 구성. 역할(소유자 제외), 멤버 UUID, 팀 UUID를 구성할 수 있음 예시: ['wsAdmin', 'acnt_xxxx', 'group_yyyy'] 빈 값 허용: False |
|
| checkerUUIDs | array | 모니터/지능형 모니터/지능형 점검/SLO UUID (2024-12-11 반복 추가) 예시: ['rule_xxx', 'monitor_xxx'] 빈 값 허용: False |
|
| securityRuleUUIDs | array | 보안 모니터링(cspm, siem, aba)의 UUID 예시: ['srul_xxx', 'srul_xxx', 'srul_xxx'] 빈 값 허용: False |
|
| ruleTimezone | str | Y | 알림 정책 시간대 예시: Asia/Shanghai 빈 값 허용: False |
| alertOpt | json | 알림 설정 빈 값 허용: False |
|
| alertOpt.aggType | string | 알림 집계 유형. 이 필드를 전달하지 않으면 기본적으로 이전 버전 로직이 적용됨 (2024-12-25 반복 추가) 빈 값 허용: True 선택 가능 값: ['byFields', 'byCluster', 'byAI', 'byCustom'] |
|
| alertOpt.ignoreOK | boolean | 고급 설정. 정상 등급은 이벤트만 생성하고 알림을 보내지 않음 (OK 알림 무시 여부) (2025-10-22 추가된 필드) 빈 값 허용: False |
|
| alertOpt.alertType | string | 알림 정책 알림 유형. 등급(status)/멤버(member), 기본값은 등급 빈 값 허용: False 선택 가능 값: ['status', 'member'] |
|
| alertOpt.silentTimeout | integer | 반복 알림 구성 빈 값 허용: False |
|
| alertOpt.silentTimeoutByStatusEnable | boolean | 등급별 반복 알림 설정 활성화 여부. 기본값 false이며 silentTimeout 사용 빈 값 허용: False |
|
| alertOpt.silentTimeoutByStatus | array | 등급별 반복 알림 설정. 등급별 최소 알림 간격 구성 빈 값 허용: False |
|
| alertOpt.alertTarget | array | 트리거 작업. 알림 시간의 매개변수 처리에 주의 예시: [{'name': '알림 구성1', 'targets': [{'to': ['acnt_xxxx32'], 'status': 'critical', 'tags': {'pod_name': ['coredns-7769b554cf-w95fk']}, 'upgradeTargets': [{'to': ['acnt_xxxx32'], 'duration': 600}, {'to': ['group_xxxx32'], 'duration': 6000}]}], 'crontabDuration': 600, 'crontab': '0 9 * * 0,1,2,3,4'}, {'name': '알림 구성2', 'targets': [{'status': 'error', 'to': ['group_xxxx32'], 'upgradeTargets': [{'to': ['acnt_xxxx32'], 'duration': 600}, {'to': ['group_xxxx32'], 'duration': 6000}]}], 'customDateUUIDs': ['ndate_xxxx32'], 'customStartTime': '09:30:10', 'crontabDuration': 600}] 빈 값 허용: False |
|
| alertOpt.aggInterval | integer | Y | 알림 집계 간격(초). 0은 집계하지 않음을 의미 빈 값 허용: False $minValue: 0 $maxValue: 1800 |
| alertOpt.aggFields | array | 집계 필드 목록. 빈 목록[]을 유지하면 '집계 규칙: 전체'를 의미함. df_monitor_checker_id: 모니터/지능형 점검/SLO, df_dimension_tags: 검사 차원, df_label: 레이블, CLUSTER: 지능형 집계 예시: ['CLUSTER'] 빈 값 허용: False |
|
| alertOpt.aggLabels | array | 레이블 집계 시 레이블 값 목록. aggFields에 df_label이 지정되어 있어야 적용됨 빈 값 허용: False |
|
| alertOpt.aggClusterFields | array | 지능형 집계 시 필드 목록. aggFields에 CLUSTER가 지정되어 있어야 적용됨. 선택 가능 값 "df_title": 제목, "df_message": 내용 예시: ['df_title'] 빈 값 허용: False |
|
| alertOpt.aggSendFirst | boolean | 집계 시 첫 번째 알림을 직접 전송할지 여부 (2025-09-03 반복 추가된 매개변수) 빈 값 허용: False |
매개변수 추가 설명¶
요청 예시¶
curl 'https://openapi.guance.com/api/v1/alert_policy/altpl_xxxx32/modify' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{"name":"jj_modify","ruleTimezone":"Asia/Shanghai","alertOpt":{"alertTarget":[{"targets":[{"status":"warning","to":["notify_xxxx32"]}]}],"silentTimeout":21600,"aggInterval":120,"aggFields":["df_monitor_checker_id"]}}' \
--compressed
응답¶
{
"code": 200,
"content": {
"alertOpt": {
"aggFields": [
"df_monitor_checker_id"
],
"aggInterval": 120,
"alertTarget": [
{
"targets": [
{
"status": "warning",
"to": [
"notify_xxxx32"
]
}
]
}
],
"silentTimeout": 21600
},
"createAt": 1706152082,
"creator": "xxxx",
"declaration": {},
"deleteAt": -1,
"id": 4100,
"name": "jj_modify",
"ruleTimezone": "Asia/Shanghai",
"score": 0,
"status": 0,
"updateAt": 1706152339.7920609,
"updator": "xxx",
"uuid": "altpl_xxxx32",
"workspaceUUID": "wksp_xxxx32"
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-D38C6668-6F44-45E8-B8A4-BD28EBF142DE"
}