Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Restaurer à un moment précis
Vous pouvez restaurer un cluster à tout moment compris dans la période de rétention des sauvegardes du cluster en utilisant le Console de gestion AWS ou AWS Command Line Interface (AWS CLI).
**Note**
Vous ne pouvez pas effectuer une restauration instantanée d'un cluster 3.6 vers un cluster 4.0, mais vous pouvez migrer d'une version de cluster à une autre. Pour plus d’informations, consultez la section concernant [Migration et mise à niveau d'Amazon DocumentDB](docdb-migration.md).
Gardez ce qui suit à l'esprit lorsque vous restaurez un cluster à un instant dans le passé.
+ Le nouveau cluster est créé avec la même configuration que le cluster source, mais il est créé avec le groupe de paramètres par défaut. Pour définir le groupe de paramètres du nouveau cluster selon le groupe de paramètres du cluster source, modifiez le cluster une fois qu'il est *disponible*. Pour plus d'informations sur la modification d'un cluster, consultez [Modification d'un cluster Amazon DocumentDB](db-cluster-modify.md).
------
#### [ Using the Console de gestion AWS ]
Vous pouvez restaurer un cluster à un instant dans le passé inclus dans sa période de rétention de sauvegarde en procédant comme suit à l'aide de l’ Console de gestion AWS.
1. Connectez-vous au et ouvrez Console de gestion AWS la console Amazon DocumentDB à [ https://console.aws.amazon.com/docdb ](https://console.aws.amazon.com/docdb) l'adresse.
1. Dans le panneau de navigation, choisissez **Clusters**. Dans la liste des clusters, choisissez le bouton sur la gauche du cluster que vous voulez restaurer.
**Astuce**
Si vous ne voyez pas le volet de navigation sur le côté gauche de votre écran, choisissez l'icône de menu () dans le coin supérieur gauche de la page.
1. Dans le menu **Actions**, sélectionnez **Restore to point in time (Restaurer à un instant dans le passé)**.
1. Renseignez la section **Restore time (Heure de la restauration)**, qui spécifie la date et l'heure de la restauration.
1. **Date de restauration ** : choisissez ou entrez une date comprise entre l'heure de restauration la ** plus ancienne ** et l'heure de restauration la ** plus récente. **
1. **Heure de restauration ** : choisissez ou entrez les heures, les minutes et les secondes comprises entre l'heure de restauration la ** plus ancienne ** et l'heure de restauration la ** plus récente. **
1. Renseignez la section **Configuration**.
1. **Identifiant du cluster ** : acceptez l'identifiant par défaut ou entrez l'identifiant de votre choix.
Contraintes d'attribution de nom relatives à un cluster :
+ La longueur est de [1 à 63] lettres, chiffres ou tirets.
+ Le premier caractère doit être une lettre.
+ Ne peut pas se terminer par un trait d’union ni contenir deux traits d’union consécutifs.
+ Doit être unique pour tous les clusters d'Amazon RDS, Neptune et Amazon DocumentDB par Compte AWS région.
1. **Classe d'instance ** : dans la liste déroulante, choisissez la classe d'instance que vous souhaitez pour les instances du cluster.
1. **Nombre d'instances ** : dans la liste déroulante, choisissez le nombre d'instances que vous souhaitez créer lors de la restauration du cluster.
1. Pour la configuration ** du stockage en cluster**, choisissez une option de stockage.
**Note**
**La configuration I/O-Optimized ** de stockage Amazon DocumentDB est uniquement disponible sur les versions du moteur Amazon DocumentDB 5.0 et 8.0.
1. Facultatif. Pour configurer les paramètres réseau, les options de cluster, et activer les exportations de journaux, choisissez **Show advanced settings (Afficher les paramètres avancés)**, puis renseignez les sections suivantes. Dans le cas contraire, passez à l'étape suivante.
+ **Network settings (Paramètres réseau)**
1. **Virtual Private Cloud (VPC) ** : dans la liste déroulante, choisissez le VPC que vous souhaitez utiliser pour ce cluster.
1. **Groupe de sous-réseaux ** : dans la liste déroulante, choisissez le groupe de sous-réseaux pour ce cluster.
1. **Groupes de sécurité VPC ** : dans la liste déroulante, choisissez les groupes de sécurité VPC pour ce cluster.
+ **Options de cluster**
1. **Port ** : acceptez le port par défaut (27017) ou utilisez les flèches vers le haut et vers le bas pour définir le port de communication avec ce cluster.
+ **Exportations des journaux**
1. **Journaux d'audit ** : sélectionnez cette option pour activer l'exportation des journaux d'audit vers Amazon CloudWatch Logs. Si vous sélectionnez cette option, vous devez activer `audit_logs` dans le groupe de paramètres personnalisés du cluster. Pour de plus amples informations, veuillez consulter [Audit des événements Amazon DocumentDB](event-auditing.md).
1. **Journaux du profileur ** : sélectionnez cette option pour activer l'exportation des journaux du profileur d'opérations vers Amazon CloudWatch Logs. Si vous sélectionnez cette option, vous devez également modifier les paramètres suivants dans le groupe de paramètres personnalisés du cluster :
+ `profiler`— Réglez sur`enabled`.
+ `profiler_threshold_ms`— Définissez une valeur pour `[0-INT_MAX]` définir le seuil pour les opérations de profilage.
+ `profiler_sampling_rate`— Définissez une valeur `[0.0-1.0]` pour définir le pourcentage d'opérations lentes à profiler.
Pour de plus amples informations, veuillez consulter [Profilage des opérations Amazon DocumentDB](profiling.md).
1. **Journaux du profileur ** : exportez les journaux du profileur vers Amazon CloudWatch
1. **Rôle IAM ** : dans la liste déroulante, choisissez * RDS Service Linked Role*.
+ **Balises**
1. **Ajouter une étiquette ** : dans la * zone * Clé, entrez le nom de la balise de votre cluster. Dans la zone *Value (Valeur)*, entrez la valeur de la balise, si vous le souhaitez. Les balises sont utilisées avec des politiques Gestion des identités et des accès AWS (IAM) pour gérer l'accès aux ressources Amazon DocumentDB et pour contrôler les actions qui peuvent être appliquées aux ressources.
+ **Deletion protection (Protection contre la suppression)**
1. **Activer la protection contre la suppression ** : protège le cluster contre toute suppression accidentelle. Lorsque cette option est activée, vous ne pouvez pas supprimer le cluster.
1. Pour restaurer le cluster, choisissez **Create cluster (Créer un cluster)**. Vous pouvez également choisir **Cancel (Annuler)** pour annuler l'opération.
------
#### [ Using the AWS CLI ]
Pour restaurer un cluster à un instant dans le passé avec la période de rétention des sauvegardes de l'instantané, utilisez l'opération `restore-db-cluster-to-point-in-time` avec les paramètres suivants.
+ **--db-cluster-identifier**— Obligatoire. Il faut créer le nom du nouveau cluster. Ce cluster ne peut pas exister avant l'opération. La valeur du paramètre doit respecter les contraintes suivantes.
Contraintes d'attribution de nom relatives à un cluster :
+ La longueur est de [1 à 63] lettres, chiffres ou tirets.
+ Le premier caractère doit être une lettre.
+ Ne peut pas se terminer par un trait d’union ni contenir deux traits d’union consécutifs.
+ Doit être unique pour tous les clusters d'Amazon RDS, Neptune et Amazon DocumentDB par Compte AWS région.
+ **--restore-to-time**— Date et heure UTC auxquelles restaurer le cluster. Par exemple, `2018-06-07T23:45:00Z`.
Contraintes de temps :
+ Elles doivent se situer avant l'heure de restauration la plus récente pour le cluster.
+ Cela doit être indiqué si le paramètre `--use-latest-restorable-time` n'est pas fourni.
+ Cela ne peut pas être spécifié lorsque le paramètre `--use-latest-restorable-time` est `true`.
+ Cela ne peut pas être spécifié lorsque la valeur du paramètre `--restore-type` est `copy-on-write`.
+ **--source-db-cluster-identifier**— Nom du cluster source à partir duquel effectuer la restauration. Ce cluster doit exister et être disponible.
+ **--use-latest-restorable-time**ou **--no-use-latest-restorable-time** — S'il faut restaurer la dernière heure de sauvegarde restaurable. Cela ne doit pas être indiqué si le paramètre `--restore-to-time` est fourni.
+ **--storage-type standard \| iopt1**— Facultatif. Valeur par défaut : `standard`.
L' AWS CLI opération restaure `restore-db-cluster-to-point-in-time` uniquement le cluster, pas les instances de ce cluster. Vous devez invoquer l'opération `create-db-instance` pour créer des instances pour le cluster restauré, en spécifiant l'identifiant du cluster restauré dans `--db-cluster-identifier`. Vous pouvez créer des instances de bases de données uniquement après la fin de l'opération `restore-db-cluster-to-point-in-time` et lorsque le cluster restauré est *disponible*.
**Example**
L'exemple suivant crée `sample-cluster-restored` à partir de l'instantané `sample-cluster-snapshot` vers la dernière heure de restauration la plus récente.
Pour Linux, macOS ou Unix :
```
aws docdb restore-db-cluster-to-point-in-time \
--db-cluster-identifier sample-cluster-restored \
--source-db-cluster-identifier sample-cluster-snapshot \
--use-latest-restorable-time
```
Pour Windows :
```
aws docdb restore-db-cluster-to-point-in-time ^
--db-cluster-identifier sample-cluster-restored ^
--source-db-cluster-identifier sample-cluster-snapshot ^
--use-latest-restorable-time
```
**Example**
L'exemple suivant crée `sample-cluster-restored` à partir de l'instantané `sample-cluster-snapshot` du 11 décembre 2018 à 03 h 15 (UTC), inclus dans la période de rétention des sauvegardes du `sample-cluster`.
Pour Linux, macOS ou Unix :
```
aws docdb restore-db-cluster-to-point-in-time \
--db-cluster-identifier sample-cluster-restore \
--source-db-cluster-identifier sample-cluster \
--restore-to-time 2020-05-12T03:15:00Z
```
Pour Windows :
```
aws docdb restore-db-cluster-to-point-in-time ^
--db-cluster-identifier sample-cluster-restore ^
--source-db-cluster-identifier sample-cluster ^
--restore-to-time 2020-05-12T03:15:00Z
```
Le résultat de cette opération ressemble à ceci.
```
{
"DBCluster": {
"AvailabilityZones": [
"us-east-1c",
"us-west-2b",
"us-west-2a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-restored",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "creating",
"Endpoint": "sample-cluster-restored.node.us-east-1.docdb.amazonaws.com",
"ReaderEndpoint": "sample-cluster-restored.node.us-east-1.docdb.amazonaws.com",
"MultiAZ": false,
"Engine": "docdb",
"EngineVersion": "4.0.0",
"Port": 27017,
"MasterUsername": "master-user",
"PreferredBackupWindow": "02:00-02:30",
"PreferredMaintenanceWindow": "tue:09:50-tue:10:20",
"DBClusterMembers": [],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abc0123",
"Status": "active"
}
],
"HostedZoneId": "ABCDEFGHIJKLM",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbClusterResourceId": "cluster-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"DBClusterArn": "arn:aws:rds:us-east-1::cluster:sample-cluster-restored",
"AssociatedRoles": [],
"ClusterCreateTime": "2020-04-24T20:14:36.713Z",
"DeletionProtection": false
}
}
```
------