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 usar este comando, debe autenticarse con una cuenta de usuario, una cuenta de servicio o una clave API con el rol de Propietario del proyecto. Atlas solo admite este comando para clústeres Flex y M10+. Los clústeres Flex solo admiten trabajos de restauración automatizados.
Sintaxis
atlas backups restores start <automated|download|pointInTime> [options]
Arguments
Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
automatizado|descarga|punto en el tiempo | 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, consulte https://dochub.mongodb.org/core/create-cluster-api. |
-h, --ayuda | false | ayuda para empezar | |
--oplogInc | Int | false | Ordinario incremental de 32bits que representa las operaciones dentro de un segundo dado. Al combinarse con oplogTs, representan el punto temporal al que se restaurarán los datos. |
--oplogTs | Int | false | Marca de tiempo del registro de operaciones (oplog) expresada en segundos desde la época UNIX. En combinación con oplogInc, representan el punto temporal al que se restaurarán los 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 segundos transcurridos desde la época UNIX que representa el momento en el que se restaurarán sus datos. Esta marca de tiempo debe estar dentro de las últimas 24 horas de la hora actual. |
--projectId | string | false | Cadena hexadecimal que identifica el proyecto que se utilizará. Esta opción anula la configuración del 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. Solo para uso con trabajos de restauración automatizada. Debe especificar un nombre de clúster de destino para las restauraciones automatizadas. |
--targetProjectId | string | false | Identificador único del proyecto que contiene el clúster de destino para el trabajo de restauración. Debe especificar un targetProjectId para las 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, la CLI devuelve un resultado similar al siguiente ejemplo. Los valores entre paréntesis representan sus 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