콘텐츠로 이동

조회



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를 제공하십시오.

문서 평가

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