Docs 菜单
Docs 主页
/
MongoDB Cloud Manager
/
API
/
资源
/
备份和恢复

检查点

在此页面上

  • 端点
  • 示例实体
  • 实体字段
  • 链接
  • 示例

注意

注意：群组和项目是同义词。您的 {PROJECT-ID} 与您的项目 ID 相同。对于现有群组，群组/项目 ID 保持不变。当引用说明时，此页面将使用“群组”这个更为人熟知的术语。端点仍如文档中所述。

此资源允许您查看检查点元数据。 您可以使用检查点在常规快照之间的时间点创建集群的自定义快照。

重要

您可以对运行MongoDB且Feature Compatibility Version 为4.0 或更早版本的集群使用检查点。检查点已从具有 FCV 的MongoDB实例中删除。4 2或更高版本。

端点

获取所有检查点

获取集群的所有检查点。

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

获取一个检查点

获取单个检查点。

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

字符串

检查点表示的集群的唯一标识符。

completed

字符串

ISO8601 格式的时间戳 检查点完成且负载均衡器重新启动的时间点的 UTC 日期和时间格式。

groupId

字符串

拥有检查点的群组的唯一标识符。

id

字符串

检查点的唯一标识符。

parts

对象数组

构成完整检查点的各个部分。 每个分片都有一个元素，外加一个配置服务器元素。

parts
.replicaSetName

字符串

副本集的名称。 对于配置服务器不存在。

parts
.shardName

字符串

分片的名称。

parts
.tokenDiscovered

布尔

指示令牌是否存在的标志。

parts
.tokenTimestamp

对象

oplog中条目的时间戳，由条目的ts字段指定。 ts字段是BSON时间戳，有两个组件：时间戳（自 Unix 纪元以来的秒值）和增量（给定秒内操作的递增序数）。

parts
.typeName

字符串

该部分表示的服务器类型。 可能的值为：

  • REPLICA_SET，表示该部分是分片。

  • CONFIG_SERVER

restorable

布尔

指示检查点是否可用于恢复的标志。

started

字符串

ISO8601 格式的时间戳 Cloud Manager 停止 负载均衡器 并开始检查点的时间点的 UTC 格式的日期和时间。

timestamp

字符串

ISO8601 格式的时间戳 检查点将数据恢复到的时间点的 UTC 日期和时间格式。

链接

关系
说明

self

检查点

http://mms.mongodb.com/cluster

检查点所属的集群。

http://mms.mongodb.com/group

拥有检查点的项目。

示例

获取所有检查点

请求

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Accept: application/json" \
     --include \
     --request GET "https://cloud.mongodb.com/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}

获取一个检查点

请求

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Accept: application/json" \
     --include \
     --request GET "https://cloud.mongodb.com/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}

后退

获取一个（配置服务器）

来年

恢复作业