/ /

Backup e restauração

Restaurar trabalhos

Página inicial do Docs

Obtenha intervalos de tempo restauráveis para um cluster

URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

Resource

POST /groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs/restorableTimeRanges

Retorna os intervalos de tempo restauráveis para um conjunto de réplicas habilitadas para backup ou cluster fragmentado em um projeto. Cada intervalo de tempo restaurável representa uma janela contínua do histórico de oplog para o qual o Ops Manager pode restaurar com segurança.

Permissões necessárias

Você deve ter a Global Backup Admin Project Backup Adminfunção, ou para chamar esse endpoint.Global Read Only

Parâmetros da solicitação

Parâmetros do caminho da solicitação

Nome	Tipo	Descrição
`PROJECT-ID`	string	String exclusiva de 24dígitos hexadecimais que identifica o projeto proprietário do cluster.
`CLUSTER-ID`	string	String única de 24dígitos hexadecimais que identifica o cluster habilitado para backup cujos intervalos de tempo restauráveis você deseja retornar.

Solicitar parâmetros de query

Os seguintes parâmetros de query são opcionais:

Nome	Tipo	necessidade	Descrição	Default
pretty	booleano	Opcional	Sinalizador indicando se o corpo da resposta está em um formato prettyprint.	`false`
envelope	booleano	Opcional	Sinalizador que indica se a resposta deve ser agrupada em um envelope. Alguns clientes da API não podem acessar os cabeçalhos de resposta HTTP ou o código de status. Para corrigir isso, defina envelope=true na query. Para endpoints que retornam um resultado, o corpo da resposta inclui: `status`: Código de resposta HTTP `content`: Corpo de resposta esperado	`false`

Parâmetros do corpo da solicitação

Este endpoint não usa parâmetros do corpo da solicitação HTTP.

Resposta

O corpo da resposta contém uma array de intervalos de tempo restauráveis. Para conjuntos de réplicas, cada elemento contém os seguintes campos:

Nome	Tipo	Descrição
`start`	Carimbo de data/hora JSON	O ponto mais antigo neste intervalo restaurável. Esse valor é um objeto de carimbo de data/hora BSON com campos `date` e `increment` que, juntos, identificam exclusivamente uma entrada de oplog.
`end`	Carimbo de data/hora JSON	Último ponto -in-time nesta faixa restaurável. O Ops Manager pode restaurar com segurança a qualquer momento entre `start` e `end`, inclusive, para esse intervalo.
`snapshotId`	string	String exclusiva de 24dígitos hexadecimais que identifica o snapshot ou clustershot associado a esse intervalo.

Para clusters fragmentados, cada elemento também inclui:

Nome	Tipo	Descrição
`shardCount`	inteiro	Número de shards que participam desse intervalo de tempo restaurável.
`configServerType`	string	Etiqueta legível para humanos que indica se o cluster fragmentado usa um sistema de servidor de configuração Incorporado ou Dedicado.

O Ops Manager retorna os intervalos de tempo restauráveis ordenados do mais antigo para o mais recente horário de início.

Exemplo de solicitação

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Accept: application/json" \
     --header "Content-Type: application/json" \
     --include \
     --request POST "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs/restorableTimeRanges?pretty=true"

Exemplo de 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

[
  {
    "end" : {
      "date" : "2021-07-17T19:00:00Z",
      "increment" : 1
    },
    "snapshotId" : "{SNAPSHOT-ID}",
    "start" : {
      "date" : "2021-07-14T00:00:00Z",
      "increment" : 1
    }
  }
]

Voltar

Criar (cluster)

Obter todos (servidor de configuração)