Docs Menu
Docs Home
/ /

Puntos de control

Nota

Grupos y proyectos son términos sinónimos. Tu {PROJECT-ID} Es el mismo que el ID de tu proyecto. Para los grupos existentes, el ID de tu grupo/proyecto permanece igual. Esta página utiliza el término "grupo" para las descripciones. El punto final se mantiene como se indica en el documento.

Este recurso le permite ver Metadatos depuntos de control. Puede usar puntos de control para crear instantáneas personalizadas de un clúster en momentos entre instantáneas regulares.

Importante

Puede usar puntos de control para clústeres que ejecutan MongoDB con Feature Compatibility Version de 4.0 o anterior. Los puntos de control se eliminaron de las instancias de MongoDB con FCV 4.2 o posterior.

Obtener todos los puntos de control de un clúster.

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

Obtenga un único punto de control.

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}
Nombre
Tipo
Descripción

clusterId

string

Identificador único del cluster representado por el punto de control.

completed

string

groupId

string

Identificador único del grupo propietario del punto de control.

id

string

Identificador único del punto de control.

parts

matriz de objetos

Partes individuales que componen el punto de control completo. Habrá un elemento para cada fragmento y un elemento para los servidores de configuración.

parts
.replicaSetName

string

Nombre del conjunto de réplicas. No está presente en un servidor de configuración.

parts
.shardName

string

Nombre del fragmento.

parts
.tokenDiscovered

Booleano

Bandera que indica si el token existe.

parts
.tokenTimestamp

Objeto

Marca de tiempo de una entrada en el registro de operaciones, según lo especificado por el campo de la ts entrada. El ts campo es una marca de tiempo BSON y tiene dos componentes: la marca de tiempo, que es el valor en segundos desde la época Unix, y el incremento, que es un ordinal incremental para las operaciones dentro de un segundo dado.

parts
.typeName

string

Tipo de servidor representado por la pieza. Los valores posibles son:

  • REPLICA_SET, lo que indica que la parte es un fragmento.

  • CONFIG_SERVER

restorable

Booleano

Bandera que indica si el punto de control se puede utilizar para una restauración.

started

string

Marca de tiempo en formato de fecha y hora ISO 8601 en UTC para el momento en que Cloud Manager detuvo el balanceador y comenzó el punto de control.

timestamp

string

Marca de tiempo en formato 8601 de fecha y hora ISO en UTC para el punto en el tiempo al que el punto de control restaura los datos.

Relación
Descripción

self

Control

http://mms.mongodb.com/cluster

Clúster al que pertenece el punto de control.

http://mms.mongodb.com/group

Proyecto propietario del punto de control.

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}

Volver

Obtener uno (Servidor de configuración)

En esta página