/ /

/ /

1개의 클러스터에 대해 1개의 복원 작업 가져오기

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

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

Resource

GET /groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs/{JOB-ID}

요청 경로 매개변수

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

요청 쿼리 매개변수

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

이름

유형

필요성

설명

기본값

pretty

부울

옵션

응답 본문이 pretty-print 형식이어야 하는지 여부를 나타내는 플래그입니다.

false

envelope

부울

옵션

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

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

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

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

false

요청 본문 매개변수

이 엔드포인트는 HTTP 요청 본문 매개변수를 사용하지 않습니다.

응답

이름	유형	설명
batchId	문자열	조건부: 샤딩된 클러스터 에만 해당됩니다. 이 복원 작업 이 속한 배치 의 고유 식별자입니다.
clusterId	문자열	조건부: 클러스터 전용. 복원 작업이 나타내는 클러스터 의 고유 식별자입니다.
생성됨	문자열	복원 작업 요청되었을 때 ISO 8601 날짜 및 시간 형식(UTC)의 타임스탬프입니다.
전달	객체	복원된 스냅샷 데이터를 전달하는 방법 및 방법에 대한 세부 정보입니다.
delivery.expirationHours	숫자	조건부: `"delivery.methodName" : "HTTP"`. 복원 작업 이 완료된 후 다운로드 URL 이 유효한 시간 수입니다.
delivery.expires	문자열	조건부: `"delivery.methodName" : "HTTP"`.ISO 8601 날짜 및 시간 형식(UTC 기준)의 타임스탬프이며, 이후에는 URL 더 이상 사용할 수 없습니다.
delivery.maxDownloads	숫자	조건부: `"delivery.methodName" : "HTTP"`. 다운로드 URL 을 사용할 수 있는 횟수입니다. 이 값은 `1` 이상이어야 합니다.
delivery.methodName	문자열	데이터가 전달되는 수단입니다. 허용되는 값은 다음과 같습니다. `HTTP` 중요: SCP 를 통한 복원 전달은 27, 2018 부터 제거되었습니다.
delivery.statusName	문자열	다운로드 가능한 파일의 현재 상태입니다. 허용되는 값은 다음과 같습니다. `NOT_STARTED` `IN_PROGRESS` `READY` `FAILED` `INTERRUPTED` `EXPIRED` `MAX_DOWNLOADS_EXCEEDED`
delivery.URL	문자열	조건부: `"delivery.methodName" : "HTTP"`. 복원된 스냅샷 데이터를 다운로드할 수 있는URL 입니다.
groupId	문자열	복원 작업을 소유한 그룹 의 고유 식별자입니다.
해시	객체 배열	해당 `delivery.url` 가 다운로드된 경우 이 배열의 각 문서는 복원 파일을 해시 체크섬에 매핑한 것입니다. 이 배열은 파일이 다운로드 된 후에만 표시됩니다. `HTTP` 복원 의 경우 이 배열 에는 `.tar.gz` 파일 의 해시를 나타내는 단일 객체 만 포함됩니다.
해시.파일 이름	문자열	해시된 스냅샷 파일의 이름입니다.
해시.해시	문자열	스냅샷 파일의 해시입니다.
Hashes.typeName	문자열	해시 값을 계산하는 데 사용되는 해싱 알고리즘입니다. 이 값이 있는 경우 이 값은 `SHA1` 입니다.
hostId	문자열	조건부: 미러링된 config 서버 (SCCC). 이 복원 작업이 속한 config 서버 의 고유 식별자입니다.
id	문자열	복원 작업의 고유 식별자입니다.
링크	객체 배열	하위 리소스 및/또는 관련 리소스에 대한 하나 이상의 링크입니다. 응답의 모든 `links` 배열에는 `self` 링크가 하나 이상 포함되어 있습니다. URL간의 관계는 웹 링크 사양.에 설명되어 있습니다.
pointInTime	부울	작업이 PIT 복원임을 나타내는 플래그입니다.
snapshotId	문자열	복원할 스냅샷 의 고유 식별자입니다.
statusName	문자열	작업의 현재 상태입니다. 허용되는 값은 다음과 같습니다. `FINISHED` `IN_PROGRESS` `BROKEN` `KILLED`
timestamp	객체	스냅샷이 생성되었을 때 Oplog 항목의 타임스탬프입니다.
timestamp.date	문자열	복원된 스냅샷 에서 최신 oplog 항목의 ISO 8601 날짜 및 시간 형식(UTC)의 타임스탬프입니다.
타임스탬프.증가	문자열	복원된 스냅샷의 가장 최근 oplog 항목에서 완료된 모든 작업의 순서입니다.

요청 예시

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Accept: application/json" \
     --include \
     --request GET "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs/{JOB-ID}?pretty=true"

응답 예시

응답 헤더

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}

응답 본문

{
  "batchId" : "{BATCH-ID}",
  "clusterId" : "{CLUSTER-ID}",
  "created" : "2016-03-04T22:07:27Z",
  "delivery" : {
    "expirationHours" : 1,
    "expires" : "2016-03-04T23:07:27Z",
    "maxDownloads" : 1,
    "methodName" : "HTTP",
    "statusName" : "EXPIRED",
    "url" : "https://api-backup.mongodb.com/backup/restore/v2/pull/{JOB-ID}/1976673072885966399/electron_0-1456098690-{JOB-ID}.tar.gz"
  },
  "encryptionEnabled" : false,
  "groupId" : "{PROJECT-ID}",
  "id" : "{JOB-ID}",
  "links" : [ {
  } ],
  "pointInTime" : false,
  "snapshotId" : "{SNAPSHOT-ID}",
  "statusName" : "FINISHED",
  "timestamp" : {
    "date" : "2017-04-19T21:14:25Z",
    "increment" : 1
  }
}

돌아가기

모두 가져오기(클러스터)

생성(클러스터)