

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.

# BackupRule
<a name="API_BackupRule"></a>

Spécifie une tâche planifiée utilisée pour sauvegarder une sélection de ressources.

## Table des matières
<a name="API_BackupRule_Contents"></a>

 ** RuleName **   <a name="Backup-Type-BackupRule-RuleName"></a>
Nom d'affichage d'une règle de sauvegarde. Doit contenir de 1 à 50 caractères alphanumériques ou « -\$1. » caractères.  
Type : Chaîne  
Modèle : `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Obligatoire : oui

 ** TargetBackupVaultName **   <a name="Backup-Type-BackupRule-TargetBackupVaultName"></a>
Le nom d'un conteneur logique où les sauvegardes sont stockées. Les coffres-forts de sauvegarde sont identifiés par des noms spécifiques pour le compte utilisé pour les créer et la région AWS dans laquelle ils sont créés.  
Type : Chaîne  
Modèle : `^[a-zA-Z0-9\-\_]{2,50}$`   
Obligatoire : oui

 ** CompletionWindowMinutes **   <a name="Backup-Type-BackupRule-CompletionWindowMinutes"></a>
Une valeur en minutes après le démarrage réussi d'une tâche de sauvegarde et avant qu'elle doive être terminée ou qu'elle soit annulée par AWS Backup. Cette valeur est facultative.  
Type : Long  
Obligatoire : non

 ** CopyActions **   <a name="Backup-Type-BackupRule-CopyActions"></a>
Tableau d'objets `CopyAction`, qui contient les détails de l'opération de copie.  
Type : tableau d’objets [CopyAction](API_CopyAction.md)  
Obligatoire : non

 ** EnableContinuousBackup **   <a name="Backup-Type-BackupRule-EnableContinuousBackup"></a>
Spécifie s'il AWS Backup crée des sauvegardes continues. De véritables raisons AWS Backup de créer des sauvegardes continues capables de point-in-time restauration (PITR). Faux (ou non spécifié) entraîne AWS Backup la création de sauvegardes instantanées.  
Type : booléen  
Obligatoire : non

 ** IndexActions **   <a name="Backup-Type-BackupRule-IndexActions"></a>
IndexActions est un tableau que vous utilisez pour spécifier la manière dont les données de sauvegarde doivent être indexées.  
Chacune BackupRule peut avoir 0 ou 1 IndexAction, car chaque sauvegarde peut être associée à un index au maximum.  
Dans le tableau se trouve ResourceType. Un seul sera accepté pour chacun BackupRule.  
Type : tableau d’objets [IndexAction](API_IndexAction.md)  
Obligatoire : non

 ** Lifecycle **   <a name="Backup-Type-BackupRule-Lifecycle"></a>
Le cycle de vie définit le moment où une ressource protégée est transférée vers le stockage à froid et sa date d'expiration. AWS Backup effectue la transition et fait expirer les sauvegardes automatiquement en fonction du cycle de vie que vous définissez.   
Les sauvegardes transférées vers une chambre froide doivent être stockées dans une chambre froide pendant au moins 90 jours. Par conséquent, le paramètre « rétention » doit être supérieur de 90 jours au paramètre « nombre de jours avant transfert vers stockage à froid ». Le paramètre « nombre de jours avant transfert vers stockage à froid » ne peut pas être modifié après le transfert d’une sauvegarde vers un stockage à froid.   
Les types de ressources pouvant passer au stockage à froid sont répertoriés dans le tableau [Disponibilité des fonctionnalités par ressource](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup ignore cette expression pour les autres types de ressources.  
Type : objet [Lifecycle](API_Lifecycle.md)  
Obligatoire : non

 ** RecoveryPointTags **   <a name="Backup-Type-BackupRule-RecoveryPointTags"></a>
Les balises attribuées aux ressources associées à cette règle lors de la restauration à partir d'une sauvegarde.  
Type : mappage chaîne/chaîne  
Obligatoire : non

 ** RuleId **   <a name="Backup-Type-BackupRule-RuleId"></a>
Identifie de manière unique une règle utilisée pour planifier la sauvegarde d'une sélection de ressources.  
Type : chaîne  
Obligatoire : non

 ** ScanActions **   <a name="Backup-Type-BackupRule-ScanActions"></a>
Contient votre configuration d'analyse pour la règle de sauvegarde et inclut le scanner de malwares et le mode d'analyse complet ou incrémentiel.  
Type : tableau d’objets [ScanAction](API_ScanAction.md)  
Obligatoire : non

 ** ScheduleExpression **   <a name="Backup-Type-BackupRule-ScheduleExpression"></a>
Expression cron en UTC indiquant à quel moment une tâche de sauvegarde est AWS Backup initiée. Lorsqu'aucune expression CRON n'est fournie, AWS Backup utilise l'expression `cron(0 5 ? * * *)` par défaut.  
Pour plus d'informations sur les expressions AWS cron, consultez la section [Schedule Expressions for Rules](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/ScheduledEvents.html) dans le *guide de l'utilisateur Amazon CloudWatch Events*.  
Deux exemples d'expressions AWS cron sont ` 15 * ? * * *` (effectuer une sauvegarde toutes les heures 15 minutes après l'heure) et `0 12 * * ? *` (effectuer une sauvegarde tous les jours à midi UTC).  
Pour consulter un tableau d'exemples, cliquez sur le lien précédent et faites défiler la page vers le bas.  
Type : chaîne  
Obligatoire : non

 ** ScheduleExpressionTimezone **   <a name="Backup-Type-BackupRule-ScheduleExpressionTimezone"></a>
Fuseau horaire dans lequel l'expression de planification est définie. Par défaut, ScheduleExpressions ils sont en UTC. Vous pouvez le modifier pour un fuseau horaire spécifique.  
Type : chaîne  
Obligatoire : non

 ** StartWindowMinutes **   <a name="Backup-Type-BackupRule-StartWindowMinutes"></a>
Valeur en minutes après la planification d'une sauvegarde avant qu'une tâche soit annulée si elle ne démarre pas correctement. Cette valeur est facultative. Si cette valeur est incluse, elle doit être d'au moins 60 minutes pour éviter les erreurs.  
Pendant la fenêtre de démarrage, le statut de la tâche de sauvegarde reste `CREATED` jusqu'à ce qu'elle ait démarré ou jusqu'à ce que le délai de la fenêtre de démarrage soit écoulé. Si, dans la fenêtre de démarrage, time AWS Backup reçoit une erreur autorisant une nouvelle tentative de la tâche, elle AWS Backup réessaiera automatiquement de recommencer la tâche au moins toutes les 10 minutes jusqu'à ce que la sauvegarde commence avec succès (le statut de la tâche passe à`RUNNING`) ou jusqu'à ce que le statut de la tâche passe à `EXPIRED` (ce qui devrait se produire une fois la fenêtre de démarrage terminée).  
Type : Long  
Obligatoire : non

 ** TargetLogicallyAirGappedBackupVaultArn **   <a name="Backup-Type-BackupRule-TargetLogicallyAirGappedBackupVaultArn"></a>
L'ARN d'un coffre-fort à espacement logique. L'ARN doit appartenir au même compte et à la même région. Si elles sont fournies, les ressources entièrement gérées prises en charge sont sauvegardées directement dans un coffre-fort à espacement logique, tandis que les autres ressources prises en charge créent un instantané temporaire (facturable) dans le coffre-fort de sauvegarde, puis le copient dans un coffre-fort à espacement logique. Les ressources non prises en charge ne sont sauvegardées que dans le coffre de sauvegarde spécifié.  
Type : chaîne  
Obligatoire : non

## consultez aussi
<a name="API_BackupRule_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/BackupRule) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/BackupRule) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/BackupRule) 