/ /

Restaurar los jobs

Docs Home

/ /

Copia de seguridad y restauración

Copia de seguridad y restauración

Restaurar los jobs

Obtener todos los trabajos 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.

Obtener todos los trabajos de restauración para un clúster. CLUSTER-ID Debe ser el ID de un conjunto de réplicas ode un clúster fragmentado.

Nota

Si usa el parámetro de consulta BATCH-ID, puede recuperar todos los trabajos de restauración del lote especificado. Al crear un trabajo de restauración para un clúster fragmentado, Cloud Manager crea un trabajo independiente para cada fragmento y otro para el servidor de configuración. Cada uno de estos trabajos forma parte de un lote. Sin embargo, un trabajo de restauración para un conjunto de réplicas no puede formar parte de un lote.

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

Recursos

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

GET /groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs?batchId={BATCH-ID}

Parámetros de la ruta de solicitud

Nombre	Tipo	Descripción
PROJECT-ID	string	Identificador único del Proyecto que es propietario de la snapshot.
CLUSTER-ID	string	Identificador único del clúster que representa la instantánea.

Parámetros de Solicitud Query

Nombre	Tipo	Necesidad	Descripción	predeterminado
Num. de pág.	Número	Opcional	Entero basado en uno que devuelve una subsección de resultados.	`1`
elementosPorPágina	Número	Opcional	Número de elementos a devolver por página, hasta un máximo de 500.	`100`
bonito	booleano	Opcional	Bandera que indica si el cuerpo de la respuesta debe estar en formato 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 una lista de resultados, el objeto `content` es un sobre. Cloud Manager añade el campo `status` al cuerpo de la respuesta.	`false`
backupJobsEnabledOnly	booleano	Opcional	Indicador que indica si se deben excluir de la respuesta los daemons no habilitados para realizar copias de seguridad de bases de datos. Establezca este valor en `false` para incluir las configuraciones de daemon con el indicador `backupJobsEnabled` establecido en `false`.	`true`

ID DE LOTE	string	Identificador único de la agrupar.	`NONE`

Parámetros del cuerpo de la solicitud

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

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.

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: Solo clúster. Identificador único del clúster que representa el trabajo 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 usar la URL de descarga. Debe ser `1` o más.
delivery.methodName	string	Medios por los cuales se entrega la información. Los valores aceptados son: `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`
entrega.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 se ha `delivery.url` descargado el correspondiente, cada documento de esta matriz corresponde a una asignación de un archivo de restauración a una suma de comprobación hash. Esta matriz solo está presente después de descargar el archivo. 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 codificado.
hashes.hash	string	Hash del archivo de snapshot.
hashes.typeName	string	Algoritmo hash utilizado para calcular el valor hash. Si está presente, este valor es `SHA1`.
hostId	string	Condicional: servidor deconfiguración reflejado (SCCC). Identificador único del servidor de configuración al que pertenece este trabajo 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.
pointInTime	booleano	Indicador que señala que la tarea para una restauración PIT.
snapshotId	string	Identificador único de la snapshot que se va a restaurar.
nombreDeEstado	string	Estado actual de la tarea. Los valores aceptados son: `FINISHED` `IN_PROGRESS` `BROKEN` `KILLED`
fecha y hora	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

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Accept: application/json" \
     --include \
     --request GET "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs?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

{
  "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" : "2017-04-21T03:49:57Z",
    "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" : 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" : "2017-04-18T15:14:25Z",
      "increment" : 1
    }
  }, {
    "batchId" : "{BATCH-ID}",
    "clusterId" : "{CLUSTER-ID}",
    "created" : "2017-04-18T19:21:23Z",
    "delivery" : {
      "expirationHours" : 1,
      "expires" : "2017-04-18T20:21:23Z",
      "maxDownloads" : 1,
      "methodName" : "HTTP",
      "statusName" : "READY",
      "url" : "https://api-backup.mongodb.com/backup/restore/v2/pull/{JOB-ID}/NWRlMTk4NzgxYzNjNDIzOTg2Yzc3YzkyODYxYjNjMzY=/electron_0-1492528465-{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" : "2017-04-19T21:14:25Z",
      "increment" : 1
    }
  } ],
  "totalCount" : 2
}

Volver

Restaurar los jobs

Obtener uno (clúster)

Nota

Recursos

Parámetros de la ruta de solicitud

Parámetros de Solicitud Query

Parámetros del cuerpo de la solicitud

Respuesta

Documento de respuesta

results embeddedDocument

Solicitud de ejemplo

Respuesta de ejemplo

Encabezado de respuesta

Respuesta del cuerpo

`results` embeddedDocument