문서 메뉴
문서 홈
/
MongoDB Ops Manager
/
API
/
Ops Manager 관리 API 리소스
/
백업 및 복원

체크포인트

이 페이지의 내용

  • 엔드포인트
  • 샘플 엔터티
  • 엔터티 필드
  • 링크
  • 예제

참고

그룹과 프로젝트는 동의어입니다. {PROJECT-ID}는 프로젝트 ID와 동일합니다. 기존 그룹의 경우, 그룹/프로젝트 ID는 동일하게 유지됩니다. 이 페이지에서는 설명에 대해 얘기할 때 더욱 친숙한 용어 그룹을 사용합니다. 엔드포인트는 문서에 명시된 대로 유지됩니다.

이 리소스를 사용하면 체크포인트 메타데이터를 볼 수 있습니다. 체크포인트를 사용하여 일반 스냅샷 사이의 시점에 클러스터의 사용자 지정 스냅샷을 생성할 수 있습니다.

중요

기능 호환성 버전 이 4.0 이하인 MongoDB를 실행하는 클러스터에 체크포인트를 사용할 수 있습니다. FCV 가 4 인 MongoDB 인스턴스에서 체크포인트가 제거되었습니다.2 이상.

엔드포인트

모든 체크포인트 가져오기

cluster의 모든 체크포인트를 가져옵니다.

GET /groups/{PROJECT-ID}/clusters/CLUSTER-ID/checkpoints

1개의 체크포인트 가져오기

단일 체크포인트를 가져옵니다.

GET /groups/{PROJECT-ID}/clusters/CLUSTER-ID/checkpoints/CHECKPOINT-ID

샘플 엔터티

1{
2  "clusterId" : "{CLUSTER-ID}",
3  "completed" : "2015-07-31T23:19:51Z",
4  "groupId" : "{GROUP-ID}",
5  "id" : "{CHECKPOINT-ID}",
6  "parts" : [ {
7    "replicaSetName" : "shard_1",
8    "shardName" : "shard_1",
9    "tokenDiscovered" : true,
10    "tokenTimestamp" : {
11      "date" : "2015-07-31T23:19:51Z",
12      "increment" : 1
13    },
14    "typeName" : "REPLICA_SET"
15  }, {
16    "replicaSetName" : "shard_0",
17    "shardName" : "shard_0",
18    "tokenDiscovered" : true,
19    "tokenTimestamp" : {
20      "date" : "2015-07-31T23:19:51Z",
21      "increment" : 1
22    },
23    "typeName" : "REPLICA_SET"
24  }, {
25    "hostId" : "{HOST-ID}",
26    "tokenDiscovered" : true,
27    "tokenTimestamp" : {
28      "date" : "2015-07-31T23:19:51Z",
29      "increment" : 6
30    },
31    "typeName" : "CONFIG_SERVER"
32  } ],
33  "restorable" : true,
34  "started" : "2015-07-31T23:19:51Z",
35  "timestamp" : "2015-07-31T23:19:47Z"
36}

엔터티 필드

이름
유형
설명
clusterId
문자열
체크포인트가 나타내는 cluster의 고유 식별자입니다.
completed
문자열
ISO 8601 의 타임스탬프 체크포인트가 완료되고 밸런서가 다시 시작된 시점의 날짜 및 시간 형식( UTC )입니다.
groupId
문자열
체크포인트를 소유한 그룹의 고유 식별자입니다.
id
문자열
체크포인트의 고유 식별자입니다.
parts
객체 배열
전체 체크포인트를 구성하는 개별 부분입니다. 각 샤드에 대한 요소 하나와 config 서버에 대한 요소 하나가 추가됩니다.
parts
.replicaSetName
문자열
복제본 세트의 이름입니다. config 서버에는 존재하지 않습니다.
parts
.shardName
문자열
샤드의 이름입니다.
parts
.tokenDiscovered
부울
토큰의 존재 여부를 나타내는 플래그입니다.
parts
.tokenTimestamp
객체
항목의 ts 필드에 지정된 oplog 항목의 타임스탬프입니다. ts 필드는 BSON 타임스탬프이며 두 가지 구성 요소가 있습니다.
parts
.typeName
문자열

부분으로 표시되는 서버 유형입니다. 가능한 값은 다음과 같습니다.

  • REPLICA_SET은 부품이 샤드임을 나타냅니다.

  • CONFIG_SERVER

restorable
부울
복원에 체크포인트를 사용할 수 있는지 여부를 나타내는 플래그입니다.
started
문자열
ISO 8601 의 타임스탬프 MongoDB Ops Manager가 밸런서 를 중지하고 체크포인트를 시작한 시점의 UTC날짜 및 시간 형식입니다.
timestamp
문자열
ISO 8601 의 타임스탬프 체크포인트가 데이터를 복원하는 시점의 날짜 및 시간 형식( UTC )입니다.

링크

관계
설명
self
체크포인트
http://mms.mongodb.com/cluster
체크포인트가 속한 cluster.
http://mms.mongodb.com/group
체크포인트를 소유하는 프로젝트입니다.

예제

모든 체크포인트 가져오기

요청

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Accept: application/json" \
     --include \
     --request GET "https://<ops-manager-host>/api/public/v1.0/groups/{GROUP-ID}/clusters/{CLUSTER-ID}/checkpoints"

응답

응답 헤더

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}

응답 본문

1{
2  "links" : [],
3  "results" : [ {
4    "clusterId" : "{CLUSTER-ID}",
5    "completed" : "2015-07-31T23:35:52Z",
6    "groupId" : "{GROUP-ID}",
7    "id" : "55bc0658e4b097a3efe06f1f",
8    "links" : [],
9    "parts" : [ {
10      "replicaSetName" : "shard_1",
11      "shardName" : "shard_1",
12      "tokenDiscovered" : true,
13      "tokenTimestamp" : {
14        "date" : "2015-07-31T23:35:52Z",
15        "increment" : 1
16      },
17      "typeName" : "REPLICA_SET"
18    }, {
19      "replicaSetName" : "shard_0",
20      "shardName" : "shard_0",
21      "tokenDiscovered" : true,
22      "tokenTimestamp" : {
23        "date" : "2015-07-31T23:35:52Z",
24        "increment" : 1
25      },
26      "typeName" : "REPLICA_SET"
27    }, {
28      "hostId" : "{HOST-ID}",
29      "tokenDiscovered" : true,
30      "tokenTimestamp" : {
31        "date" : "2015-07-31T23:35:52Z",
32        "increment" : 2
33      },
34      "typeName" : "CONFIG_SERVER"
35    } ],
36    "restorable" : true,
37    "started" : "2015-07-31T23:35:52Z",
38    "timestamp" : "2015-07-31T23:34:47Z"
39  },
40  ...
41  ],
42  "totalCount" : 6
43}

1개의 체크포인트 가져오기

요청

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Accept: application/json" \
     --include \
     --request GET "https://<ops-manager-host>/api/public/v1.0/groups/{GROUP-ID}/clusters/{CLUSTER-ID}/checkpoints/{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}

응답 본문

1{
2  "clusterId" : "{CLUSTER-ID}",
3  "completed" : "2015-07-31T23:19:51Z",
4  "groupId" : "{GROUP-ID}",
5  "id" : "{CHECKPOINT-ID}",
6  "links" : [],
7  "parts" : [ {
8    "replicaSetName" : "shard_1",
9    "shardName" : "shard_1",
10    "tokenDiscovered" : true,
11    "tokenTimestamp" : {
12      "date" : "2015-07-31T23:19:51Z",
13      "increment" : 1
14    },
15    "typeName" : "REPLICA_SET"
16  }, {
17    "replicaSetName" : "shard_0",
18    "shardName" : "shard_0",
19    "tokenDiscovered" : true,
20    "tokenTimestamp" : {
21      "date" : "2015-07-31T23:19:51Z",
22      "increment" : 1
23    },
24    "typeName" : "REPLICA_SET"
25  }, {
26    "hostId" : "{HOST-ID}",
27    "tokenDiscovered" : true,
28    "tokenTimestamp" : {
29      "date" : "2015-07-31T23:19:51Z",
30      "increment" : 6
31    },
32    "typeName" : "CONFIG_SERVER"
33  } ],
34  "restorable" : true,
35  "started" : "2015-07-31T23:19:51Z",
36  "timestamp" : "2015-07-31T23:19:47Z"
37}

돌아가기

하나의 Config 서버에 하나의 스냅샷 가져오기