/ /

Restaurar los jobs

Docs Home

/ /

Copia de seguridad y restauración

Copia de seguridad y restauración

Restaurar los jobs

Crear un trabajo de restauración para un clúster

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.

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

Resource

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

Parámetros de la ruta de solicitud

Nombre	Tipo	Descripción
`PROJECT-ID`	string	Identificador único del proyecto propietario del trabajo.
`CLUSTER-ID`	string	Identificador único del clúster que representa la tarea.

Parámetros de Solicitud Query

Los siguientes parámetros de query son opcionales:

Nombre

Tipo

Necesidad

Descripción

predeterminado

bonito

booleano

Opcional

Indicador que señala si el cuerpo de respuesta debe estar en un prettyprint formato.

false

envelope

booleano

Opcional

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

Algunos Los clientes de laAPI no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionar esto, configure envelope=true en la consulta.

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

Nombre	Tipo	Necesidad	Descripción
`delivery`	Objeto	Requerido	El método y los detalles de cómo se entregan los datos del snapshot restaurado.
`delivery` `.expires`	string	Condicional	Marca de tiempo en ISO 8601 formato de fecha y hora en UTC después del cual la URL ya no está disponible. Si configura `delivery.expires`, no podrá configurar `delivery.expirationHours`.
`delivery` `.expirationHours`	Número	Condicional	Número de horas que el URL de descarga es válido una vez completado la tarea de restauración. Si configura `delivery.expirationHours`, no podrá configurar `delivery.expires`.
`delivery` `.maxDownloads`	Número	Requerido	Número de veces que se puede utilizar la URL de descarga. Esto debe ser `1` o mayor.
`delivery` `.methodName`	string	Requerido	Medios por los cuales Cloud Manager entrega los datos. Establecido en `HTTP`.
`snapshotId`	string	Requerido	Identificador único de la snapshot que se va a restaurar.

Nota

Condición

Si configuras "delivery.methodName" : AUTOMATED_RESTORE", debes configurar delivery.targetGroupId y delivery.targetClusterId.

Cree una restauración automatizada a partir de una snapshot.

Nombre	Tipo	Necesidad	Descripción
`delivery`	Objeto	Requerido	El método y los detalles de cómo se entregan los datos del snapshot restaurado.
`delivery` `.methodName`	string	Requerido	Medios por los cuales Cloud Manager entrega los datos. Establecido en `AUTOMATED_RESTORE`. La respuesta muestra el `"delivery.methodName" : "HTTP"`. Una restauración automatizada utiliza el método `HTTP` para entregar la tarea de restauración al host de destino. IMPORTANTE: La restauración de la entrega a través de SCP se eliminó a partir de marzo 27, 2018.
`delivery` `.targetClusterId`	string	Requerido	Identificador único del clúster de destino. Utiliza el `clusterId` devuelto en el cuerpo de la respuesta Puntos finales de Obtener todas las snapshots y Obtener una snapshot. Si la copia de seguridad no está habilitada en el clúster de destino, el endpoint Obtener todas las snapshot retorna un arreglo `results` vacío sin elementos `clusterId` y el endpoint Obtener una snapshot tampoco retorna un elemento `clusterId`.
`delivery` `.targetGroupId`	string	Requerido	Identificador único del proyecto que contiene el clúster de destino para la tarea de restauración.
`snapshotId`	string	Requerido	Identificador único de la snapshot que se va a restaurar.

Crear una restauración automatizada a partir de una marca de tiempo del Oplog.

Los Oplog restauraciones funcionan con sets de réplicas usando cualquier versión de MongoDB o clústeres fragmentados usando FCV 4.2 o posterior.

Nombre	Tipo	Necesidad	Descripción
`delivery`	Objeto	Requerido	El método y los detalles de cómo se entregan los datos del snapshot restaurado.
`delivery` `.methodName`	string	Requerido	Medios por los cuales Cloud Manager entrega los datos. Establecido en `AUTOMATED_RESTORE`. La respuesta muestra el `"delivery.methodName" : "HTTP"`. Una restauración automatizada utiliza el método `HTTP` para entregar la tarea de restauración al host de destino. IMPORTANTE: La restauración de la entrega a través de SCP se eliminó a partir de marzo 27, 2018.
`delivery` `.targetClusterId`	string	Requerido	Identificador único del clúster de destino. Use el `clusterId` devuelto en el cuerpo de la respuesta de los endpoints Obtener todas las snapshots y Obtener una snapshot. Si la copia de seguridad no está habilitada en el clúster de destino, el endpoint Obtener todas las snapshot retorna un arreglo `results` vacío sin elementos `clusterId` y el endpoint Obtener una snapshot tampoco retorna un elemento `clusterId`.
`delivery` `.targetGroupId`	string	Requerido	Identificador único del proyecto que contiene el clúster de destino para la tarea de restauración.
`oplogTs`	string	Requerido	Oplog timestamp proporcionado como una Marca de Tiempo representada por el número de segundos transcurridos desde la Unix epoch. Cuando se combinan con `oplogInc`, representan el punto en el tiempo al que se restaurarán los datos. Ejecute una query contra `local.oplog.rs` en su set de réplicas para encontrar la marca de tiempo deseada. Si proporcionas este parámetro, este endpoint restablece todos los datos hasta e incluyendo esta marca de tiempo Oplog en la base de datos que especificaste en el objeto `delivery`.
`oplogInc`	string	Requerido	Ordinal incremental de 32 bits que representa las operaciones realizadas dentro de un segundo determinado. Al combinarse con `oplogTs`, representan el punto temporal al que se restaurarán los datos. Si proporcionas este parámetro, este endpoint restablece todos los datos hasta e incluyendo esta marca de tiempo Oplog en la base de datos que especificaste en el objeto `delivery`.

Crea una restauración automatizada desde un punto específico en el tiempo.

Las restauraciones de PIT funcionan con sets de réplicas utilizando cualquier versión de MongoDB o clústeres utilizando FCV 4.2 o posterior.

Nombre	Tipo	Necesidad	Descripción
`delivery`	Objeto	Requerido	El método y los detalles de cómo se entregan los datos del snapshot restaurado.
`delivery` `.methodName`	string	Requerido	Medios por los cuales Cloud Manager entrega los datos. Establecido en `AUTOMATED_RESTORE`. La respuesta muestra el `"delivery.methodName" : "HTTP"`. Una restauración automatizada utiliza el método `HTTP` para entregar la tarea de restauración al host de destino. IMPORTANTE: La restauración de la entrega a través de SCP se eliminó a partir de marzo 27, 2018.
`delivery` `.targetClusterId`	string	Requerido	Identificador único del clúster de destino. Use el `clusterId` devuelto en el cuerpo de la respuesta de los endpoints Obtener todas las snapshots y Obtener una snapshot. Si la copia de seguridad no está habilitada en el clúster de destino, el endpoint Obtener todas las snapshot retorna un arreglo `results` vacío sin elementos `clusterId` y el endpoint Obtener una snapshot tampoco retorna un elemento `clusterId`.
`delivery` `.targetGroupId`	string	Requerido	Identificador único del proyecto que contiene el clúster de destino para la tarea de restauración.
`pointInTimeUTCMillis`	long	Requerido	Marca de tiempo en milisegundos transcurridos desde la época UNIX, que representa el momento en el que se restaurarán los datos. Esta marca de tiempo debe estar dentro 24 de las últimas horas desde la hora actual. Si se proporciona esta configuración, este endpoint restaurará todos los datos hasta este Punto en el tiempo a la base de datos que haya especificado en el objeto `delivery`.

Crea una restauración automatizada desde un punto de control. Las restauraciones de puntos de control funcionan para los clústeres fragmentados que ejecutan MongoDB con FCV 4.0 o versiones anteriores.

Importante

No uses restauraciones de puntos de control para clústeres de MongoDB con compatibilidad de características entre versiones 4.2 o posterior.

Nombre	Tipo	Necesidad	Descripción
`checkpointId`	string	Requerido	Identificador único para el clúster particionado punto de control que representa el momento en el cual se restaurarán tus datos. Si proporciona esta configuración, este punto final restaura todos los datos hasta este punto de control en la base de datos que especificó en el `delivery` objeto.
`delivery`	Objeto	Requerido	El método y los detalles de cómo se entregan los datos del snapshot restaurado.
`delivery` `.methodName`	string	Requerido	Medios por los cuales Cloud Manager entrega los datos. Establecido en `AUTOMATED_RESTORE`. La respuesta muestra el `"delivery.methodName" : "HTTP"`. Una restauración automatizada utiliza el método `HTTP` para entregar la tarea de restauración al host de destino.
`delivery` `.targetClusterId`	string	Requerido	Identificador único del clúster de destino. Use el `clusterId` devuelto en el cuerpo de la respuesta de los endpoints Obtener todas las snapshots y Obtener una snapshot. Si la copia de seguridad no está habilitada en el clúster de destino, el endpoint Obtener todas las snapshot retorna un arreglo `results` vacío sin elementos `clusterId` y el endpoint Obtener una snapshot tampoco retorna un elemento `clusterId`.
`delivery` `.targetGroupId`	string	Requerido	Identificador único del proyecto que contiene el clúster de destino para la tarea de restauración.

Respuesta

Documento de respuesta

El documento JSON de respuesta incluye una matriz de result objetos, una matriz de link objetos y un recuento del número total de result objetos recuperados.

Nombre	Tipo	Descripción
`results`	arreglo	El arreglo incluye un objeto para cada elemento detallado en la sección del `results` documento incrustado.
`links`	arreglo	El arreglo incluye uno o más enlaces a subrecursos y/o recursos relacionados. Las relaciones entre URLse explican en la Especificación de enlace web.
`totalCount`	Número	Recuento entero del número total de elementos en el conjunto de resultados. Puede ser superior al número de objetos en el arreglo results si el conjunto de resultados completo está paginado.

`results` embeddedDocument

Cada resultado es una tarea de restauración de clúster. Este arreglo incluye solo una tarea de restauración.

Nombre	Tipo	Descripción
`batchId`	string	Identificador único del lote al que pertenece este trabajo de restauración. Se devuelve si la instantánea se obtuvo de un clúster fragmentado.
`clusterId`	string	Identificador único del clúster que representa la tarea de restauración. Se devuelve si la snapshot era de un set de réplicas o clúster.
`created`	string	Marca de tiempo en formato de fecha y hora ISO 8601 en UTC cuando se solicitó la tarea de restauración.
`delivery`	Objeto	El método y los detalles de cómo se entregan los datos del snapshot restaurado.
`delivery` `.expirationHours`	Número	Número de horas que el URL de descarga es válido una vez completado la tarea de restauración.
`delivery` `.expires`	string	Marca de tiempo en ISO 8601 formato de fecha y hora en UTC después del cual la URL ya no está disponible.
`delivery` `.maxDownloads`	Número	Número de veces que se puede utilizar la URL de descarga. Esto debe ser `1` o mayor.
`delivery` `.methodName`	string	Medios por los cuales se entrega la información. Devuelve `HTTP`.
`delivery` `.statusName`	string	Estado actual del archivo descargable. Los valores aceptados son: `NOT_STARTED` `IN_PROGRESS` `READY` `FAILED` `INTERRUPTED` `EXPIRED` `MAX_DOWNLOADS_EXCEEDED`
`delivery` `.url`	string	URL desde la cual se puede descargar la snapshot restaurada.
`encryptionEnabled`	booleano	Indicador que muestra si la snapshot fue cifrada.
`groupId`	string	Identificador único del grupo que es dueño de la tarea de restauración.
`hashes`	Arreglo de objetos	Si se ha descargado el `delivery.url` correspondiente, este arreglo devuelve un solo objeto que representa el hash del archivo `.tar.gz`.
`hashes` `.fileName`	string	Nombre del archivo de instantánea que ha sido codificado.
`hashes` `.hash`	string	Hash del archivo de snapshot.
`hashes` `.typeName`	string	Algoritmo de hash utilizado para calcular el valor hash. Si se devuelve, el valor se establece en `SHA1`.
`hostId`	string	Identificador único del servidor de configuración al que pertenece esta tarea de restauración. Se devuelve si servidor de configuración era un SCCC.
`id`	string	Identificador único de la tarea de restauración.
`links`	Arreglo de objetos	Uno o más enlaces a subrecursos y/o recursos relacionados. Todos los `links` arreglos en las respuestas incluyen al menos un enlace llamado `self`. Las relaciones entre URLs se explican en la Especificación de Enlaces Web.
`masterKeyUUID`	string	ID de la clavemaestra KMIP utilizada para cifrar los datos de la instantánea. Se devuelve si `"encryptionEnabled" : true` es.
`pointInTime`	booleano	Indicador de si la snapshot corresponde a un punto en el tiempo.
`snapshotId`	string	Identificador único de la snapshot que se va a restaurar.
`statusName`	string	Estado actual de la tarea. Los valores aceptados son: `FINISHED` `IN_PROGRESS` `BROKEN` `KILLED`
`timestamp`	Objeto	Marca de tiempo de la entrada del Oplog cuando se creó la instantánea.
`timestamp` `.date`	string	Marca de tiempo en formato ISO 8601 de fecha y hora en UTC de la última entrada del registro de operaciones en la instantánea restaurada.
`timestamp` `.increment`	string	Orden de todas las operaciones completadas en la última entrada del registro de operaciones en la instantánea restaurada.

Nombre	Tipo	Descripción
`batchId`	string	Identificador único del lote al que pertenece este trabajo de restauración. Se devuelve si la instantánea se obtuvo de un clúster fragmentado.
`clusterId`	string	Identificador único del clúster que representa la tarea de restauración. Se devuelve si la snapshot era de un set de réplicas o clúster.
`created`	string	Marca de tiempo en formato de fecha y hora ISO 8601 en UTC cuando se solicitó la tarea de restauración.
`delivery`	Objeto	El método y los detalles de cómo se entregan los datos del snapshot restaurado.
`delivery` `.methodName`	string	Medios por los cuales se entrega la información. Devuelve `HTTP`.
`delivery` `.targetClusterId`	string	Identificador único del clúster de destino para realizar la tarea de restauración.
`delivery` `.targetGroupId`	string	Identificador único del proyecto que contiene el clúster de destino para la tarea de restauración.
`encryptionEnabled`	booleano	Indicador que muestra si la snapshot fue cifrada.
`groupId`	string	Identificador único del grupo que es dueño de la tarea de restauración.
`hostId`	string	Identificador único del servidor de configuración al que pertenece esta tarea de restauración. Se devuelve si servidor de configuración era un SCCC.
`id`	string	Identificador único de la tarea de restauración.
`links`	objeto arreglo	Uno o más enlaces a subrecursos y/o recursos relacionados. Todos los `links` arreglos en las respuestas incluyen al menos un enlace llamado `self`. Las relaciones entre URLs se explican en la Especificación de Enlaces Web.
`masterKeyUUID`	string	ID de la clavemaestra KMIP utilizada para cifrar los datos de la instantánea. Se devuelve si `"encryptionEnabled" : true` es.
`pointInTime`	booleano	Indicador de si la snapshot corresponde a un punto en el tiempo.
`snapshotId`	string	Identificador único de la snapshot que se va a restaurar.
`statusName`	string	Estado actual de la tarea. Los valores aceptados son: `FINISHED` `IN_PROGRESS` `BROKEN` `KILLED`
`timestamp`	Objeto	Marca de tiempo de la entrada del Oplog cuando se creó la instantánea.
`timestamp` `.date`	string	Marca de tiempo en formato ISO 8601 de fecha y hora en UTC de la última entrada del registro de operaciones en la instantánea restaurada.
`timestamp` `.increment`	string	Orden de todas las operaciones completadas en la última entrada del registro de operaciones en la instantánea restaurada.

Nombre	Tipo	Descripción
`batchId`	string	Identificador único del lote al que pertenece este trabajo de restauración. Se devuelve si la instantánea se obtuvo de un clúster fragmentado.
`clusterId`	string	Identificador único del clúster que representa la tarea de restauración. Se devuelve si la snapshot era de un set de réplicas o clúster.
`created`	string	Marca de tiempo en formato de fecha y hora ISO 8601 en UTC cuando se solicitó la tarea de restauración.
`delivery`	Objeto	El método y los detalles de cómo se entregan los datos del snapshot restaurado.
`delivery` `.methodName`	string	Medios por los cuales se entrega la información. Devuelve `HTTP`.
`delivery` `.targetClusterId`	string	Identificador único del clúster de destino para realizar la tarea de restauración.
`delivery` `.targetGroupId`	string	Identificador único del proyecto que contiene el clúster de destino para la tarea de restauración.
`encryptionEnabled`	booleano	Indicador que muestra si la snapshot fue cifrada.
`groupId`	string	Identificador único del grupo que es dueño de la tarea de restauración.
`hostId`	string	Identificador único del servidor de configuración al que pertenece esta tarea de restauración. Se devuelve si servidor de configuración era un SCCC.
`id`	string	Identificador único de la tarea de restauración.
`links`	objeto arreglo	Uno o más enlaces a subrecursos y/o recursos relacionados. Todos los `links` arreglos en las respuestas incluyen al menos un enlace llamado `self`. Las relaciones entre URLs se explican en la Especificación de Enlaces Web.
`masterKeyUUID`	string	ID de la clavemaestra KMIP utilizada para cifrar los datos de la instantánea. Se devuelve si `"encryptionEnabled" : true` es.
`pointInTime`	booleano	Indicador de si la snapshot corresponde a un punto en el tiempo.
`snapshotId`	string	Identificador único de la snapshot que se va a restaurar.
`statusName`	string	Estado actual de la tarea. Los valores aceptados son: `FINISHED` `IN_PROGRESS` `BROKEN` `KILLED`
`timestamp`	Objeto	Marca de tiempo de la entrada del Oplog cuando se creó la instantánea.
`timestamp` `.date`	string	Marca de tiempo en formato ISO 8601 de fecha y hora en UTC de la última entrada del registro de operaciones en la instantánea restaurada.
`timestamp` `.increment`	string	Orden de todas las operaciones completadas en la última entrada del registro de operaciones en la instantánea restaurada.

Nombre	Tipo	Descripción
`batchId`	string	Identificador único del lote al que pertenece este trabajo de restauración. Se devuelve si la instantánea se obtuvo de un clúster fragmentado.
`clusterId`	string	Identificador único del clúster que representa la tarea de restauración. Se devuelve si la snapshot era de un set de réplicas o clúster.
`created`	string	Marca de tiempo en formato de fecha y hora ISO 8601 en UTC cuando se solicitó la tarea de restauración.
`delivery`	Objeto	El método y los detalles de cómo se entregan los datos del snapshot restaurado.
`delivery` `.methodName`	string	Medios por los cuales se entrega la información. Devuelve `HTTP`.
`delivery` `.targetClusterId`	string	Identificador único del clúster de destino para realizar la tarea de restauración.
`delivery` `.targetGroupId`	string	Identificador único del proyecto que contiene el clúster de destino para la tarea de restauración.
`encryptionEnabled`	booleano	Indicador que muestra si la snapshot fue cifrada.
`groupId`	string	Identificador único del grupo que es dueño de la tarea de restauración.
`hostId`	string	Identificador único del servidor de configuración al que pertenece esta tarea de restauración. Se devuelve si servidor de configuración era un SCCC.
`id`	string	Identificador único de la tarea de restauración.
`links`	objeto arreglo	Uno o más enlaces a subrecursos y/o recursos relacionados. Todos los `links` arreglos en las respuestas incluyen al menos un enlace llamado `self`. Las relaciones entre URLs se explican en la Especificación de Enlaces Web.
`masterKeyUUID`	string	ID de la clavemaestra KMIP utilizada para cifrar los datos de la instantánea. Se devuelve si `"encryptionEnabled" : true` es.
`pointInTime`	booleano	Indicador de si la snapshot corresponde a un punto en el tiempo.
`snapshotId`	string	Identificador único de la snapshot que se va a restaurar.
`statusName`	string	Estado actual de la tarea. Los valores aceptados son: `FINISHED` `IN_PROGRESS` `BROKEN` `KILLED`
`timestamp`	Objeto	Marca de tiempo de la entrada del Oplog cuando se creó la instantánea.
`timestamp` `.date`	string	Marca de tiempo en formato ISO 8601 de fecha y hora en UTC de la última entrada del registro de operaciones en la instantánea restaurada.
`timestamp` `.increment`	string	Orden de todas las operaciones completadas en la última entrada del registro de operaciones en la instantánea restaurada.

Nombre	Tipo	Descripción
`batchId`	string	Identificador único del lote al que pertenece este trabajo de restauración. Se devuelve si la instantánea se obtuvo de un clúster fragmentado.
`checkpointId`	string	Identificador único para el clúster particionado punto de control que representa el momento en el cual se restaurarán tus datos.
`clusterId`	string	Identificador único del clúster que representa la tarea de restauración. Se devuelve si la snapshot era de un set de réplicas o clúster.
`created`	string	Marca de tiempo en formato de fecha y hora ISO 8601 en UTC cuando se solicitó la tarea de restauración.
`delivery`	Objeto	El método y los detalles de cómo se entregan los datos del snapshot restaurado.
`delivery` `.methodName`	string	Medios por los cuales se entrega la información. Devuelve `HTTP`.
`delivery` `.targetClusterId`	string	Identificador único del clúster de destino para realizar la tarea de restauración.
`delivery` `.targetGroupId`	string	Identificador único del proyecto que contiene el clúster de destino para la tarea de restauración.
`encryptionEnabled`	booleano	Indicador que muestra si la snapshot fue cifrada.
`groupId`	string	Identificador único del grupo que es dueño de la tarea de restauración.
`hostId`	string	Identificador único del servidor de configuración al que pertenece esta tarea de restauración. Se devuelve si servidor de configuración era un SCCC.
`id`	string	Identificador único de la tarea de restauración.
`links`	objeto arreglo	Uno o más enlaces a subrecursos y/o recursos relacionados. Todos los `links` arreglos en las respuestas incluyen al menos un enlace llamado `self`. Las relaciones entre URLs se explican en la Especificación de Enlaces Web.
`masterKeyUUID`	string	ID de la clavemaestra KMIP utilizada para cifrar los datos de la instantánea. Se devuelve si `"encryptionEnabled" : true` es.
`pointInTime`	booleano	Indicador de si la snapshot corresponde a un punto en el tiempo.
`statusName`	string	Estado actual de la tarea. Los valores aceptados son: `FINISHED` `IN_PROGRESS` `BROKEN` `KILLED`
`timestamp`	Objeto	Marca de tiempo de la entrada del Oplog cuando se creó la instantánea.
`timestamp` `.date`	string	Marca de tiempo en formato ISO 8601 de fecha y hora en UTC de la última entrada del registro de operaciones en la instantánea restaurada.
`timestamp` `.increment`	string	Orden de todas las operaciones completadas en la última entrada del registro de operaciones en la instantánea restaurada.

Solicitud de ejemplo

Crea una tarea de restauración que transfiera una snapshot comprimida utilizando HTTP.

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?pretty=true" \
  --data '
   {
     "delivery" : {
       "expirationHours" : "1",
       "maxDownloads" : "1",
       "methodName" : "HTTP"
     },
     "snapshotId" : "{SNAPSHOT-ID}"
   }'

Cree una restauración automatizada a partir de una snapshot.

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Accept: application/json" \
     --header "Content-Type: application/json" \
     --request POST "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs?pretty=true" \
     --data '
       {
         "delivery" : {
           "methodName" : "AUTOMATED_RESTORE",
           "targetGroupId" : "{TARGET-PROJECT-ID}",
           "targetClusterId" : "{TARGET-CLUSTER-ID}"
         },
         "snapshotId": "{SNAPSHOT-ID}"
       }'

Crear una restauración automatizada a partir de una marca de tiempo del Oplog.

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?pretty=true" \
  --data '
   {
     "delivery" : {
       "methodName" : "AUTOMATED_RESTORE",
       "targetGroupId" : "{TARGET-PROJECT-ID}",
       "targetClusterId" : "{TARGET-CLUSTER-ID}"
     },
     "oplogTs" : "1536610288",
     "oplogInc" : "1"
   }'

Crea una restauración automatizada desde un punto específico en el tiempo.

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?pretty=true" \
  --data '
   {
     "delivery" : {
       "methodName" : "AUTOMATED_RESTORE",
       "targetGroupId" : "{TARGET-PROJECT-ID}",
       "targetClusterId" : "{TARGET-CLUSTER-ID}"
     },
     "pointInTimeUTCMillis" : "1536610288000"
   }'

Crea una restauración automatizada desde un punto de control. Válido para clústeres que ejecutan clústeres de MongoDB con compatibilidad de características entre versiones 4.0 o anterior, solamente.

Importante

No uses restauraciones de puntos de control para clústeres de MongoDB con compatibilidad de características entre versiones 4.2 o posterior.

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --include \
  --request POST "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs?pretty=true" \
  --data '
   {
     "delivery" : {
       "methodName" : "AUTOMATED_RESTORE",
       "targetGroupId" : "{TARGET-PROJECT-ID}",
       "targetClusterId" : "{TARGET-CLUSTER-ID}"
     },
     "checkpointId" : "{CHECKPOINT-ID}"
   }'

Ejemplo de respuestas

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

{
  "links" : [ {
    "href" : "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs?pretty=true&pageNum=1&itemsPerPage=100",
    "rel" : "self"
  } ],
  "results" : [ {
    "batchId": "{BATCH-ID}",
    "clusterId": "{CLUSTER-ID}",
    "created": "2018-09-20T15:00:00Z",
    "delivery": {
      "expirationHours": 1,
      "maxDownloads": 1,
      "methodName": "HTTP",
      "statusName": "READY"
    },
    "encryptionEnabled": false,
    "groupId": "{PROJECT-ID}",
    "id": "{RESTORE-JOB-ID}",
    "links": [{
      "href": "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-NAME}/restoreJobs/{RESTORE-JOB-ID}",
      "rel": "self"
    }],
    "pointInTime": false,
    "snapshotId": "{SNAPSHOT-ID}",
    "statusName": "FINISHED",
    "timestamp": {
      "date": "2018-09-15T15:53:00Z",
      "increment": 1
    }
  }],
  "totalCount" : 1
}

{
  "links" : [ {
    "href" : "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs?pretty=true&pageNum=1&itemsPerPage=100",
    "rel" : "self"
  } ],
  "results" : [ {
    "batchId" : "{BATCH-ID}",
    "clusterId" : "{CLUSTER-ID}",
    "created" : "2020-04-21T03:49:57Z",
    "delivery" : {
      "expirationHours" : 1,
      "expires" : "2020-04-21T04:49:57Z",
      "maxDownloads" : 1,
      "methodName" : "HTTP",
      "statusName" : "READY",
      "url" : "https://api-backup.mongodb.com/backup/restore/v2/pull/{JOB-ID}/OTY0ZmFiNmEzZjEzNGUyMTlhZjJjNjM3NGMyNGM4ZTM=/electron_0-1492636465-{JOB-ID}.tar.gz"
    },
    "encryptionEnabled" : false,
    "groupId" : "{PROJECT-ID}",
    "id" : "{JOB-ID}",
    "links" : [ {
      "href" : "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs/{JOB-ID}",
      "rel" : "self"
    } ],
    "snapshotId" : "{SNAPSHOT-ID}",
    "statusName" : "FINISHED",
    "timestamp" : {
      "date" : "2020-04-18T15:14:25Z",
      "increment" : 1
    }
  } ],
  "totalCount" : 1
}

{
  "links" : [ {
    "href" : "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs?pretty=true&pageNum=1&itemsPerPage=100",
    "rel" : "self"
  } ],
  "results" : [ {
    "batchId": "{BATCH-ID}",
    "clusterId": "{CLUSTER-ID}",
    "created": "2018-09-20T15:01:00Z",
    "delivery": {
      "methodName": "HTTP",
      "statusName": "READY"
    },
    "encryptionEnabled": false,
    "groupId": "{PROJECT-ID}",
    "id": "{RESTORE-JOB-ID}",
    "links": [{
      "href": "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-NAME}/restoreJobs/{RESTORE-JOB-ID}",
      "rel": "self"
    }],
    "pointInTime": false,
    "snapshotId": "{SNAPSHOT-ID}",
    "statusName": "FINISHED",
    "timestamp": {
      "date": "2018-09-15T15:53:00Z",
      "increment": 1
    }
  } ],
  "totalCount" : 1
}

{
  "links" : [ {
    "href" : "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs?pretty=true&pageNum=1&itemsPerPage=100",
    "rel" : "self"
  } ],
  "results" : [ {
    "batchId": "{BATCH-ID}",
    "clusterId": "{CLUSTER-ID}",
    "created": "2018-09-20T15:02:00Z",
    "delivery": {
      "methodName": "HTTP",
      "statusName": "READY"
    },
    "encryptionEnabled": false,
    "groupId": "{PROJECT-ID}",
    "id": "{RESTORE-JOB-ID}",
    "links": [{
      "href": "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-NAME}/restoreJobs/{RESTORE-JOB-ID}",
      "rel": "self"
    }],
    "snapshotId": "{SNAPSHOT-ID}",
    "statusName": "FINISHED",
    "timestamp": {
      "date": "2018-09-15T15:53:00Z",
      "increment": 1
    }
  } ],
  "totalCount" : 1
}

{
  "links" : [ {
    "href" : "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs?pretty=true&pageNum=1&itemsPerPage=100",
    "rel" : "self"
  } ],
  "results" : [ {
    "batchId": "{BATCH-ID}",
    "clusterId": "{CLUSTER-ID}",
    "created": "2018-09-20T15:03:00Z",
    "delivery": {
      "methodName": "HTTP",
      "statusName": "READY"
    },
    "encryptionEnabled": false,
    "groupId": "{PROJECT-ID}",
    "id": "{RESTORE-JOB-ID}",
    "links": [{
      "href": "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-NAME}/restoreJobs/{RESTORE-JOB-ID}",
      "rel": "self"
    }],
    "snapshotId": "{SNAPSHOT-ID}",
    "statusName": "FINISHED",
    "timestamp": {
      "date": "2018-09-15T15:53:00Z",
      "increment": 1
    }
  } ],
  "totalCount" : 1
}

Volver

Obtener uno (clúster)

Obtener todo (Servidor de configuración)

Resource

Parámetros de la ruta de solicitud

Parámetros de Solicitud Query

Parámetros del cuerpo de la solicitud

Nota

Condición

Importante

Respuesta

Documento de respuesta

results embeddedDocument

Solicitud de ejemplo

Importante

Ejemplo de respuestas

Encabezado de respuesta

Respuesta del cuerpo

`results` embeddedDocument