스냅샷 복제 API

스냅샷 복제 API (Clone Snapshot API)

스냅샷의 전체 또는 일부를 원본과 같은 저장소에 복제해요.

도입 버전 1.0

엔드포인트

PUT /_snapshot/{repository}/{snapshot}/_clone/{target_snapshot}

경로 파라미터

다음 표는 사용 가능한 경로 파라미터를 보여줘요.

파라미터 필수 여부 데이터 타입 설명
repository 필수 String 스냅샷 복제본이 들어갈 저장소의 이름이에요.
snapshot 필수 String 복제할 원본 스냅샷의 이름이에요.
target_snapshot 필수 String 복제된 스냅샷의 이름이에요.

쿼리 파라미터

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

파라미터 데이터 타입 설명
cluster_manager_timeout String 클러스터 매니저 노드로부터 응답을 기다리는 시간이에요. 지원되는 시간 단위에 대한 자세한 내용은 Common parameters 를 참고하세요.

예제 요청

다음 요청은 스냅샷 저장소 my-opensearch-repo에 있는 스냅샷 my_snapshot에서 index_a와 index_b 인덱스를 복제해, 같은 저장소에 my_new_snapshot이라는 새 스냅샷으로 만들어요:

PUT /_snapshot/my-opensearch-repo/my_snapshot/_clone/my_new_snapshot
{
	"indices" : "index_a,index_b"
}

예제 응답

스냅샷 복제본 생성이 성공하면 다음 응답이 반환돼요:

{ 
    "acknowledged" : true
}

필요한 권한

Security 플러그인을 사용한다면 적절한 권한이 있는지 확인하세요: cluster:admin/snapshot/clone.

출처: 문서