/ /

Restaurar los jobs

Docs Home

/ /

Copia de seguridad y restauración

Copia de seguridad y restauración

Restaurar los jobs

Obtenga un trabajo 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

GET /groups/{PROJECT-ID}/hosts/{HOST-ID}/restoreJobs/{JOB-ID}

Parámetros de la ruta de solicitud

Nombre	Tipo	Descripción
PROJECT-ID	string	Identificador único del proyecto propietario del trabajo de restauración.
ID DEL HOST	string	Identificador único del servidor de configuración duplicado (SCCC) que representa el trabajo de restauración.
JOB-ID	string	Identificador único de la tarea de restauración.

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

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

Respuesta

Nombre	Tipo	Descripción
batchId	string	Condicional: Soloclúster fragmentado. 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}/hosts/{HOST-ID}/restoreJobs/{JOB-ID}?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

{
  "batchId" : "{BATCH-ID}",
  "created" : "2016-03-04T22:07:27Z",
  "delivery" : {
    "expirationHours" : 1,
    "expires" : "2016-03-04T23:07:27Z",
    "maxDownloads" : 1,
    "methodName" : "HTTP",
    "statusName" : "READY",
    "url" : "https://api-backup.mongodb.com/backup/restore/v2/pull/{JOB-ID}/1976673072885966399/electron_0-1456098690-{JOB-ID}.tar.gz"
  },
  "encryptionEnabled" : false,
  "groupId" : "{PROJECT-ID}",
  "hostId" : "{HOST-ID}",
  "id" : "{JOB-ID}",
  "links" : [ {
  } ],
  "pointInTime" : false,
  "snapshotId" : "{SNAPSHOT-ID}",
  "statusName" : "FINISHED",
  "timestamp" : {
    "date" : "2017-04-19T21:14:25Z",
    "increment" : 1
  }
}

Volver

Obtener todo (Servidor de configuración)

Crear (servidor de configuración)