Docs Home

/ /

Restaurar los jobs

Docs Home

/ /

Copia de seguridad y restauración

Restaurar los jobs

Docs Home

Gestión

Gerente de Operaciones

API

Recursos

Copia de seguridad y restauración

Restaurar los jobs

Obtener todos los trabajos de restauración para un servidor de configuración en espejo heredado

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

Resource

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

Parámetros de ruta de solicitud

Nombre	Tipo	Descripción
PROJECT-ID	string	Identificador único de la proyecto que es propietario de la tarea.
ID DEL HOST	string	Identificador único del host que representa la tarea.

Parámetros de Solicitud Query

Los siguientes parámetros de query son opcionales:

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	Indicador que señala si el cuerpo de la 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 Los clientes API no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para remediarlo, establezca `envelope : true` en la query. Para los endpoints que devuelven una lista de resultados, el objeto `results` es un sobre. Ops Manager agrega el campo `status` al cuerpo de la respuesta.	`false`
backupJobsEnabledOnly	booleano	Opcional	Indicador que indica si se deben excluir los demonios que no están habilitados para hacer copias de seguridad de bases de datos de la respuesta. Establece esto en `false` para incluir las configuraciones del demonio con la bandera `backupJobsEnabled` establecida en `false`.	`true`

Parámetros del cuerpo de la solicitud

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

Respuesta

Documento de respuesta

El documento de respuesta JSON incluye un arreglo de result objetos, un arreglo de link objetos y una cantidad del número total de result objetos recuperados.

Nombre	Tipo	Descripción
`results`	arreglo	El arreglo incluye un objeto para cada elemento detallado en el Sección `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 servidor de configuración.

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 entrega la información. Los valores aceptados son: `HTTP` Importante La restauración de la entrega a través de SCP fue eliminada en Ops Manager 4.0.
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.url	string	Condicional: `"delivery.methodName" : "HTTP"`. URL desde la cual los datos restaurados de snapshot pueden descargarse.
encryptionEnabled	booleano	Indicador que señala si los datos de la snapshot restaurada están cifrados.
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.
UUID de la llave maestra	string	Condicional: `"encryptionEnabled" : true`. KMIP ID de clave maestra utilizado para cifrar los datos del snapshot.
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.
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

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}/hosts/{HOST-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://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/groups/{PROJECT-ID}/hosts/{HOST-ID}/restoreJobs?pretty=true&pageNum=1&itemsPerPage=100",
    "rel" : "self"
  } ],
  "results" : [ {
    "batchId" : "{BATCH-ID}",
    "clusterId" : "{HOST-ID}",
    "created" : "2017-04-21T03:49:57Z",
    "delivery" : {
      "expirationHours" : 1,
      "expires" : "2017-04-21T04:49:57Z",
      "maxDownloads" : 1,
      "methodName" : "HTTP",
      "statusName" : "READY",
      "url" : "https://{OPSMANAGER-HOST}:{PORT}/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://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/groups/{PROJECT-ID}/hosts/{HOST-ID}/restoreJobs/{JOB-ID}",
      "rel" : "self"
    } ],
    "pointInTime" : false,
    "snapshotId" : "{SNAPSHOT-ID}",
    "statusName" : "FINISHED",
    "timestamp" : {
      "date" : "2017-04-18T15:14:25Z",
      "increment" : 1
    }
  }, {
    "batchId" : "{BATCH-ID}",
    "clusterId" : "{HOST-ID}",
    "created" : "2017-04-18T19:21:23Z",
    "delivery" : {
      "expirationHours" : 1,
      "expires" : "2017-04-18T20:21:23Z",
      "maxDownloads" : 1,
      "methodName" : "HTTP",
      "statusName" : "READY",
      "url" : "https://{OPSMANAGER-HOST}:{PORT}/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://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/groups/{PROJECT-ID}/hosts/{HOST-ID}/restoreJobs/{JOB-ID}",
      "rel" : "self"
    } ],
    "pointInTime" : false,
    "snapshotId" : "{SNAPSHOT-ID}",
    "statusName" : "FINISHED",
    "timestamp" : {
      "date" : "2017-04-19T21:14:25Z",
      "increment" : 1
    }
  } ],
  "totalCount" : 2
}

Volver

Crear (Clúster)

Obtener uno (Servidor de configuración)

Resource

Parámetros de ruta de solicitud

Parámetros de Solicitud Query

Parámetros del cuerpo de la solicitud

Respuesta

Documento de respuesta

results embeddedDocument

Importante

Solicitud de ejemplo

Respuesta de ejemplo

Encabezado de respuesta

Respuesta del cuerpo

`results` embeddedDocument