/ /

Copia de seguridad y restauración

Copia de seguridad y restauración

Restaurar los jobs

Obtener rangos de tiempo restaurables para un clúster

URL base: https://cloud.mongodb.com/api/public/v1.0

Resource

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

Devuelve los rangos de tiempo restaurables para un set de réplicas o clúster particionado habilitado para copias de seguridad en un proyecto. Cada rango de tiempo restaurable representa una ventana continua del historial de oplog a la que Cloud Manager puede restaurar de forma segura.

Permisos requeridos

Debes tener el rol Project Backup Admin o Organization Read Only para llamar a este endpoint.

Request Parameters

Parámetros de ruta de solicitud

Nombre	Tipo	Descripción
`PROJECT-ID`	string	string única de 24dígitos hexadecimales que identifica el Proyecto propietario del clúster.
`CLUSTER-ID`	string	string única de 24dígitos hexadecimales que identifica el clúster habilitado para copias de seguridad cuyos rangos de tiempo restaurables desea devolver.

Parámetros de Solicitud Query

Los siguientes parámetros de query son opcionales:

Nombre

Tipo

Necesidad

Descripción

predeterminado

bonito

booleano

Opcional

Indicador que muestra si el cuerpo de la respuesta debe estar en formato prettyprint.

false

envelope

booleano

Opcional

Bandera que indica si se debe o no envolver la respuesta en un sobre.

Algunos clientes API no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionar esto, ajusta envelope=true en la query.

Para los endpoints que devuelven un resultado, el cuerpo de la respuesta incluye:

Nombre	Descripción
`status`	Código de respuesta HTTP
`content`	Cuerpo de respuesta esperado

false

Parámetros del cuerpo de la solicitud

Este endpoint no utiliza parámetros de cuerpo de solicitud HTTP.

Respuesta

El cuerpo de la respuesta contiene un arreglo de rango de tiempo restaurables. Para set de réplicas, cada elemento contiene los siguientes campos:

Nombre	Tipo	Descripción
`start`	Marca de tiempo BSON	Punto más temprano en el tiempo en este rango restaurable. Este valor es un objeto de marca de tiempo BSON con campos `date` y `increment`, que juntos identifican de forma única una entrada de oplog.
`end`	Marca de tiempo BSON	Último punto en el tiempo en este rango restaurable. Cloud Manager puede restaurar de forma segura a cualquier momento entre `start` y `end`, inclusive, para este rango.
`snapshotId`	string	string única de 24dígitos hexadecimales que identifica la snapshot o clustershot asociada con este rango.

Para clústeres particionados, cada elemento también incluye:

Nombre	Tipo	Descripción
`shardCount`	entero	Número de particiones que participan en este rango de tiempo restaurable.
`configServerType`	string	Etiqueta legible por humanos que indica si el clúster particionado utiliza una implementación de servidor de configuración incrustada o dedicada.

Cloud Manager devuelve los rangos de tiempo restaurables ordenados de la hora de inicio más temprana a la más reciente.

Solicitud de ejemplo

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

Respuesta de ejemplo

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

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

Volver

Crear (Clúster)

Obtener todo (Servidor de configuración)