/ /

Backup e restauração

Página inicial do Docs

/ /

Recursos

Backup e restauração

Página inicial do Docs

Pontos de verificação

O Cloud Manager não oferecerá mais suporte para Automação, Backup e Monitoramento do MongoDB 3.6 e 4.0 após 30 de agosto de 2024. Faça upgrade da sua versão do MongoDB ou migre para o Atlas.

Observação

Grupos e projetos são termos sinônimos. Seu {PROJECT-ID} é igual ao ID do seu projeto. Para grupos existentes, o ID do grupo/projeto permanece o mesmo. Esta página usa o grupo de termos mais conhecido ao se referir às descrições. O ponto final permanece conforme indicado no documento.

Este recurso permite visualizar metadados Checkpoints . Você pode usar checkpoints para criar snapshots personalizados de um cluster em pontos no tempo entre snapshots regulares.

Importante

Você pode utilizar pontos de verificação para clusters que executam MongoDB com Feature Compatibility Version de 4.0 ou anterior. Os pontos de controle foram removidos das instâncias do MongoDB com FCV 4.2 ou posterior.

Endpoints

Obter todos os checkpoint

Obter todos os checkpoint de um cluster.

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

Obter um checkpoint

Obtenha um único checkpoint.

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

Entidade de amostra

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 da entidade

Nome	Tipo	Descrição
`clusterId`	string	Identificador único do cluster representado pelo checkpoint.
`completed`	string	Registro de data/hora em ISO 8601 formato de data e hora em UTC para o ponto no tempo em que o checkpoint foi concluído e o balanceador foi reiniciado.
`groupId`	string	Identificador único do grupo proprietário do checkpoint.
`id`	string	Identificador único do checkpoint.
`parts`	Array de objetos	Partes individuais que compõem o checkpoint completo. haverá um elemento para cada fragmento e um elemento para os servidores de configuração.
`parts` `.replicaSetName`	string	Nome do conjunto de réplicas. Não presente para um servidor de configuração.
`parts` `.shardName`	string	Nome do fragmento.
`parts` `.tokenDiscovered`	Boolean	Sinalizador que indica se o token existe.
`parts` `.tokenTimestamp`	objeto	Carimbo de data/hora de uma entrada no oplog, conforme especificado pelo campo `ts` da entrada. O campo `ts` é um carimbo de data/hora BSON e tem dois componentes: o carimbo de data/hora, que é o valor em segundos desde a Unix epoch, e o incremento, que é um ordinal incrementado para operações dentro de um determinado segundo.
`parts` `.typeName`	string	Tipo de servidor representado pela parte. Os valores possíveis são: `REPLICA_SET`, que indica que a parte é um fragmento. `CONFIG_SERVER`
`restorable`	Boolean	Sinalizador que indica se o checkpoint pode ser usado para uma restauração.
`started`	string	Registro de data/hora no formato de data e hora ISO 8601 em UTC para o ponto no tempo em que o Cloud Manager interrompeu o balanceador e iniciou o checkpoint.
`timestamp`	string	Registro de data/hora no formato de data e hora ISO 8601 em UTC para o ponto no tempo para o qual o checkpoint restaura os dados.

links

Relação	Descrição
`self`	checkpoint
`http://mms.mongodb.com/cluster`	Cluster ao qual o checkpoint pertence.
`http://mms.mongodb.com/group`	projeto que possui o checkpoint.

Exemplos

Obter todos os checkpoint

Solicitar

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"

Resposta

Cabeçalho de resposta

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}

Corpo de resposta

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 }

Obter um checkpoint

Solicitar

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

Resposta

Cabeçalho de resposta

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}

Corpo de resposta

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 }

Voltar

Obtenha um (servidor de configuração)

Restaurar trabalhos

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	}