Roll Back Security Configuration API

출처: 문서

본문

보안 구성 롤백 API

3.3에 도입됨 {: .label .label-purple }

이 기능은 실험적인 기능이므로 프로덕션 환경에서 사용하는 것은 권장하지 않아요. 기능 진행 상황에 대한 업데이트를 확인하거나 피드백을 남기고 싶다면 OpenSearch 포럼에서 토론에 참여해 보세요. {: .warning}

보안 구성의 이전 버전을 복원해요. 버전 ID를 지정하면 해당 버전으로 롤백하고, 생략하면 현재 버전 바로 이전 버전으로 롤백해요.

롤백은 사용자, 역할, 역할 매핑, 액션 그룹, 테넌트를 포함한 보안 구성 전체를 교체해요. 롤백하기 전에 Get Security Configuration Versions API로 대상 버전을 조회해서 내용을 확인해 보세요. {: .warning}

롤백 자체도 구성 변경에 해당하기 때문에, OpenSearch는 이를 위해 새 버전을 기록해요. 예를 들어 v6을 실행 중인 클러스터를 v5로 롤백하면 클러스터는 v5 구성 상태를 유지하고 버전 기록에는 v7이 추가돼요.

엔드포인트

POST /_plugins/_security/api/version/rollback
POST /_plugins/_security/api/version/rollback/{version_id}

경로 파라미터

다음 표는 사용 가능한 경로 파라미터를 보여줘요. 모든 경로 파라미터는 선택 사항이에요.

요청 예시

다음 요청은 바로 이전 버전을 복원해요:

POST /_plugins/_security/api/version/rollback

{% include copy-curl.html security=true %}

다음 요청은 v2 버전을 복원해요:

POST /_plugins/_security/api/version/rollback/v2

{% include copy-curl.html security=true %}

응답 예시

응답에는 OpenSearch가 복원한 버전이 표시돼요. v6을 실행 중인 클러스터가 바로 이전 버전으로 롤백하면 다음과 같은 응답을 반환해요:

{
  "status": "OK",
  "message": "config rolled back to version v5"
}

v2를 지정한 요청은 다음과 같은 응답을 반환해요:

{
  "status": "OK",
  "message": "config rolled back to version v2"
}

요청한 버전이 존재하지 않으면 OpenSearch는 404 Not Found를 반환하고 구성은 그대로 유지돼요:

{
  "status": "NOT_FOUND",
  "message": "Version v99 not found"
}

응답 본문 필드

응답 본문은 다음 필드를 가진 JSON 객체예요.

더 알아보기 (Learn more)

• 원문 전체: https://docs.opensearch.org/latest/security/api/configuration-versions/rollback/