Inicie un trabajo de restauración para su proyecto y clúster.
Si creas una tarea de restauración automatizada o pointInTime, Atlas remueve todos los datos existentes en el clúster de destino antes de la restauración.
Para utilizar este comando, debes autenticarte con una cuenta de usuario, una cuenta de servicio o una clave API con el rol de Propietario de proyecto. Atlas solo admite este comando para los clústeres Flex y M10+. Los clústeres Flex sólo admiten tareas de restauración automatizadas.
Sintaxis
atlas backups restores start <automated|download|pointInTime> [options]
Arguments
Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
automatizado|descargar|pointInTime | string | true | Tipo de trabajo de restauración que se creará. Los valores válidos incluyen: automatizado, descarga y punto en el tiempo. Para obtener más información sobre los tipos de trabajos de restauración, consulte https://www.mongodb.com/es/docs/atlas/backup-restore-cluster/. |
opciones
Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
--clusterName | string | true | Nombre del clúster. Para obtener más información, consulta https://dochub.mongodb.org/core/create-cluster-api. |
-h, --help | false | ayuda para empezar | |
--oplogInc | Int | false | Ordinal incremental de 32 bits que representa operaciones dentro de un segundo determinado. Cuando se emparejan con oplogTs, representan el punto en el tiempo al que se restaurarán tus datos. |
--oplogTs | Int | false | La marca de tiempo de oplog se proporciona como una marca de tiempo en la cantidad de segundos transcurridos desde la Unix epoch. Cuando se combinan con oplogInc, representan el punto específico al que se restaurarán sus datos. |
-o, --output | string | false | Formato de salida. Los valores válidos son json, json-path, go-template o go-template-file. Para ver la salida completa, use la opción -o json. |
--pointInTimeUTCSeconds | Int | false | Marca de tiempo en el número de segundos transcurridos desde la época UNIX que representa el punto en el que se restaurarán tus datos. Esta marca de tiempo debe estar dentro de las últimas 24 horas del tiempo actual. |
--projectId | string | false | string hexadecimal que identifica el Proyecto a utilizar. Esta opción anula la configuración en el archivo de configuración o la variable de entorno. |
--snapshotId | string | false | Identificador único de la snapshot a restaurar. Debes especificar un snapshotId para restauraciones automáticas. |
--targetClusterName | string | false | Nombre del clúster de destino. Sólo para usar con tareas de restauración automatizada. Debe especificar un targetClusterName para restauraciones automáticas. |
--targetProjectId | string | false | Identificador único del proyecto que contiene el clúster de destino para la tarea de restauración. Debe especificar un targetProjectId para restauraciones automatizadas. |
Opciones heredadas
Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
-P, --profile | string | false | Nombre del perfil que se usará en el archivo de configuración. Para obtener más información sobre los perfiles de la CLI de Atlas, consulte https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. |
Salida
Si el comando se ejecuta correctamente, el CLI devuelve una salida similar a la siguiente muestra. Los valores entre corchetes representan tus valores.
Restore job '<Id>' successfully started
Ejemplos
# Create an automated restore: atlas backup restore start automated \ --clusterName myDemo \ --snapshotId 5e7e00128f8ce03996a47179 \ --targetClusterName myDemo2 \ --targetProjectId 1a2345b67c8e9a12f3456de7
# Create an automated restore for a Flex Cluster: atlas backup restore start automated \ --clusterName myFlexSource \ --snapshotId 5e7e00128f8ce03996a47179 \ --targetClusterName myFlexCluster \ --targetProjectId 1a2345b67c8e9a12f3456de7
# Create a point-in-time restore: atlas backup restore start pointInTime \ --clusterName myDemo \ --pointInTimeUTCSeconds 1588523147 \ --targetClusterName myDemo2 \ --targetProjectId 1a2345b67c8e9a12f3456de7
# Create a download restore: atlas backup restore start download \ --clusterName myDemo \ --snapshotId 5e7e00128f8ce03996a47179