/ /

Copia de seguridad y restauración

Docs Home

/ /

Recursos

Copia de seguridad y restauración

Copia de seguridad y restauración

Puntos de control

Cloud Manager dejará de admitir la Automatización, la Copia de seguridad y la Supervisión para MongoDB 3.6 y 4.0 después del 30de agosto de 2024. Por favor actualiza tu implementación de MongoDB o migra a Atlas.

Nota

Grupos y proyectos son términos sinónimos. Tu {PROJECT-ID} es el mismo que tu id. de proyecto. Para los grupos existentes, su ID de grupo/ID del grupo seguirá siendo el mismo. Esta página utiliza el término más familiar grupo al referirse a descripciones. El endpoint se mantiene tal como se indica en el documento.

Este recurso le permite ver punto de control metadata. Puedes usar puntos de control para crear instantáneas personalizadas de un clúster en determinados momentos, entre instantáneas regulares.

Importante

Puede usar puntos de control para los clústeres que ejecutan MongoDB con Feature Compatibility Version de 4.0 o anterior. Se eliminaron puntos de control de las instancias de MongoDB con compatibilidad de características entre versiones 4.2 o posterior.

Extremos

Obtener todos los puntos de control

Obtén todos los puntos de control para un clúster.

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

Obtener un punto de control

Obtén un punto de control único.

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

Entidad de muestra

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 }

Campos de la entidad

Nombre	Tipo	Descripción
`clusterId`	string	Identificador único del clúster representado por el punto de control.
`completed`	string	Marca de tiempo en ISO 8601 formato de fecha y hora en UTC para el punto en el tiempo cuando se completó el punto de control y se reinició el balanceador.
`groupId`	string	Identificador único del grupo que posee el punto de control.
`id`	string	Identificador único del punto de control.
`parts`	Arreglo 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 de la partición.
`parts` `.tokenDiscovered`	Booleano	Indicador que señala si el token existe.
`parts` `.tokenTimestamp`	Objeto	La marca de tiempo de una entrada en el oplog, según lo especificado por el campo `ts` de la 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 Unix epoch, y el incremento, que es un número ordinal que aumenta para las operaciones dentro de un segundo determinado.
`parts` `.typeName`	string	Tipo de servidor representado por la pieza. Los valores posibles son: `REPLICA_SET`, que indica que la parte es una partición. `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 ISO 8601 en el formato de fecha y hora en UTC para el punto en el tiempo en que Cloud Manager detuvo el balanceador y comenzó el punto de control.
`timestamp`	string	Marca de tiempo en ISO 8601 formato de fecha y hora en UTC para el momento histórico al que el punto de restauración restaura los datos.

Enlaces

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 que es propietario del punto de control.

Ejemplos

Obtener todos los puntos de control

Solicitud

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"

Respuesta

Encabezado de respuesta

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}

Respuesta del cuerpo

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 }

Obtener un punto de control

Solicitud

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}"

Respuesta

Encabezado de respuesta

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}

Respuesta del cuerpo

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)

Restaurar los jobs

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	}

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	}