Docs Menu
Docs Home
/ /
Restaurar trabajos
Docs Home
/ /
Copia de seguridad y restauración
/
Restaurar trabajos
Docs Home
/
Gestión
/
Gerente de Operaciones
/
API
/
Recursos
/
Copia de seguridad y restauración
/
Restaurar trabajos

Crear un trabajo de restauración para un servidor de configuración reflejado heredado

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

Resource

POST /groups/{PROJECT-ID}/hosts/{HOST-ID}/restoreJobs

Parámetros de la ruta de solicitud

Nombre
Tipo
Descripción

PROJECT-ID

string

Identificador único de la proyecto que es dueño del trabajo.

ID DE HOST

string

Identificador único del servidor de configuración reflejado (SCCC) que el trabajo representa.

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 clientes de API no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionarlo, 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

checkpointId

string

Condicional

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.

Las condiciones incluyen:

  • Establecer "delivery.methodName" : "AUTOMATED_RESTORE".

  • No se puede establecer oplogInc, oplogTs o pointInTimeUTCMillis.

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
.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.

delivery.methodName" : "HTTP"

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.

delivery.methodName" : "HTTP"

delivery
.maxDownloads

Número

Condicional

Número de veces que se puede usar la URL de descarga. Debe ser 1 o más.

delivery.methodName" : "HTTP"

delivery
.methodName

string

Requerido

Medio por el cual Ops Manager entrega los datos. Los valores aceptados son:

  • AUTOMATED_RESTORE

  • HTTP

Si configura "delivery.methodName" : "AUTOMATED_RESTORE", también debe configurar:

  • delivery.targetGroupId y

  • delivery.targetClusterId

Además, la respuesta muestra el delivery.methodName como HTTP. Una restauración automatizada utiliza el método HTTP para entregar el trabajo de restauración al host de destino.

IMPORTANTE: La restauración de la entrega mediante SCP se eliminó en Ops 4.0 Manager.

delivery
.targetClusterId

string

Condicional

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.

delivery.methodName" : "AUTOMATED_RESTORE".

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

Condicional

Identificador único del proyecto que contiene el clúster de destino para el trabajo de restauración.

delivery.methodName" : "AUTOMATED_RESTORE"

oplogTs

string

Condicional

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.

"delivery.methodName" : "AUTOMATED_RESTORE" Solo para conjuntos de réplicas.

Si establece oplogTs, usted:

  • Debe establecer oplogInc.

  • No se pueden establecer checkpointId ni pointInTimeUTCMillis.

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

Condicional

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.

"delivery.methodName" : "AUTOMATED_RESTORE" Solo para conjuntos de réplicas.

Si establece oplogInc, usted:

  • Debe establecer oplogTs.

  • No se pueden establecer checkpointId ni pointInTimeUTCMillis.

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.

pointInTimeUTCMillis

long

Condicional

Marca de tiempo en milisegundos transcurridos desde la época UNIX que representa el momento en el que se restaurarán sus 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.

"delivery.methodName" : "AUTOMATED_RESTORE" Solo para conjuntos de réplicas.

Si configura pointInTimeUTCMillis, no podrá configurar oplogInc, oplogTs o checkpointId.

snapshotId

string

Condicional

Identificador único de la instantánea a restaurar.

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

  • AUTOMATED_RESTORE

IMPORTANTE: La restauración de la entrega mediante 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.targetClusterId

string

Condicional: delivery.methodName" : "AUTOMATED_RESTORE". Identificador único del clúster de destino para realizar la tarea de restauración.

entrega.ID del grupo objetivo

string

Condicional: delivery.methodName" : "AUTOMATED_RESTORE". Identificador único del proyecto que contiene el clúster de destino para el trabajo de restauración.

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" : trueID de clavemaestra KMIP utilizada para cifrar los datos de la instantánea.

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

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://{OPSMANAGER-HOST}:{PORT}/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://restore.example.com/backup/restore/v2/pull/{JOB-ID}/OTY0ZmFiNmEzZjEzNGUyMTlhZjJjNjM3NGMyNGM4ZTM=/electron_0-1492636465-{JOB-ID}.tar.gz"
    },
    "snapshotId" : "{SNAPSHOT-ID}"
  }'

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

{
  "created" : "2017-08-25T16:22:15Z",
  "delivery" : {
    "expirationHours" : 1,
    "expires" : "2017-04-21T04:49:57Z",
    "maxDownloads" : 1,
    "methodName" : "HTTP",
    "statusName" : "READY",
    "url" : "https://restore.example.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)

Next

Automatización

En esta página