/ /

Restaurar los jobs

Docs Home

/ /

Copia de seguridad y restauración

Copia de seguridad y restauración

Restaurar los jobs

Cree una tarea de restauración para un servidor de configuración reflejado heredado

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}/hosts/{HOST-ID}/restoreJobs

Parámetros de ruta de solicitud

Nombre	Tipo	Descripción
PROJECT-ID	string	Identificador único del proyecto que es propietario de la tarea.
ID DEL HOST	string	Identificador único del servidor de configuración duplicado (SCCC) 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 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

Nombre	Tipo	Necesidad	Descripción
`checkpointId`	string	Condicional	Identificador único para el clúster particionado punto de control que representa el momento en el cual se restaurarán tus datos. Condiciones: Establecer `"delivery.methodName" : "AUTOMATED_RESTORE"`. Ejecuta Clústeres Sharded usando `FCV` 4.0 o anterior. No se puede establecer `oplogInc`, `oplogTs` o `pointInTimeUTCMillis`. Si estableces este parámetro, este endpoint restaurará todos los datos hasta este punto de control en la base de datos que especificaste en el objeto `delivery`.
`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. `delivery.methodName" : "HTTP"`
`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. `delivery.methodName" : "HTTP"`
`delivery` `.maxDownloads`	Número	Condicional	Número de veces que se puede utilizar la URL de descarga. Esto debe ser `1` o mayor. `delivery.methodName" : "HTTP"`
`delivery` `.methodName`	string	Requerido	Medio por el cual Cloud Manager entrega los datos. Los valores aceptados son: `AUTOMATED_RESTORE` `HTTP` Si se establece `"delivery.methodName" : "AUTOMATED_RESTORE"`, también se debe establecer: `delivery.targetGroupId` y `delivery.targetClusterId` Además, la respuesta muestra el `delivery.methodName` como `HTTP`. Una restauración automática 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	Condicional	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. `delivery.methodName" : "AUTOMATED_RESTORE"`. 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	Condicional	Identificador único del proyecto que contiene el clúster de destino para la tarea de restauración. `delivery.methodName" : "AUTOMATED_RESTORE"`
`oplogTs`	string	Condicional	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. `"delivery.methodName" : "AUTOMATED_RESTORE"` solo para sets de réplicas. Si estableces `oplogTs`, tú: Debe configurar `oplogInc`. No se pueden establecer `checkpointId` ni `pointInTimeUTCMillis`. 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	Condicional	Ordinal incremental de 32 bits que representa operaciones dentro de un segundo dado. Cuando se utilizan junto con `oplogTs`, representan el punto en el tiempo al que se restaurarán los datos. `"delivery.methodName" : "AUTOMATED_RESTORE"` solo para sets de réplicas. Si estableces `oplogInc`, tú: Debe configurar `oplogTs`. No se pueden establecer `checkpointId` ni `pointInTimeUTCMillis`. 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`.
`pointInTimeUTCMillis`	long	Condicional	timestamp en el número de milisegundos que han transcurrido desde la época UNIX', que representa el punto en el tiempo al que se restaurarán tus datos. Esta marca de tiempo debe estar dentro de las últimas 24 horas desde el momento 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`. `"delivery.methodName" : "AUTOMATED_RESTORE"` solo para sets de réplicas. Si estableces `pointInTimeUTCMillis`, no puedes establecer `oplogInc`, `oplogTs` o `checkpointId`.
`snapshotId`	string	Condicional	Identificador único de la snapshot que se va a restaurar.

Respuesta

Nombre	Tipo	Descripción
batchId	string	Condicional: clúster particionado only. Identificador único del lote al que pertenece esta tarea de restauración.
clusterId	string	Condicional: clúster only. Identificador único del clúster que representa la tarea de restauración.
creado	string	Marca de tiempo en formato de fecha y hora ISO 8601 en UTC cuando se solicitó la tarea de restauración.
entrega	Objeto	El método y los detalles de cómo se entregan los datos del snapshot restaurado.
delivery.expirationHour	Número	Condicional: `"delivery.methodName" : "HTTP"`. Número de horas que la descarga URL es válida una vez que la tarea de restauración esté completa.
delivery.expires	string	Condicional: `"delivery.methodName" : "HTTP"`. Marca de tiempo en ISO 8601 con formato de fecha y hora en UTC después de la cual la URL ya no estará disponible.
delivery.maxDownloads	Número	Condicional: `"delivery.methodName" : "HTTP"`. Número de veces que se puede utilizar el URL de descarga. Esto debe ser `1` o mayor.
delivery.methodName	string	Medios por los cuales se entregan los datos. El valor aceptado es `HTTP` IMPORTANTE: La restauración de la entrega a través de SCP se eliminó a partir de marzo 27, 2018.
Estado del envío	string	Estado actual del archivo descargable. Los valores aceptados son: `NOT_STARTED` `IN_PROGRESS` `READY` `FAILED` `INTERRUPTED` `EXPIRED` `MAX_DOWNLOADS_EXCEEDED`
delivery.targetClusterId	string	Condicional: `delivery.methodName" : "AUTOMATED_RESTORE"`. Identificador único del clúster de destino para realizar la tarea de restauración.
delivery.targetGroupId	string	Condicional: `delivery.methodName" : "AUTOMATED_RESTORE"`. Identificador único del proyecto que contiene el clúster de destino para la tarea de restauración.
delivery.url	string	Condicional: `"delivery.methodName" : "HTTP"`. URL desde la cual los datos restaurados de snapshot pueden descargarse.
ID del grupo	string	Identificador único del grupo que es dueño de la tarea de restauración.
encriptada	objeto arreglo	Si el correspondiente `delivery.url` se ha descargado, cada documento en este arreglo es una asignación de un archivo de restauración a una suma de verificación encriptada. Este arreglo está presente sólo después de que el archivo se ha descargado. Para una restauración de `HTTP`, este arreglo contiene solo un objeto que representa el hash del archivo `.tar.gz`.
hashes.fileName	string	Nombre del archivo de instantánea que ha sido encriptada.
hashes.hash	string	Hash del archivo de snapshot.
hashes.typeName	string	Algoritmo de hashing utilizado para calcular el valor de hash. Si está presente, este valor es `SHA1`.
hostId	string	Condicional: servidor de configuración reflejado (SCCC). Identificador único del servidor de configuración al que pertenece esta tarea de restauración.
ID	string	Identificador único de la tarea de restauración.
enlaces	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.
snapshotId	string	Identificador único de la snapshot que se va a restaurar.
Nombre del estado	string	Estado actual de la tarea. Los valores aceptados son: `FINISHED` `IN_PROGRESS` `BROKEN` `KILLED`
Marca de tiempo	Objeto	Marca de tiempo de la entrada de Oplog cuando se creó el snapshot.
timestamp.date	string	Marca de tiempo en ISO 8601 formato de fecha y hora en UTC del último registro de oplog en el snapshot restaurado.
timestamp.increment	string	Orden de todas las operaciones completadas en la última entrada de oplog en la snapshot 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}/hosts/{HOST-ID}/restoreJobs?pretty=true" \
     --data '
      {
        "delivery" : {
          "expirationHours" : 1,
          "expires" : "2017-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"
        },
        "snapshotId" : "{SNAPSHOT-ID}"
      }'

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

{
  "created" : "2017-08-25T16:22:15Z",
  "delivery" : {
    "expirationHours" : 1,
    "expires" : "2017-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" : true,
  "groupId" : "{PROJECT-ID}",
  "hostId" : "{HOST-ID}",
  "id" : "{JOB-ID}",
  "links" : [ {
    "href" : "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/hosts/{HOST-ID}/restoreJobs/{JOB-ID}",
    "rel" : "self"
  }, {
    "href" : "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/hosts/{HOST-ID}",
    "rel" : "http://mms.mongodb.com/cluster"
  }, {
    "href" : "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/hosts/{HOST-ID}/snapshots/{SNAPSHOT-ID}",
    "rel" : "http://mms.mongodb.com/snapshot"
  }, {
    "href" : "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}",
    "rel" : "http://mms.mongodb.com/group"
  } ],
  "masterKeyUUID" : "{UUID}",
  "snapshotId" : "{SNAPSHOT-ID}",
  "statusName" : "IN_PROGRESS"
}

Volver

Obtener uno (Servidor de configuración)

Automatización