본문으로 건너뛰기

Retention

데이터 보존 정책을 관리하고 실행하는 API입니다. 테이블별 보존 기간 설정 및 만료 데이터 자동 삭제 기능을 제공합니다.

엔드포인트

POST /api/v1/retention/policies

설명: 새 보존 정책을 생성합니다. (HTTP 201)

요청 본문:

필드타입필수설명
namestringY정책 이름
tablestringY대상 테이블 (정규화된 이름)
retention_daysintY보존 기간 (일)
actionstringY만료 시 액션 (delete, archive 등)

GET /api/v1/retention/policies

설명: 보존 정책 목록을 반환합니다.

GET /api/v1/retention/policies/{policy_id}

설명: 특정 보존 정책의 상세 정보를 반환합니다.

PUT /api/v1/retention/policies/{policy_id}

설명: 보존 정책을 수정합니다.

DELETE /api/v1/retention/policies/{policy_id}

설명: 보존 정책을 삭제합니다. (HTTP 204)

POST /api/v1/retention/policies/{policy_id}/execute

설명: 보존 정책을 즉시 실행합니다. 만료 데이터가 삭제/아카이브됩니다.

인증

JWT Bearer 토큰이 필요합니다.

에러 코드

코드설명
400잘못된 보존 기간 또는 액션
404정책을 찾을 수 없음
500정책 실행 실패