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

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, Ops 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://{OPSMANAGER-HOST}:{PORT}/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 propietario de la instantánea.
CLUSTER-ID	string	Identificador único del clúster que representa la instantánea.

Parámetros de consulta de solicitud

Nombre	Tipo	Necesidad	Descripción	predeterminado
número de página	Número	Opcional	Entero basado en uno que devuelve una subsección de resultados.	`1`
artículos por página	Número	Opcional	Número de artículos a devolver por página, hasta un máximo de 500.	`100`
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 una lista de resultados, el objeto `results` es un sobre. Ops Manager añade el campo `status` al cuerpo de la respuesta.	`false`
trabajos de respaldo habilitados solamente	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 lote.	`NONE`

Parámetros del cuerpo de la solicitud

Este punto final no utiliza parámetros del cuerpo de la 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	La matriz incluye un objeto para cada elemento detallado en la `results` sección Documento incrustado.
`links`	arreglo	La matriz incluye uno o más enlaces a subrecursos o recursos relacionados. Las relaciones entre las URLse explican en la Especificación de Enlaces Web.
`totalCount`	Número	Número entero del número total de elementos en el conjunto de resultados. Puede ser mayor que el número de objetos en la matriz results si todo el conjunto de resultados está paginado.

`results` Documento incrustado

Cada resultado es una tarea de restauración de clúster.

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

{
  "links" : [ {
    "href" : "https://{OPSMANAGER-HOST}:{PORT}/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://{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}/clusters/{CLUSTER-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" : "{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://{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}/clusters/{CLUSTER-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

Restaurar trabajos

Consigue uno (grupo)