Join us at MongoDB.local London on 7 May to unlock new possibilities for your data. Use WEB50 to save 50%.
Register now >
Docs Menu
Docs Home
/ /

Obtener una tarea de restauración para un clúster

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

GET /groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/restoreJobs/{JOB-ID}
Nombre
Tipo
Descripción

PROJECT-ID

string

Identificador único de la proyecto que posee la tarea de restauración.

CLUSTER-ID

string

Identificador único del clúster que representa el trabajo de restauración.

JOB-ID

string

Identificador único de la tarea de restauración.

Los siguientes parámetros de query son opcionales:

Nombre
Tipo
Necesidad
Descripción
predeterminado

bonito

booleano

Opcional

false

envelope

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

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

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: Se eliminó la restauración de entregas mediante SCP 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

entrega.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 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 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 la llave maestra

string

Condicional: "encryptionEnabled" : trueID de clavemaestra KMIP utilizada para cifrar los datos de la instantánea.

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.

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"
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}
{
"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 todos (clúster)

En esta página