유지보수 잠금, 백업 및 정리

유지보수 잠금은 설정 복원처럼 쓰기를 일시 중지해야 하는 작업에 사용하며, 복원 중 업무 설정과 제어가 계속 변경되지 않도록 합니다.

유지보수 잠금

상태는 OFF → ENTERING → ACTIVE → EXITING → OFF 순서로 전환됩니다. 진입과 종료에 시간이 걸릴 수 있으므로 상태 조회 결과를 기준으로 판단합니다.

잠금 중에는 보호되는 설정 및 제어 쓰기가 거부되며 업무 코드는 200162입니다. 현재 진입/종료 인터페이스를 사용하고 삭제된 Capability 또는 단계별 종료 인터페이스는 사용하지 마세요.

작업	인터페이스
상태 조회	`GET /maintenance/state`
잠금 진입	`POST /maintenance/enter`
잠금 종료	`POST /maintenance/exit`

백업 및 복원

설정 백업으로 현재 설정을 저장합니다.
유지보수 잠금에 진입하고 버전과 일치하는 백업 파일을 업로드합니다.
복원 결과와 캐시 재생성을 확인한 후 잠금을 종료합니다.
템플릿 동기화가 필요하면 지정 UDE 유형 또는 인스턴스에 조정을 수행합니다.

POST /ems-data/backup는 설정 백업을 다운로드하며, POST /ems-data/restore는 multipart의 file 필드로 업로드합니다. 설정 백업은 백업 목록에 따라 저장되며 전체 장치 이미지가 아닙니다. 아카이브 계획과 실행 메타데이터 등이 자체 백업 범위에 포함되었는지 확인해야 합니다.

유형별 정리

일괄 정리는 유형별로 데이터와 설정을 처리하고 관련 캐시를 다시 생성할 수 있습니다. 원본 또는 공유 데이터 정리는 설정과 그룹 매핑에도 영향을 줄 수 있으며, UDE 정리에는 규칙과 생성 결과 목록이 포함됩니다.

선택한 유형과 참조 관계를 먼저 확인한 후 POST /ems-data/batch/clear를 호출합니다. 각 유형은 별도로 실행되므로 다른 유형이 실패해도 성공한 부분은 롤백되지 않습니다. 결과를 항목별로 확인해야 합니다.

일시적인 데이터 추출에는 이력 내보내기, 장기 보존에는 주기적 아카이브를 사용합니다. 실행 매개변수 적용 방식은 실행 설정을 참조하세요.