/ /

Restaurar trabajos

Docs Home

/ /

Copia de seguridad y restauración

Copia de seguridad y restauración

Restaurar trabajos

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

Cloud Manager dejará de ofrecer compatibilidad con automatización, copias de seguridad y monitorización para MongoDB 3.6 y 4.0 a partir del 30de agosto de 2024. Por favor, Actualice su implementación de MongoDB o migre 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 el trabajo.

Parámetros de consulta de solicitud

Los siguientes parámetros de consulta son opcionales:

Nombre

Tipo

Necesidad

Descripción

predeterminado

bonita

booleano

Opcional

Bandera que indica si el cuerpo de la respuesta debe estar en formato prettyprint formato.

false

envolvente

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 puntos finales que devuelven un resultado, el cuerpo de la respuesta incluye:

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

false

Parámetros del cuerpo de la solicitud

Nombre	Tipo	Necesidad	Descripción
`delivery`	Objeto	Requerido	Método y detalles de cómo se entregan los datos de la instantánea restaurada.
`delivery` `.expires`	string	Condicional	Marca de tiempo en formato ISO 8601 de fecha y hora en UTC después de la 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 la URL de descarga es válida una vez que se completa el trabajo de restauración. Si configura `delivery.expirationHours`, no podrá configurar `delivery.expires`.
`delivery` `.maxDownloads`	Número	Requerido	Número de veces que se puede usar la URL de descarga. Debe ser `1` o más.
`delivery` `.methodName`	string	Requerido	Medio por el cual Cloud Manager entrega los datos. Establézcalo en `HTTP`.
`snapshotId`	string	Requerido	Identificador único de la instantánea a restaurar.

Nota

Condición

Si establece "delivery.methodName" : AUTOMATED_RESTORE", debe establecer delivery.targetGroupId y delivery.targetClusterId.

Cree una restauración automatizada a partir de una instantánea.

Nombre	Tipo	Necesidad	Descripción
`delivery`	Objeto	Requerido	Método y detalles de cómo se entregan los datos de la instantánea restaurada.
`delivery` `.methodName`	string	Requerido	Medio por el cual Cloud Manager entrega los datos. Establézcalo en `AUTOMATED_RESTORE`. La respuesta muestra `"delivery.methodName" : "HTTP"`. Una restauración automatizada utiliza el método `HTTP` para enviar el trabajo de restauración al host de destino. IMPORTANTE: La entrega de restauración a través de SCP se ha eliminado a partir del de marzo 27 2018de.
`delivery` `.targetClusterId`	string	Requerido	Identificador único del clúster de destino. Utilice el `clusterId` devuelto en el cuerpo de la respuesta. Obtener todas las instantáneas y obtener una instantánea de los puntos finales. Si la copia de seguridad no está habilitada en el clúster de destino, el punto final Obtener todas las instantáneas devuelve una `results` matriz vacía sin `clusterId` elementos, y el punto final Obtener una `clusterId` instantánea tampoco devuelve un elemento.
`delivery` `.targetGroupId`	string	Requerido	Identificador único del proyecto que contiene el clúster de destino para el trabajo de restauración.
`snapshotId`	string	Requerido	Identificador único de la instantánea a restaurar.

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

Las restauraciones de Oplog funcionan con conjuntos de réplicas que utilizan cualquier versión de MongoDB o clústeres fragmentados que utilizan FCV 4.2 o posterior.

Nombre	Tipo	Necesidad	Descripción
`delivery`	Objeto	Requerido	Método y detalles de cómo se entregan los datos de la instantánea restaurada.
`delivery` `.methodName`	string	Requerido	Medio por el cual Cloud Manager entrega los datos. Establézcalo en `AUTOMATED_RESTORE`. La respuesta muestra `"delivery.methodName" : "HTTP"`. Una restauración automatizada utiliza el método `HTTP` para enviar el trabajo de restauración al host de destino. IMPORTANTE: La entrega de restauración a través de SCP se ha eliminado a partir del de marzo 27 2018de.
`delivery` `.targetClusterId`	string	Requerido	Identificador único del clúster de destino. Utilice el `clusterId` valor devuelto en el cuerpo de la respuesta de los puntos de conexión Obtener todas las instantáneas y Obtener una instantánea. Si la copia de seguridad no está habilitada en el clúster de destino, el punto final Obtener todas las instantáneas devuelve una `results` matriz vacía sin `clusterId` elementos, y el punto final Obtener una `clusterId` instantánea tampoco devuelve un elemento.
`delivery` `.targetGroupId`	string	Requerido	Identificador único del proyecto que contiene el clúster de destino para el trabajo de restauración.
`oplogTs`	string	Requerido	Marca de tiempo del registro de operaciones (oplog) expresada en segundos desde la época de UNIX. Al combinarse `oplogInc` con, representan el punto temporal al que se restaurarán los datos. Ejecute una consulta en `local.oplog.rs` en su conjunto de réplicas para encontrar la marca de tiempo deseada. Si proporciona esta configuración, este punto final restaura todos los datos hasta esta marca de tiempo de Oplog inclusive en la base de datos que especificó en el `delivery` objeto.
`oplogInc`	string	Requerido	Ordinario incremental de 32bits que representa las operaciones dentro de un segundo dado. Junto con `oplogTs`, representan el punto temporal al que se restaurarán los datos. Si proporciona esta configuración, este punto final restaura todos los datos hasta esta marca de tiempo de Oplog inclusive en la base de datos que especificó en el `delivery` objeto.

Cree una restauración automatizada a partir de un punto específico en el tiempo.

Las restauraciones PIT funcionan con conjuntos de réplicas que utilizan cualquier versión de MongoDB o clústeres fragmentados que utilizan FCV 4.2 o posterior.

Nombre	Tipo	Necesidad	Descripción
`delivery`	Objeto	Requerido	Método y detalles de cómo se entregan los datos de la instantánea restaurada.
`delivery` `.methodName`	string	Requerido	Medio por el cual Cloud Manager entrega los datos. Establézcalo en `AUTOMATED_RESTORE`. La respuesta muestra `"delivery.methodName" : "HTTP"`. Una restauración automatizada utiliza el método `HTTP` para enviar el trabajo de restauración al host de destino. IMPORTANTE: La entrega de restauración a través de SCP se ha eliminado a partir del de marzo 27 2018de.
`delivery` `.targetClusterId`	string	Requerido	Identificador único del clúster de destino. Utilice el `clusterId` valor devuelto en el cuerpo de la respuesta de los puntos de conexión Obtener todas las instantáneas y Obtener una instantánea. Si la copia de seguridad no está habilitada en el clúster de destino, el punto final Obtener todas las instantáneas devuelve una `results` matriz vacía sin `clusterId` elementos, y el punto final Obtener una `clusterId` instantánea tampoco devuelve un elemento.
`delivery` `.targetGroupId`	string	Requerido	Identificador único del proyecto que contiene el clúster de destino para el trabajo 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 proporciona esta configuración, este punto final restaura todos los datos hasta este punto en el tiempo en la base de datos que especificó en el `delivery` objeto.

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

Importante

No utilice restauraciones de puntos de control para clústeres MongoDB con FCV 4.2 o posterior.

Nombre	Tipo	Necesidad	Descripción
`checkpointId`	string	Requerido	Identificador único para el punto de control del clúster fragmentado que representa el punto en el tiempo en el que se restaurarán sus 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	Método y detalles de cómo se entregan los datos de la instantánea restaurada.
`delivery` `.methodName`	string	Requerido	Medio por el cual Cloud Manager entrega los datos. Establézcalo en `AUTOMATED_RESTORE`. La respuesta muestra `"delivery.methodName" : "HTTP"`. Una restauración automatizada utiliza el método `HTTP` para enviar el trabajo de restauración al host de destino.
`delivery` `.targetClusterId`	string	Requerido	Identificador único del clúster de destino. Utilice el `clusterId` valor devuelto en el cuerpo de la respuesta de los puntos de conexión Obtener todas las instantáneas y Obtener una instantánea. Si la copia de seguridad no está habilitada en el clúster de destino, el punto final Obtener todas las instantáneas devuelve una `results` matriz vacía sin `clusterId` elementos, y el punto final Obtener una `clusterId` instantánea tampoco devuelve un elemento.
`delivery` `.targetGroupId`	string	Requerido	Identificador único del proyecto que contiene el clúster de destino para el trabajo 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	La matriz incluye un objeto para cada elemento detallado en la `results` sección Documento incrustado.
`links`	arreglo	La matriz incluye uno o más enlaces a subrecursos o recursos relacionados. Las relaciones entre las URLse explican en la Especificación de Enlaces Web.
`totalCount`	Número	Número entero del número total de elementos en el conjunto de resultados. Puede ser mayor que el número de objetos en la matriz results si todo el conjunto de resultados está paginado.

`results` Documento incrustado

Cada resultado corresponde a un trabajo de restauración del clúster. Esta matriz incluye solo un trabajo 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 el trabajo de restauración. Se devuelve si la instantánea proviene de un conjunto de réplicas o un clúster fragmentado.
`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	Método y detalles de cómo se entregan los datos de la instantánea restaurada.
`delivery` `.expirationHours`	Número	Número de horas que la URL de descarga es válida una vez que se completa el trabajo de restauración.
`delivery` `.expires`	string	Marca de tiempo en formato ISO 8601 de fecha y hora en UTC después de la cual la URL ya no está disponible.
`delivery` `.maxDownloads`	Número	Número de veces que se puede usar la URL de descarga. Debe ser `1` o más.
`delivery` `.methodName`	string	Medio por el cual se entregan los datos. 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 que se pueden descargar los datos de la instantánea restaurada.
`encryptionEnabled`	booleano	Bandera que indica si la instantánea fue cifrada.
`groupId`	string	Identificador único del grupo propietario del trabajo de restauración.
`hashes`	matriz 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 instantánea.
`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 este trabajo de restauración. Se devuelve si el servidor de configuración era un SCCC.
`id`	string	Identificador único del trabajo de restauración.
`links`	matriz de objetos	Uno o más enlaces a subrecursos o recursos relacionados. Todas las `links` matrices en las respuestas incluyen al menos un enlace `self` llamado. Las relaciones entre las URLse 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	Bandera que indica si la instantánea fue tomada en un punto determinado del tiempo.
`snapshotId`	string	Identificador único de la instantánea a restaurar.
`statusName`	string	Estado actual del trabajo. 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 el trabajo de restauración. Se devuelve si la instantánea proviene de un conjunto de réplicas o un clúster fragmentado.
`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	Método y detalles de cómo se entregan los datos de la instantánea restaurada.
`delivery` `.methodName`	string	Medio por el cual se entregan los datos. Devuelve `HTTP`.
`delivery` `.targetClusterId`	string	Identificador único del clúster de destino para realizar el trabajo de restauración.
`delivery` `.targetGroupId`	string	Identificador único del proyecto que contiene el clúster de destino para el trabajo de restauración.
`encryptionEnabled`	booleano	Bandera que indica si la instantánea fue cifrada.
`groupId`	string	Identificador único del grupo propietario del trabajo de restauración.
`hostId`	string	Identificador único del servidor de configuración al que pertenece este trabajo de restauración. Se devuelve si el servidor de configuración era un SCCC.
`id`	string	Identificador único del trabajo de restauración.
`links`	matriz de objetos	Uno o más enlaces a subrecursos o recursos relacionados. Todas las `links` matrices en las respuestas incluyen al menos un enlace `self` llamado. Las relaciones entre las URLse 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	Bandera que indica si la instantánea fue tomada en un punto determinado del tiempo.
`snapshotId`	string	Identificador único de la instantánea a restaurar.
`statusName`	string	Estado actual del trabajo. 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 el trabajo de restauración. Se devuelve si la instantánea proviene de un conjunto de réplicas o un clúster fragmentado.
`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	Método y detalles de cómo se entregan los datos de la instantánea restaurada.
`delivery` `.methodName`	string	Medio por el cual se entregan los datos. Devuelve `HTTP`.
`delivery` `.targetClusterId`	string	Identificador único del clúster de destino para realizar el trabajo de restauración.
`delivery` `.targetGroupId`	string	Identificador único del proyecto que contiene el clúster de destino para el trabajo de restauración.
`encryptionEnabled`	booleano	Bandera que indica si la instantánea fue cifrada.
`groupId`	string	Identificador único del grupo propietario del trabajo de restauración.
`hostId`	string	Identificador único del servidor de configuración al que pertenece este trabajo de restauración. Se devuelve si el servidor de configuración era un SCCC.
`id`	string	Identificador único del trabajo de restauración.
`links`	matriz de objetos	Uno o más enlaces a subrecursos o recursos relacionados. Todas las `links` matrices en las respuestas incluyen al menos un enlace `self` llamado. Las relaciones entre las URLse 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	Bandera que indica si la instantánea fue tomada en un punto determinado del tiempo.
`snapshotId`	string	Identificador único de la instantánea a restaurar.
`statusName`	string	Estado actual del trabajo. 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 el trabajo de restauración. Se devuelve si la instantánea proviene de un conjunto de réplicas o un clúster fragmentado.
`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	Método y detalles de cómo se entregan los datos de la instantánea restaurada.
`delivery` `.methodName`	string	Medio por el cual se entregan los datos. Devuelve `HTTP`.
`delivery` `.targetClusterId`	string	Identificador único del clúster de destino para realizar el trabajo de restauración.
`delivery` `.targetGroupId`	string	Identificador único del proyecto que contiene el clúster de destino para el trabajo de restauración.
`encryptionEnabled`	booleano	Bandera que indica si la instantánea fue cifrada.
`groupId`	string	Identificador único del grupo propietario del trabajo de restauración.
`hostId`	string	Identificador único del servidor de configuración al que pertenece este trabajo de restauración. Se devuelve si el servidor de configuración era un SCCC.
`id`	string	Identificador único del trabajo de restauración.
`links`	matriz de objetos	Uno o más enlaces a subrecursos o recursos relacionados. Todas las `links` matrices en las respuestas incluyen al menos un enlace `self` llamado. Las relaciones entre las URLse 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	Bandera que indica si la instantánea fue tomada en un punto determinado del tiempo.
`snapshotId`	string	Identificador único de la instantánea a restaurar.
`statusName`	string	Estado actual del trabajo. 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 punto de control del clúster fragmentado que representa el punto en el tiempo en el que se restaurarán sus datos.
`clusterId`	string	Identificador único del clúster que representa el trabajo de restauración. Se devuelve si la instantánea proviene de un conjunto de réplicas o un clúster fragmentado.
`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	Método y detalles de cómo se entregan los datos de la instantánea restaurada.
`delivery` `.methodName`	string	Medio por el cual se entregan los datos. Devuelve `HTTP`.
`delivery` `.targetClusterId`	string	Identificador único del clúster de destino para realizar el trabajo de restauración.
`delivery` `.targetGroupId`	string	Identificador único del proyecto que contiene el clúster de destino para el trabajo de restauración.
`encryptionEnabled`	booleano	Bandera que indica si la instantánea fue cifrada.
`groupId`	string	Identificador único del grupo propietario del trabajo de restauración.
`hostId`	string	Identificador único del servidor de configuración al que pertenece este trabajo de restauración. Se devuelve si el servidor de configuración era un SCCC.
`id`	string	Identificador único del trabajo de restauración.
`links`	matriz de objetos	Uno o más enlaces a subrecursos o recursos relacionados. Todas las `links` matrices en las respuestas incluyen al menos un enlace `self` llamado. Las relaciones entre las URLse 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	Bandera que indica si la instantánea fue tomada en un punto determinado del tiempo.
`statusName`	string	Estado actual del trabajo. 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.

Ejemplo de solicitud

Cree un trabajo de restauración que transfiera una instantánea comprimida mediante 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 instantánea.

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

Cree una restauración automatizada a partir de una marca de tiempo de 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"
   }'

Cree una restauración automatizada a partir de 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"
   }'

Cree una restauración automatizada desde un punto de control. Válido solo para clústeres fragmentados que ejecutan clústeres MongoDB con FCV 4.0 o versiones anteriores.

Importante

No utilice restauraciones de puntos de control para clústeres MongoDB con FCV 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}"
   }'

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

Cuerpo de respuesta

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

Consigue uno (grupo)

Obtener todo (Servidor de configuración)

Resource

Parámetros de la ruta de solicitud

Parámetros de consulta de solicitud

Parámetros del cuerpo de la solicitud

Nota

Condición

Importante

Respuesta

Documento de respuesta

results Documento incrustado

Ejemplo de solicitud

Importante

Ejemplos de respuestas

Encabezado de respuesta

Cuerpo de respuesta

`results` Documento incrustado