/ /

Recursos

Copia de seguridad y restauración

Copia de seguridad y restauración

Puntos de control

Nota

Grupos y proyectos son términos sinónimos. Tu {PROJECT-ID} es el mismo que el ID del grupo. Para los grupos existentes, el ID del grupo permanece igual. Esta página utiliza el término grupo, más familiar, cuando se refiere a descripciones. El endpoint sigue siendo el declarado en el documento.

Este recurso te permite ver los metadatos de Puntos de control. Puedes usar puntos de control para crear snapshots personalizados de un clúster en puntos en el tiempo entre snapshots 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.

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	ISO 8601 para el momento en que 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	Piezas individuales que componen el punto de control completo. Habrá un elemento para cada partición más un elemento para los servidores de configuración.
`parts` `.replicaSetName`	string	Nombre del set de réplicas. No está presente para 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	Indicador que indica si el punto de control puede utilizarse para una restauración.
`started`	string	ISO 8601 para el punto en el tiempo en que Cloud Manager detuvo el balanceador y comenzó el punto de control.
`timestamp`	string	ISO 8601 para el momento en el tiempo al que el punto de control restaura los datos.

Enlaces

Relación	Descripción
`self`	punto de 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	}