1개의 cluster에 대해 1개의 작업 복원 만들기

이 페이지의 내용

Resource

요청 경로 매개변수
요청 쿼리 매개변수
요청 본문 매개변수
응답
응답 문서
results embeddedDocument
요청 예시
응답 예시
응답 헤더
응답 본문

Cloud Manager는 2024년 8월 30일부터 더 이상 MongoDB 3.6 및 4.0에 대한 자동화, 백업 및 모니터링을 지원하지 않습니다. MongoDB 배포를 업그레이드하거나 Atlas로 마이그레이션하세요.

Cloud Manager 에 대한 프로그래밍 방식의 액세스 를 위한 OAuth 2.0 인증 은 Preview 기능 으로 제공됩니다.: 기능 및 해당 설명서는 미리 보기 기간에 언제든지 변경될 수 있습니다. OAuth 2.0 인증 을 사용하려면 Cloud Manager 공개 API 에 대한 요청에 사용할서비스 계정을 만듭니다.

기본 URL: https://cloud.mongodb.com/api/public/v1.0

Resource

POST /groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs

요청 경로 매개변수

이름	유형	설명
`PROJECT-ID`	문자열	작업을 소유한 프로젝트의 고유 식별자입니다.
`CLUSTER-ID`	문자열	작업이 나타내는 cluster의 고유 식별자입니다.

요청 쿼리 매개변수

다음 쿼리 매개변수는 선택 사항입니다.

이름

유형

필요성

설명

기본값

pretty

부울

옵션

응답 본문을 프리티프린트 에 포함해야 하는지 여부를 나타내는 플래그입니다. 형식.

false

envelope

부울

옵션

응답을 엔벨로프에 래핑할지 여부를 나타내는 플래그입니다.

일부 API 클라이언트는 HTTP 응답 헤더 또는 상태 코드에 액세스할 수 없습니다. 이 문제를 해결하려면 쿼리에서 envelope=true를 설정합니다.

하나의 결과를 반환하는 엔드포인트의 경우 응답 본문에는 다음이 포함됩니다.

이름	설명
`status`	HTTP 응답 코드
`content`	예상되는 응답 본문

false

요청 본문 매개변수

이름	유형	필요성	설명
`delivery`	객체	필수 사항	복원된 스냅샷 데이터를 전달하는 방법 및 방법에 대한 세부 정보입니다.
`delivery` `.expires`	문자열	조건부	ISO 8601 의 타임스탬프 날짜 및 시간 형식(UTC 기준 ) 이후에는 URL 을 더 이상 사용할 수 없습니다. `delivery.expires` 을 설정하면 `delivery.expirationHours` 을 설정할 수 없습니다.
`delivery` `.expirationHours`	숫자	조건부	복원 작업이 완료된 후 다운로드 URL 이 유효한 시간 수입니다. `delivery.expirationHours` 을 설정하면 `delivery.expires` 을 설정할 수 없습니다.
`delivery` `.maxDownloads`	숫자	필수 사항	다운로드 URL 을 사용할 수 있는 횟수입니다. 이 값은 `1` 이상이어야 합니다.
`delivery` `.methodName`	문자열	필수 사항	Cloud Manager가 데이터를 전달하는 수단입니다. `HTTP` 로 설정합니다.
`snapshotId`	문자열	필수 사항	복원할 스냅샷 의 고유 식별자입니다.

참고

조건

"delivery.methodName" : AUTOMATED_RESTORE" 을 설정하다 하는 경우 delivery.targetGroupId 및 delivery.targetClusterId 을 설정하다 해야 합니다.

스냅샷 에서 자동 복원 을 만듭니다.

이름	유형	필요성	설명
`delivery`	객체	필수 사항	복원된 스냅샷 데이터를 전달하는 방법 및 방법에 대한 세부 정보입니다.
`delivery` `.methodName`	문자열	필수 사항	Cloud Manager가 데이터를 전달하는 수단입니다. `AUTOMATED_RESTORE` 로 설정합니다. 응답에 `"delivery.methodName" : "HTTP"` 이 표시됩니다. 자동 복원 은 `HTTP` 메서드를 사용하여 대상 호스팅하다 에 복원 작업 을 전달합니다. 중요: SCP 를 통한 복원 전달은 27, 2018 부터 제거되었습니다.
`delivery` `.targetClusterId`	문자열	필수 사항	대상 cluster의 고유 식별자입니다. 모든 스냅샷 가져오기 및 스냅샷 가져오기 엔드포인트의 응답 본문에 반환된 `clusterId` 를 사용합니다. 대상 cluster에서 백업이 활성화되어 있지 않은 경우, 모든 스냅샷 가져오기 엔드포인트는 `clusterId` 요소가 없는 빈 `results` 배열을 반환 하며 스냅샷 가져오기 엔드포인트도 `clusterId` 요소를 반환하지 않습니다.
`delivery` `.targetGroupId`	문자열	필수 사항	복원 job의 대상 cluster가 포함된 프로젝트의 고유 식별자입니다.
`snapshotId`	문자열	필수 사항	복원할 스냅샷 의 고유 식별자입니다.

oplog 타임스탬프에서 자동 복원 을 생성합니다.

oplog oplog 복원은 MongoDB 버전을 사용하는 MongoDB 복제본 세트 또는 이상을 사용하는 샤드 FCV 4.2 클러스터에서 작동합니다.

이름	유형	필요성	설명
`delivery`	객체	필수 사항	복원된 스냅샷 데이터를 전달하는 방법 및 방법에 대한 세부 정보입니다.
`delivery` `.methodName`	문자열	필수 사항	Cloud Manager가 데이터를 전달하는 수단입니다. `AUTOMATED_RESTORE` 로 설정합니다. 응답에 `"delivery.methodName" : "HTTP"` 이 표시됩니다. 자동 복원 은 `HTTP` 메서드를 사용하여 대상 호스팅하다 에 복원 작업 을 전달합니다. 중요: SCP 를 통한 복원 전달은 27, 2018 부터 제거되었습니다.
`delivery` `.targetClusterId`	문자열	필수 사항	대상 cluster의 고유 식별자입니다. 모든 스냅샷 가져오기 및 스냅샷 가져오기 엔드포인트의 응답 본문에 반환된 `clusterId` 를 사용합니다. 대상 cluster에서 백업이 활성화되어 있지 않은 경우, 모든 스냅샷 가져오기 엔드포인트는 `clusterId` 요소가 없는 빈 `results` 배열을 반환 하며 스냅샷 가져오기 엔드포인트도 `clusterId` 요소를 반환하지 않습니다.
`delivery` `.targetGroupId`	문자열	필수 사항	복원 job의 대상 cluster가 포함된 프로젝트의 고유 식별자입니다.
`oplogTs`	문자열	필수 사항	유닉스 oplog 시간 이후 경과된 시간(초)을 타임 스탬프 로 표시한 타임스탬프 . `oplogInc` 와 함께 사용하면 데이터가 복원되는 시점을 나타냅니다. 복제본 세트 에서 `local.oplog.rs` 에 대한 쿼리를 실행하여 원하는 타임스탬프를 찾습니다. 이 설정을 제공하면 이 엔드포인트는 이 Oplog 타임스탬프를 포함한 모든 데이터를 `delivery` 객체에 지정한 데이터베이스에 복원합니다.
`oplogInc`	문자열	필수 사항	주어진 초 내의 작업을 나타내는 32비트 증분 서수입니다. `oplogTs` 과 함께 쌍을 이루는 경우 데이터가 복원되는 점을 나타냅니다. 이 설정을 제공하면 이 엔드포인트는 이 Oplog 타임스탬프를 포함한 모든 데이터를 `delivery` 객체에 지정한 데이터베이스에 복원합니다.

특정 점 부터 자동 복원 을 생성합니다.

PIT 복원은 모든 MongoDB 버전을 사용하는 복제본 세트 또는 이상을 사용하는 샤드 클러스터에서 FCV 4.2 작동합니다.

이름	유형	필요성	설명
`delivery`	객체	필수 사항	복원된 스냅샷 데이터를 전달하는 방법 및 방법에 대한 세부 정보입니다.
`delivery` `.methodName`	문자열	필수 사항	Cloud Manager가 데이터를 전달하는 수단입니다. `AUTOMATED_RESTORE` 로 설정합니다. 응답에 `"delivery.methodName" : "HTTP"` 이 표시됩니다. 자동 복원 은 `HTTP` 메서드를 사용하여 대상 호스팅하다 에 복원 작업 을 전달합니다. 중요: SCP 를 통한 복원 전달은 27, 2018 부터 제거되었습니다.
`delivery` `.targetClusterId`	문자열	필수 사항	대상 cluster의 고유 식별자입니다. 모든 스냅샷 가져오기 및 스냅샷 가져오기 엔드포인트의 응답 본문에 반환된 `clusterId` 를 사용합니다. 대상 cluster에서 백업이 활성화되어 있지 않은 경우, 모든 스냅샷 가져오기 엔드포인트는 `clusterId` 요소가 없는 빈 `results` 배열을 반환 하며 스냅샷 가져오기 엔드포인트도 `clusterId` 요소를 반환하지 않습니다.
`delivery` `.targetGroupId`	문자열	필수 사항	복원 job의 대상 cluster가 포함된 프로젝트의 고유 식별자입니다.
`pointInTimeUTCMillis`	long	필수 사항	유닉스 시간 이후 경과된 밀리초 수의 타임스탬프 '는 데이터가 복원될 시점을 나타냅니다. 이 타임스탬프는 현재 시간에서 지난 24 시간 이내여야 합니다. 이 설정을 제공하면 이 엔드포인트는 이 시점 까지의 모든 데이터를 `delivery` 객체에서 지정한 데이터베이스로 복원합니다.

체크포인트 에서 자동 복원 을 만듭니다. 체크포인트 복원은 이하의 MongoDB cluster를 실행 샤딩된 클러스터 FCV 4.0 에서 작동합니다.

중요

FCV 이상이 4.2 설치된 MongoDB 클러스터에는 체크포인트 복원을 사용하지 마세요.

이름	유형	필요성	설명
`checkpointId`	문자열	필수 사항	데이터가 복원될 시점을 나타내는 샤드 클러스터 체크포인트의 고유 식별자입니다. 이 설정을 제공하면 이 엔드포인트는 이 체크포인트 까지의 모든 데이터를 `delivery` 객체에서 지정한 데이터베이스에 복원합니다.
`delivery`	객체	필수 사항	복원된 스냅샷 데이터를 전달하는 방법 및 방법에 대한 세부 정보입니다.
`delivery` `.methodName`	문자열	필수 사항	Cloud Manager가 데이터를 전달하는 수단입니다. `AUTOMATED_RESTORE` 로 설정합니다. 응답에 `"delivery.methodName" : "HTTP"` 이 표시됩니다. 자동 복원 은 `HTTP` 메서드를 사용하여 대상 호스팅하다 에 복원 작업 을 전달합니다.
`delivery` `.targetClusterId`	문자열	필수 사항	대상 cluster의 고유 식별자입니다. 모든 스냅샷 가져오기 및 스냅샷 가져오기 엔드포인트의 응답 본문에 반환된 `clusterId` 를 사용합니다. 대상 cluster에서 백업이 활성화되어 있지 않은 경우, 모든 스냅샷 가져오기 엔드포인트는 `clusterId` 요소가 없는 빈 `results` 배열을 반환 하며 스냅샷 가져오기 엔드포인트도 `clusterId` 요소를 반환하지 않습니다.
`delivery` `.targetGroupId`	문자열	필수 사항	복원 job의 대상 cluster가 포함된 프로젝트의 고유 식별자입니다.

응답

응답 문서

응답 JSON 문서에는 result 객체 배열, link 객체 배열, 조회된 result 객체의 총 개수가 포함되어 있습니다.

이름	유형	설명
`results`	배열	배열에는 `results` 내장된 문서 섹션에 자세히 설명된 각 항목에 대해 하나의 객체가 포함됩니다.
`links`	배열	배열에 하위 리소스 및/또는 관련 리소스에 대한 링크가 하나 이상 포함되어 있습니다. URL간의 관계는 웹 링크 사양에설명되어 있습니다.
`totalCount`	숫자	결과 집합에 있는 총 항목 수의 정수 개수입니다. 전체 결과 집합이 페이지로 매겨진 경우 results 배열의 객체 수보다 클 수 있습니다.

`results` embeddedDocument

각 결과 는 하나의 cluster 복원 작업입니다. 이 배열에는 하나의 복원 작업만 포함됩니다.

이름	유형	설명
`batchId`	문자열	이 복원 작업이 속한 배치 의 고유 식별자입니다. 스냅샷이 샤드 cluster에서 가져온 경우 반환됩니다.
`clusterId`	문자열	복원 작업이 나타내는 클러스터 의 고유 식별자입니다. 스냅샷이 복제본 세트 또는 샤드 클러스터에서 가져온 경우 반환됩니다.
`created`	문자열	ISO 8601 의 타임스탬프 복원 작업이 요청된 시점의 UTC 날짜 및 시간 형식입니다.
`delivery`	객체	복원된 스냅샷 데이터를 전달하는 방법 및 방법에 대한 세부 정보입니다.
`delivery` `.expirationHours`	숫자	복원 작업이 완료된 후 다운로드 URL 이 유효한 시간 수입니다.
`delivery` `.expires`	문자열	ISO 8601 의 타임스탬프 날짜 및 시간 형식(UTC 기준 ) 이후에는 URL 을 더 이상 사용할 수 없습니다.
`delivery` `.maxDownloads`	숫자	다운로드 URL 을 사용할 수 있는 횟수입니다. 이 값은 `1` 이상이어야 합니다.
`delivery` `.methodName`	문자열	데이터가 전달되는 수단입니다. `HTTP` 을 반환합니다.
`delivery` `.statusName`	문자열	다운로드 가능한 파일의 현재 상태입니다. 허용되는 값은 다음과 같습니다. `NOT_STARTED` `IN_PROGRESS` `READY` `FAILED` `INTERRUPTED` `EXPIRED` `MAX_DOWNLOADS_EXCEEDED`
`delivery` `.url`	문자열	복원된 스냅샷 데이터를 다운로드할 수 있는 URL입니다.
`encryptionEnabled`	부울	스냅샷이 암호화되었는지 여부를 나타내는 플래그입니다.
`groupId`	문자열	복원 작업을 소유한 그룹 의 고유 식별자입니다.
`hashes`	객체 배열	해당 `delivery.url` 가 다운로드된 경우 이 배열은 `.tar.gz` 파일의 해시를 나타내는 단일 객체를 반환합니다.
`hashes` `.fileName`	문자열	해시된 스냅샷 파일의 이름입니다.
`hashes` `.hash`	문자열	스냅샷 파일의 해시입니다.
`hashes` `.typeName`	문자열	해시 값을 계산하는 데 사용되는 해싱 알고리즘입니다. 반환되면 값은 `SHA1` 로 설정됩니다.
`hostId`	문자열	이 복원 작업 이 속한 config 서버 의 고유 식별자입니다. config 서버 가 SCCC 인 경우 반환됩니다.
`id`	문자열	복원 작업의 고유 식별자입니다.
`links`	객체 배열	하위 리소스 및/또는 관련 리소스에 대한 하나 이상의 링크입니다. 응답의 모든 `links` 배열에는 `self` 이라는 링크가 하나 이상 포함되어 있습니다. URL간의 관계는 웹 링크 사양에설명되어 있습니다.
`masterKeyUUID`	문자열	스냅샷 데이터를 암호화하는 데 사용되는 KMIP 마스터 키 ID 입니다. `"encryptionEnabled" : true` 인 경우 반환됩니다.
`pointInTime`	부울	스냅샷이 점에서 생성된 것인지 여부를 나타내는 플래그입니다.
`snapshotId`	문자열	복원할 스냅샷 의 고유 식별자입니다.
`statusName`	문자열	작업의 현재 상태입니다. 허용되는 값은 다음과 같습니다. `FINISHED` `IN_PROGRESS` `BROKEN` `KILLED`
`timestamp`	객체	스냅샷이 생성되었을 때 Oplog 항목의 타임스탬프입니다.
`timestamp` `.date`	문자열	ISO 8601 의 타임스탬프 복원된 스냅샷에 있는 최신 oplog 항목의 UTC 날짜 및 시간 형식입니다.
`timestamp` `.increment`	문자열	복원된 스냅샷의 가장 최근 oplog 항목에서 완료된 모든 작업의 순서입니다.

이름	유형	설명
`batchId`	문자열	이 복원 작업이 속한 배치 의 고유 식별자입니다. 스냅샷이 샤드 cluster에서 가져온 경우 반환됩니다.
`clusterId`	문자열	복원 작업이 나타내는 클러스터 의 고유 식별자입니다. 스냅샷이 복제본 세트 또는 샤드 클러스터에서 가져온 경우 반환됩니다.
`created`	문자열	ISO 8601 의 타임스탬프 복원 작업이 요청된 시점의 UTC 날짜 및 시간 형식입니다.
`delivery`	객체	복원된 스냅샷 데이터를 전달하는 방법 및 방법에 대한 세부 정보입니다.
`delivery` `.methodName`	문자열	데이터가 전달되는 수단입니다. `HTTP` 을 반환합니다.
`delivery` `.targetClusterId`	문자열	복원 작업 을 수행할 대상 클러스터 의 고유 식별자입니다.
`delivery` `.targetGroupId`	문자열	복원 job의 대상 cluster가 포함된 프로젝트의 고유 식별자입니다.
`encryptionEnabled`	부울	스냅샷이 암호화되었는지 여부를 나타내는 플래그입니다.
`groupId`	문자열	복원 작업을 소유한 그룹 의 고유 식별자입니다.
`hostId`	문자열	이 복원 작업 이 속한 config 서버 의 고유 식별자입니다. config 서버 가 SCCC 인 경우 반환됩니다.
`id`	문자열	복원 작업의 고유 식별자입니다.
`links`	객체 배열	하위 리소스 및/또는 관련 리소스에 대한 하나 이상의 링크입니다. 응답의 모든 `links` 배열에는 `self` 이라는 링크가 하나 이상 포함되어 있습니다. URL간의 관계는 웹 링크 사양에설명되어 있습니다.
`masterKeyUUID`	문자열	스냅샷 데이터를 암호화하는 데 사용되는 KMIP 마스터 키 ID 입니다. `"encryptionEnabled" : true` 인 경우 반환됩니다.
`pointInTime`	부울	스냅샷이 점에서 생성된 것인지 여부를 나타내는 플래그입니다.
`snapshotId`	문자열	복원할 스냅샷 의 고유 식별자입니다.
`statusName`	문자열	작업의 현재 상태입니다. 허용되는 값은 다음과 같습니다. `FINISHED` `IN_PROGRESS` `BROKEN` `KILLED`
`timestamp`	객체	스냅샷이 생성되었을 때 Oplog 항목의 타임스탬프입니다.
`timestamp` `.date`	문자열	ISO 8601 의 타임스탬프 복원된 스냅샷에 있는 최신 oplog 항목의 UTC 날짜 및 시간 형식입니다.
`timestamp` `.increment`	문자열	복원된 스냅샷의 가장 최근 oplog 항목에서 완료된 모든 작업의 순서입니다.

이름	유형	설명
`batchId`	문자열	이 복원 작업이 속한 배치 의 고유 식별자입니다. 스냅샷이 샤드 cluster에서 가져온 경우 반환됩니다.
`clusterId`	문자열	복원 작업이 나타내는 클러스터 의 고유 식별자입니다. 스냅샷이 복제본 세트 또는 샤드 클러스터에서 가져온 경우 반환됩니다.
`created`	문자열	ISO 8601 의 타임스탬프 복원 작업이 요청된 시점의 UTC 날짜 및 시간 형식입니다.
`delivery`	객체	복원된 스냅샷 데이터를 전달하는 방법 및 방법에 대한 세부 정보입니다.
`delivery` `.methodName`	문자열	데이터가 전달되는 수단입니다. `HTTP` 을 반환합니다.
`delivery` `.targetClusterId`	문자열	복원 작업 을 수행할 대상 클러스터 의 고유 식별자입니다.
`delivery` `.targetGroupId`	문자열	복원 job의 대상 cluster가 포함된 프로젝트의 고유 식별자입니다.
`encryptionEnabled`	부울	스냅샷이 암호화되었는지 여부를 나타내는 플래그입니다.
`groupId`	문자열	복원 작업을 소유한 그룹 의 고유 식별자입니다.
`hostId`	문자열	이 복원 작업 이 속한 config 서버 의 고유 식별자입니다. config 서버 가 SCCC 인 경우 반환됩니다.
`id`	문자열	복원 작업의 고유 식별자입니다.
`links`	객체 배열	하위 리소스 및/또는 관련 리소스에 대한 하나 이상의 링크입니다. 응답의 모든 `links` 배열에는 `self` 이라는 링크가 하나 이상 포함되어 있습니다. URL간의 관계는 웹 링크 사양에설명되어 있습니다.
`masterKeyUUID`	문자열	스냅샷 데이터를 암호화하는 데 사용되는 KMIP 마스터 키 ID 입니다. `"encryptionEnabled" : true` 인 경우 반환됩니다.
`pointInTime`	부울	스냅샷이 점에서 생성된 것인지 여부를 나타내는 플래그입니다.
`snapshotId`	문자열	복원할 스냅샷 의 고유 식별자입니다.
`statusName`	문자열	작업의 현재 상태입니다. 허용되는 값은 다음과 같습니다. `FINISHED` `IN_PROGRESS` `BROKEN` `KILLED`
`timestamp`	객체	스냅샷이 생성되었을 때 Oplog 항목의 타임스탬프입니다.
`timestamp` `.date`	문자열	ISO 8601 의 타임스탬프 복원된 스냅샷에 있는 최신 oplog 항목의 UTC 날짜 및 시간 형식입니다.
`timestamp` `.increment`	문자열	복원된 스냅샷의 가장 최근 oplog 항목에서 완료된 모든 작업의 순서입니다.

이름	유형	설명
`batchId`	문자열	이 복원 작업이 속한 배치 의 고유 식별자입니다. 스냅샷이 샤드 cluster에서 가져온 경우 반환됩니다.
`clusterId`	문자열	복원 작업이 나타내는 클러스터 의 고유 식별자입니다. 스냅샷이 복제본 세트 또는 샤드 클러스터에서 가져온 경우 반환됩니다.
`created`	문자열	ISO 8601 의 타임스탬프 복원 작업이 요청된 시점의 UTC 날짜 및 시간 형식입니다.
`delivery`	객체	복원된 스냅샷 데이터를 전달하는 방법 및 방법에 대한 세부 정보입니다.
`delivery` `.methodName`	문자열	데이터가 전달되는 수단입니다. `HTTP` 을 반환합니다.
`delivery` `.targetClusterId`	문자열	복원 작업 을 수행할 대상 클러스터 의 고유 식별자입니다.
`delivery` `.targetGroupId`	문자열	복원 job의 대상 cluster가 포함된 프로젝트의 고유 식별자입니다.
`encryptionEnabled`	부울	스냅샷이 암호화되었는지 여부를 나타내는 플래그입니다.
`groupId`	문자열	복원 작업을 소유한 그룹 의 고유 식별자입니다.
`hostId`	문자열	이 복원 작업 이 속한 config 서버 의 고유 식별자입니다. config 서버 가 SCCC 인 경우 반환됩니다.
`id`	문자열	복원 작업의 고유 식별자입니다.
`links`	객체 배열	하위 리소스 및/또는 관련 리소스에 대한 하나 이상의 링크입니다. 응답의 모든 `links` 배열에는 `self` 이라는 링크가 하나 이상 포함되어 있습니다. URL간의 관계는 웹 링크 사양에설명되어 있습니다.
`masterKeyUUID`	문자열	스냅샷 데이터를 암호화하는 데 사용되는 KMIP 마스터 키 ID 입니다. `"encryptionEnabled" : true` 인 경우 반환됩니다.
`pointInTime`	부울	스냅샷이 점에서 생성된 것인지 여부를 나타내는 플래그입니다.
`snapshotId`	문자열	복원할 스냅샷 의 고유 식별자입니다.
`statusName`	문자열	작업의 현재 상태입니다. 허용되는 값은 다음과 같습니다. `FINISHED` `IN_PROGRESS` `BROKEN` `KILLED`
`timestamp`	객체	스냅샷이 생성되었을 때 Oplog 항목의 타임스탬프입니다.
`timestamp` `.date`	문자열	ISO 8601 의 타임스탬프 복원된 스냅샷에 있는 최신 oplog 항목의 UTC 날짜 및 시간 형식입니다.
`timestamp` `.increment`	문자열	복원된 스냅샷의 가장 최근 oplog 항목에서 완료된 모든 작업의 순서입니다.

이름	유형	설명
`batchId`	문자열	이 복원 작업이 속한 배치 의 고유 식별자입니다. 스냅샷이 샤드 cluster에서 가져온 경우 반환됩니다.
`checkpointId`	문자열	데이터가 복원될 시점을 나타내는 샤드 클러스터 체크포인트의 고유 식별자입니다.
`clusterId`	문자열	복원 작업이 나타내는 클러스터 의 고유 식별자입니다. 스냅샷이 복제본 세트 또는 샤드 클러스터에서 가져온 경우 반환됩니다.
`created`	문자열	ISO 8601 의 타임스탬프 복원 작업이 요청된 시점의 UTC 날짜 및 시간 형식입니다.
`delivery`	객체	복원된 스냅샷 데이터를 전달하는 방법 및 방법에 대한 세부 정보입니다.
`delivery` `.methodName`	문자열	데이터가 전달되는 수단입니다. `HTTP` 을 반환합니다.
`delivery` `.targetClusterId`	문자열	복원 작업 을 수행할 대상 클러스터 의 고유 식별자입니다.
`delivery` `.targetGroupId`	문자열	복원 job의 대상 cluster가 포함된 프로젝트의 고유 식별자입니다.
`encryptionEnabled`	부울	스냅샷이 암호화되었는지 여부를 나타내는 플래그입니다.
`groupId`	문자열	복원 작업을 소유한 그룹 의 고유 식별자입니다.
`hostId`	문자열	이 복원 작업 이 속한 config 서버 의 고유 식별자입니다. config 서버 가 SCCC 인 경우 반환됩니다.
`id`	문자열	복원 작업의 고유 식별자입니다.
`links`	객체 배열	하위 리소스 및/또는 관련 리소스에 대한 하나 이상의 링크입니다. 응답의 모든 `links` 배열에는 `self` 이라는 링크가 하나 이상 포함되어 있습니다. URL간의 관계는 웹 링크 사양에설명되어 있습니다.
`masterKeyUUID`	문자열	스냅샷 데이터를 암호화하는 데 사용되는 KMIP 마스터 키 ID 입니다. `"encryptionEnabled" : true` 인 경우 반환됩니다.
`pointInTime`	부울	스냅샷이 점에서 생성된 것인지 여부를 나타내는 플래그입니다.
`statusName`	문자열	작업의 현재 상태입니다. 허용되는 값은 다음과 같습니다. `FINISHED` `IN_PROGRESS` `BROKEN` `KILLED`
`timestamp`	객체	스냅샷이 생성되었을 때 Oplog 항목의 타임스탬프입니다.
`timestamp` `.date`	문자열	ISO 8601 의 타임스탬프 복원된 스냅샷에 있는 최신 oplog 항목의 UTC 날짜 및 시간 형식입니다.
`timestamp` `.increment`	문자열	복원된 스냅샷의 가장 최근 oplog 항목에서 완료된 모든 작업의 순서입니다.

요청 예시

HTTP 를 사용하여 압축된 스냅샷을 전송하는 복원 작업을 만듭니다.

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --include \
  --request POST "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs?pretty=true" \
  --data '
   {
     "delivery" : {
       "expirationHours" : "1",
       "maxDownloads" : "1",
       "methodName" : "HTTP"
     },
     "snapshotId" : "{SNAPSHOT-ID}"
   }'

스냅샷 에서 자동 복원 을 만듭니다.

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Accept: application/json" \
     --header "Content-Type: application/json" \
     --request POST "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs?pretty=true" \
     --data '
       {
         "delivery" : {
           "methodName" : "AUTOMATED_RESTORE",
           "targetGroupId" : "{TARGET-PROJECT-ID}",
           "targetClusterId" : "{TARGET-CLUSTER-ID}"
         },
         "snapshotId": "{SNAPSHOT-ID}"
       }'

oplog 타임스탬프에서 자동 복원 을 생성합니다.

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --include \
  --request POST "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs?pretty=true" \
  --data '
   {
     "delivery" : {
       "methodName" : "AUTOMATED_RESTORE",
       "targetGroupId" : "{TARGET-PROJECT-ID}",
       "targetClusterId" : "{TARGET-CLUSTER-ID}"
     },
     "oplogTs" : "1536610288",
     "oplogInc" : "1"
   }'

특정 점 부터 자동 복원 을 생성합니다.

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --include \
  --request POST "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs?pretty=true" \
  --data '
   {
     "delivery" : {
       "methodName" : "AUTOMATED_RESTORE",
       "targetGroupId" : "{TARGET-PROJECT-ID}",
       "targetClusterId" : "{TARGET-CLUSTER-ID}"
     },
     "pointInTimeUTCMillis" : "1536610288000"
   }'

체크포인트 에서 자동 복원 을 만듭니다.FCV 이하가 설치된 MongoDB 클러스터를 실행 샤딩된 클러스터에만 4.0 유효합니다.

중요

FCV 이상이 4.2 설치된 MongoDB 클러스터에는 체크포인트 복원을 사용하지 마세요.

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --include \
  --request POST "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs?pretty=true" \
  --data '
   {
     "delivery" : {
       "methodName" : "AUTOMATED_RESTORE",
       "targetGroupId" : "{TARGET-PROJECT-ID}",
       "targetClusterId" : "{TARGET-CLUSTER-ID}"
     },
     "checkpointId" : "{CHECKPOINT-ID}"
   }'

응답 예시

응답 헤더

HTTP/1.1 401 Unauthorized
Content-Type: application/json;charset=ISO-8859-1
Date: {dateInUnixFormat}
WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false
Content-Length: {requestLengthInBytes}
Connection: keep-alive

HTTP/1.1 200 OK
Vary: Accept-Encoding
Content-Type: application/json
Strict-Transport-Security: max-age=300
Date: {dateInUnixFormat}
Connection: keep-alive
Content-Length: {requestLengthInBytes}
X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}

응답 본문

{
  "links" : [ {
    "href" : "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs?pretty=true&pageNum=1&itemsPerPage=100",
    "rel" : "self"
  } ],
  "results" : [ {
    "batchId": "{BATCH-ID}",
    "clusterId": "{CLUSTER-ID}",
    "created": "2018-09-20T15:00:00Z",
    "delivery": {
      "expirationHours": 1,
      "maxDownloads": 1,
      "methodName": "HTTP",
      "statusName": "READY"
    },
    "encryptionEnabled": false,
    "groupId": "{PROJECT-ID}",
    "id": "{RESTORE-JOB-ID}",
    "links": [{
      "href": "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-NAME}/restoreJobs/{RESTORE-JOB-ID}",
      "rel": "self"
    }],
    "pointInTime": false,
    "snapshotId": "{SNAPSHOT-ID}",
    "statusName": "FINISHED",
    "timestamp": {
      "date": "2018-09-15T15:53:00Z",
      "increment": 1
    }
  }],
  "totalCount" : 1
}

{
  "links" : [ {
    "href" : "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs?pretty=true&pageNum=1&itemsPerPage=100",
    "rel" : "self"
  } ],
  "results" : [ {
    "batchId" : "{BATCH-ID}",
    "clusterId" : "{CLUSTER-ID}",
    "created" : "2020-04-21T03:49:57Z",
    "delivery" : {
      "expirationHours" : 1,
      "expires" : "2020-04-21T04:49:57Z",
      "maxDownloads" : 1,
      "methodName" : "HTTP",
      "statusName" : "READY",
      "url" : "https://api-backup.mongodb.com/backup/restore/v2/pull/{JOB-ID}/OTY0ZmFiNmEzZjEzNGUyMTlhZjJjNjM3NGMyNGM4ZTM=/electron_0-1492636465-{JOB-ID}.tar.gz"
    },
    "encryptionEnabled" : false,
    "groupId" : "{PROJECT-ID}",
    "id" : "{JOB-ID}",
    "links" : [ {
      "href" : "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs/{JOB-ID}",
      "rel" : "self"
    } ],
    "snapshotId" : "{SNAPSHOT-ID}",
    "statusName" : "FINISHED",
    "timestamp" : {
      "date" : "2020-04-18T15:14:25Z",
      "increment" : 1
    }
  } ],
  "totalCount" : 1
}

{
  "links" : [ {
    "href" : "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs?pretty=true&pageNum=1&itemsPerPage=100",
    "rel" : "self"
  } ],
  "results" : [ {
    "batchId": "{BATCH-ID}",
    "clusterId": "{CLUSTER-ID}",
    "created": "2018-09-20T15:01:00Z",
    "delivery": {
      "methodName": "HTTP",
      "statusName": "READY"
    },
    "encryptionEnabled": false,
    "groupId": "{PROJECT-ID}",
    "id": "{RESTORE-JOB-ID}",
    "links": [{
      "href": "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-NAME}/restoreJobs/{RESTORE-JOB-ID}",
      "rel": "self"
    }],
    "pointInTime": false,
    "snapshotId": "{SNAPSHOT-ID}",
    "statusName": "FINISHED",
    "timestamp": {
      "date": "2018-09-15T15:53:00Z",
      "increment": 1
    }
  } ],
  "totalCount" : 1
}

{
  "links" : [ {
    "href" : "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs?pretty=true&pageNum=1&itemsPerPage=100",
    "rel" : "self"
  } ],
  "results" : [ {
    "batchId": "{BATCH-ID}",
    "clusterId": "{CLUSTER-ID}",
    "created": "2018-09-20T15:02:00Z",
    "delivery": {
      "methodName": "HTTP",
      "statusName": "READY"
    },
    "encryptionEnabled": false,
    "groupId": "{PROJECT-ID}",
    "id": "{RESTORE-JOB-ID}",
    "links": [{
      "href": "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-NAME}/restoreJobs/{RESTORE-JOB-ID}",
      "rel": "self"
    }],
    "snapshotId": "{SNAPSHOT-ID}",
    "statusName": "FINISHED",
    "timestamp": {
      "date": "2018-09-15T15:53:00Z",
      "increment": 1
    }
  } ],
  "totalCount" : 1
}

{
  "links" : [ {
    "href" : "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs?pretty=true&pageNum=1&itemsPerPage=100",
    "rel" : "self"
  } ],
  "results" : [ {
    "batchId": "{BATCH-ID}",
    "clusterId": "{CLUSTER-ID}",
    "created": "2018-09-20T15:03:00Z",
    "delivery": {
      "methodName": "HTTP",
      "statusName": "READY"
    },
    "encryptionEnabled": false,
    "groupId": "{PROJECT-ID}",
    "id": "{RESTORE-JOB-ID}",
    "links": [{
      "href": "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-NAME}/restoreJobs/{RESTORE-JOB-ID}",
      "rel": "self"
    }],
    "snapshotId": "{SNAPSHOT-ID}",
    "statusName": "FINISHED",
    "timestamp": {
      "date": "2018-09-15T15:53:00Z",
      "increment": 1
    }
  } ],
  "totalCount" : 1
}

돌아가기

하나 가져오기(클러스터)

모두 가져오기(구성 서버)