조회¶
GET /api/v1/alert_policy/{alert_policy_uuid}/get
개요¶
단일 알림 정책의 원본 구성, 알림 대상 표시 정보 및 바인딩 관계를 조회합니다.
호출 전 및 사용 단계¶
알림 정책 목록에서 uuid를 복사하여 경로에 넣습니다. 이 API는 완전히 저장된 alertOpt, 권한 구성 및 연결 배열을 반환하며, 수정 전에 이를 기준으로 전체 대상 알림 구성을 구성합니다. 일치하는 정책이 없으면 content={}이며 고정 404를 반환하지 않습니다. invalidTargetUUIDs/invalidCustomDateUUIDs는 조회 중 발견된 일부 무효 리소스만 포함하므로, 빈 배열이라고 해서 모든 구성이 유효하다는 의미는 아니며 대상과 실제 실행을 계속 확인해야 합니다. 현재 버전의 최상위 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를 가져옵니다. |
파라미터 추가 설명¶
목록의 refCheckerInfo/refSecurityRuleInfo는 유형별로 그룹화되지만, 본 상세에서는 배열입니다. 동일한 파싱 구조를 재사용하지 마십시오. 조회로 반환된 전체 엔터티를 그대로 요청에 모두 전달할 수 없으며, 본 API에서 선언한 수정 필드만 선택해야 합니다.
요청 예시¶
curl --get 'https://openapi.guance.com/api/v1/alert_policy/altpl_example/get' \
-H 'DF-API-KEY: <DF-API-KEY>'
응답¶
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 | 생성 주체입니다. |
| content.updator | string | 최근 업데이트한 주체입니다. |
| 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> |
저장된 구성: member 모드 일반 알림의 수신 멤버/팀 배열이며 에이전트 계정을 포함할 수 있습니다. targets.to 알림 방식과 조합합니다. |
| content.alertOpt.alertTarget[].alertInfo[].memberInfo[] | string | 저장된 구성: 단일 멤버 또는 팀 식별자입니다. |
| content.alertOpt.alertTarget[].alertInfo[].filterString | string | 저장된 구성: 멤버 그룹 수준 이벤트 필터이며 일반 및 에스컬레이션 액션 모두 이 조건을 사용합니다. |
| content.alertOpt.alertTarget[].alertInfo[].targets | array<object> |
저장된 구성: member 모드의 알림 방식/등급 액션 배열입니다. |
| 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.creatorInfo | object | 신원 표시 정보입니다. 일치하는 항목이 없으면 {}이며, 아래 필드는 신원에 따라 선택적입니다. |
| content.creatorInfo.uuid | string | 계정 UUID이며 생략할 수 있습니다. |
| content.creatorInfo.status | integer | 계정 레코드 상태입니다. |
| content.creatorInfo.wsAccountStatus | integer | 워크스페이스 계정 상태입니다. |
| content.creatorInfo.username | string | 로그인 이름입니다. |
| content.creatorInfo.name | string | 표시 이름입니다. |
| content.creatorInfo.iconUrl | string | 아바타 URL이며 생략할 수 있습니다. |
| content.creatorInfo.email | string | 이메일 또는 시스템 신원 표시 값입니다. |
| content.creatorInfo.mobile | string | 휴대폰 번호이며 비어 있을 수 있습니다. |
| content.creatorInfo.countryCode | string | 국가/지역 코드이며 생략할 수 있습니다. |
| content.creatorInfo.acntWsNickname | string | 워크스페이스 닉네임이며 생략할 수 있습니다. |
| content.updatorInfo | object | 신원 표시 정보입니다. 일치하는 항목이 없으면 {}이며, 아래 필드는 신원에 따라 선택적입니다. |
| content.updatorInfo.uuid | string | 계정 UUID이며 생략할 수 있습니다. |
| content.updatorInfo.status | integer | 계정 레코드 상태입니다. |
| content.updatorInfo.wsAccountStatus | integer | 워크스페이스 계정 상태입니다. |
| content.updatorInfo.username | string | 로그인 이름입니다. |
| content.updatorInfo.name | string | 표시 이름입니다. |
| content.updatorInfo.iconUrl | string | 아바타 URL이며 생략할 수 있습니다. |
| content.updatorInfo.email | string | 이메일 또는 시스템 신원 표시 값입니다. |
| content.updatorInfo.mobile | string | 휴대폰 번호이며 비어 있을 수 있습니다. |
| content.updatorInfo.countryCode | string | 국가/지역 코드이며 생략할 수 있습니다. |
| content.updatorInfo.acntWsNickname | string | 워크스페이스 닉네임이며 생략할 수 있습니다. |
| content.permissionSetInfo | object | permissionSet이 있을 때 제공되며, 주체 식별자를 키로 하는 표시 자료 매핑입니다. 일치하는 주체가 없으면 {}일 수 있습니다. |
| content.permissionSetInfo.식별자 | object | 계정이면 계정 프로필이며, 역할/팀은 일반적으로 name과 status입니다. |
| content.permissionSetInfo.식별자.uuid | string | 계정 UUID이며 생략할 수 있습니다. |
| content.permissionSetInfo.식별자.status | integer | 계정 레코드 상태입니다. |
| content.permissionSetInfo.식별자.wsAccountStatus | integer | 워크스페이스 계정 상태입니다. |
| content.permissionSetInfo.식별자.username | string | 로그인 이름입니다. |
| content.permissionSetInfo.식별자.name | string | 표시 이름입니다. |
| content.permissionSetInfo.식별자.iconUrl | string | 아바타 URL이며 생략할 수 있습니다. |
| content.permissionSetInfo.식별자.email | string | 이메일 또는 시스템 신원 표시 값입니다. |
| content.permissionSetInfo.식별자.mobile | string | 휴대폰 번호이며 비어 있을 수 있습니다. |
| content.permissionSetInfo.식별자.countryCode | string | 국가/지역 코드이며 생략할 수 있습니다. |
| content.permissionSetInfo.식별자.acntWsNickname | string | 워크스페이스 닉네임이며 생략할 수 있습니다. |
| content.allow_operation | boolean 또는 null | 사용자 지정 작업 권한 판단입니다. null은 비활성화되었음을 의미하며, 여전히 API 권한에 따라 판단해야 합니다. true/false는 현재 신원의 사용자 지정 판단 결과입니다. |
| content.invalidCustomDateUUIDs | array<string> |
조회에서 삭제된 날짜 구성 UUID입니다. 조회되지 않은 참조가 모두 포함된다고 보장하지 않습니다. |
| content.invalidCustomDateUUIDs[] | string | 단일 날짜 구성 UUID입니다. |
| content.invalidTargetUUIDs | array<string> |
조회에서 상태가 무효로 확인된 계정, 팀 또는 알림 대상 식별자입니다. 모든 누락 대상을 포함한다고 보장하지 않습니다. |
| content.invalidTargetUUIDs[] | string | 단일 대상 식별자입니다. |
| content.notifyObjectName | object | 대상 식별자에서 표시 이름으로의 매핑이며, 멤버, 팀 및 이메일/채널을 포함할 수도 있습니다. |
| content.notifyObjectName.식별자 | string | 대응하는 표시 이름입니다. |
| content.notifyObjectInfos | object | 대상 식별자에서 대상 프로필로의 매핑이며, 필드는 계정/팀/알림 대상/이메일 채널에 따라 달라집니다. |
| content.notifyObjectInfos.식별자 | object | 계정은 전체 요약을 가질 수 있고, 팀/알림 대상은 주로 uuid/name/status를 가지며, 이메일 채널은 주로 name/email/status를 가집니다. |
| content.notifyObjectInfos.식별자.uuid | string | 계정 UUID이며 생략할 수 있습니다. |
| content.notifyObjectInfos.식별자.status | integer | 계정 레코드 상태입니다. |
| content.notifyObjectInfos.식별자.wsAccountStatus | integer | 워크스페이스 계정 상태입니다. |
| content.notifyObjectInfos.식별자.username | string | 로그인 이름입니다. |
| content.notifyObjectInfos.식별자.name | string | 표시 이름입니다. |
| content.notifyObjectInfos.식별자.iconUrl | string | 아바타 URL이며 생략할 수 있습니다. |
| content.notifyObjectInfos.식별자.email | string | 이메일 또는 시스템 신원 표시 값입니다. |
| content.notifyObjectInfos.식별자.mobile | string | 휴대폰 번호이며 비어 있을 수 있습니다. |
| content.notifyObjectInfos.식별자.countryCode | string | 국가/지역 코드이며 생략할 수 있습니다. |
| content.notifyObjectInfos.식별자.acntWsNickname | string | 워크스페이스 닉네임이며 생략할 수 있습니다. |
| content.customDateName | object | 날짜 구성 UUID에서 이름으로의 매핑입니다. |
| content.customDateName.날짜UUID | string | 날짜 구성 이름입니다. |
| content.refCheckerInfo | array<object> |
플랫 모니터/SLO 바인딩 배열입니다. |
| content.refCheckerInfo[].uuid | string | 모니터/SLO UUID입니다. |
| content.refCheckerInfo[].name | string | 모니터/SLO 이름입니다. |
| content.refCheckerInfo[].type | string | trigger/self_built_trigger/smartMonitor/aiMonitor/slo 등의 유형입니다. |
| content.refCheckerInfo[].status | integer | 레코드 활성화/비활성화 상태입니다. |
| content.refCheckerInfo[].jsonScript | object | 모니터가 있을 때의 유형 요약이며, SLO에서는 생략할 수 있습니다. |
| content.refCheckerInfo[].jsonScript.type | string 또는 null | 모니터 감지 유형 요약입니다. |
| content.refSecurityRuleInfo | array<object> |
플랫 보안 규칙 바인딩 배열입니다. |
| content.refSecurityRuleInfo[].uuid | string | 보안 규칙 UUID입니다. |
| content.refSecurityRuleInfo[].name | string | 보안 규칙 이름입니다. |
| content.refSecurityRuleInfo[].type | string | 보안 규칙 유형입니다(예: cspm/siem/aba). |
| content.refSecurityRuleInfo[].status | integer | 규칙 상태입니다. 원본 관계에는 삭제된 규칙이 포함될 수 있습니다. |
| 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": "",
"createAt": 1785430800,
"updateAt": -1,
"deleteAt": -1,
"invalidCustomDateUUIDs": [],
"invalidTargetUUIDs": [],
"notifyObjectName": {
"notify_example": "프로덕션 봇"
},
"notifyObjectInfos": {
"notify_example": {
"uuid": "notify_example",
"name": "프로덕션 봇",
"status": 0
}
},
"customDateName": {},
"creatorInfo": {},
"updatorInfo": {},
"allow_operation": null,
"refCheckerInfo": [],
"refSecurityRuleInfo": [],
"declaration": {}
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
정책을 찾지 못한 경우
{
"code": 200,
"content": {},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
오류 응답¶
인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참조하십시오.
| HTTP 상태 | errorCode | 발생 조건 | 메시지 또는 응답 설명 | 처리 방법 |
|---|---|---|---|---|
| 500 | ft.InternalServerError | 정책 및 관련 자료 조회 실패 | 내부 오류 | 잠시 후 다시 시도하고, 계속 실패하면 traceId를 제공하십시오. |