Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# `AWS-EnableDocDbClusterBackupRetentionPeriod`
<a name="aws-enabledocdbclusterbackupretentionperiod"></a>

 **Descrizione** 

 Il `AWS-EnableDocDbClusterBackupRetentionPeriod` runbook consente un periodo di conservazione dei backup per il cluster Amazon DocumentDB specificato. Questa funzionalità imposta il numero totale di giorni per i quali viene conservato un backup automatico. Per modificare un cluster, il cluster deve essere nello stato disponibile con un tipo di motore di`docdb`. 

 [Esegui questa automazione (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-EnableDocDbClusterBackupRetentionPeriod) 

**Tipo di documento**

Automazione

**Proprietario**

Amazon

**Piattaforme**

Linux, macOS, Windows

**Parametri**
+ AutomationAssumeRole

  Tipo: stringa

  Descrizione: (Facoltativo) L'Amazon Resource Name (ARN) del ruolo AWS Identity and Access Management (IAM) che consente a Systems Manager Automation di eseguire le azioni per tuo conto. Se non viene specificato alcun ruolo, Systems Manager Automation utilizza le autorizzazioni dell'utente che avvia questo runbook.
+ DBClusterResourceId

  Tipo: stringa

  Descrizione: (Obbligatorio) L'ID della risorsa per il cluster Amazon DocumentDB per cui desideri abilitare il periodo di conservazione del backup.
+ BackupRetentionPeriod

  Tipo: integer

  Descrizione: (Obbligatorio) Il numero di giorni per i quali vengono conservati i backup automatici. Deve essere un valore compreso tra 7 e 35 giorni.
+ PreferredBackupWindow

  Tipo: stringa

  Descrizione: (Facoltativo) Un intervallo di tempo giornaliero in Universal Time Coordinated (UTC) nel formato hh24:mm-hh24:mm, ad esempio 07:14-07:44. Il valore deve essere di almeno 30 minuti e non può essere in conflitto con la finestra di manutenzione preferita.
+ `ssm:GetAutomationExecution`
+ `ssm:StartAutomationExecution`
+ `docdb:DescribeDBClusters`
+ `docdb:ModifyDBCluster`
+ `rds:DescribeDBClusters`
+ `rds:ModifyDBCluster`

 **Fasi del documento** 
+ GetDocDbClusterIdentifier (`aws:executeAwsApi`) - Restituisce l'identificatore del cluster Amazon DocumentDB utilizzando l'ID di risorsa fornito.
+ VerifyDocDbEngine (`aws:assertAwsResourceProperty`) - Verifica che il tipo `docdb` di motore Amazon DocumentDB serva a prevenire modifiche involontarie ad altri tipi di motore Amazon RDS.
+ VerifyDocDbStatus (`aws:waitAwsResourceProperty`) - Verifica che lo stato del cluster Amazon DocumentDB sia. `available` 
+ ModifyDocDbRetentionPeriod (`aws:executeAwsApi`) - Imposta il periodo di conservazione utilizzando i valori forniti per il cluster Amazon DocumentDB specificato. 
+ VerifyDocDbBackupsEnabled (`aws:executeScript`) - Verifica che il periodo di conservazione per il cluster Amazon DocumentDB e la finestra di backup preferita, se specificata, siano state impostate correttamente. 

 **Output** 

ModifyDocDbRetentionPeriod. ModifyDbClusterResponse - Risposta dall'operazione `ModifyDBCluster` API.

VerifyDocDbBackupsEnabled. VerifyDbClusterBackupsEnabledResponse - Output della `VerifyDocDbBackupsEnabled` fase di conferma dell'avvenuta modifica del cluster Amazon DocumentDB.