Docs Home

/ /

Restaurar trabajos

Docs Home

/ /

Copia de seguridad y restauración

Copia de seguridad y restauración

Restaurar trabajos

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

Esta versión de la documentación está archivada y ya no se admite. Ver la Documentación actual para aprender cómo actualizar su versión de MongoDB Ops Manager.

URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

Resource

GET /groups/{PROJECT-ID}/clusters/{CLUSTER-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.
CLUSTER-ID	string	Identificador único del clúster que representa el trabajo de restauración.
ID DE TRABAJO	string	Identificador único del trabajo de restauración.

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
Estado	Código de respuestaHTTP
envolvente	Cuerpo de respuesta esperado

false

Parámetros del cuerpo de la solicitud

Este punto final no utiliza parámetros del cuerpo de la solicitud HTTP.

Respuesta

Nombre	Tipo	Descripción
ID de lote	string	Condicional: Soloclúster fragmentado. Identificador único del lote al que pertenece este trabajo 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	Método y detalles de cómo se entregan los datos de la instantánea restaurada.
Horas de vencimiento de entrega	Número	Condicional: `"delivery.methodName" : "HTTP"`. Número de horas que la URL de descarga es válida una vez que se completa el trabajo de restauración.
entrega.caduca	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.
entrega.nombreMétodo	string	Medio por el cual se entregan los datos. Los valores aceptados son: `HTTP` Importante La entrega de restauración a través de SCP se eliminó en Ops 4.0 Manager.
entrega.estadoNombre	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 que se pueden descargar los datos de la instantánea restaurada.
encryptionEnabled	booleano	Bandera que indica si los datos de la instantánea restaurada están cifrados.
ID de grupo	string	Identificador único del grupo propietario del trabajo de restauración.
hashes	matriz de objetos	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 `HTTP`, esta matriz contiene solo un único objeto que representa el hash del archivo `.tar.gz`.
hashes.nombreDeArchivo	string	Nombre del archivo de instantánea que ha sido codificado.
hashes.hash	string	Hash del archivo de instantánea.
hashes.typeName	string	Algoritmo hash utilizado para calcular el valor hash. Si está presente, este valor es `SHA1`.
ID de host	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 del trabajo de restauración.
enlaces	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.
UUID de clave maestra	string	Condicional: `"encryptionEnabled" : true`ID de clavemaestra KMIP utilizada para cifrar los datos de la instantánea.
punto en el tiempo	booleano	Bandera que indica que el trabajo es para una restauración PIT.
snapshotId	string	Identificador único de la instantánea a restaurar.
nombreDeEstado	string	Estado actual del trabajo. 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.
marca de tiempo.fecha	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.
marca de tiempo.incremento	string	Orden de todas las operaciones completadas en la última entrada del registro de operaciones en la instantánea restaurada.

Ejemplo de solicitud

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
 --header "Accept: application/json" \
 --include \
 --request GET "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs/{JOB-ID}?pretty=true"

Ejemplo de respuesta

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

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

Volver

Obtener todo (clúster)

Crear (Clúster)

Resource

Parámetros de la ruta de solicitud

Parámetros de consulta de solicitud

Parámetros del cuerpo de la solicitud

Respuesta

Importante

Ejemplo de solicitud

Ejemplo de respuesta

Encabezado de respuesta

Cuerpo de respuesta