Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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

 **Deskripsi** 

 `AWS-EnableDocDbClusterBackupRetentionPeriod`Runbook memungkinkan periode retensi cadangan untuk klaster Amazon DocumentDB yang Anda tentukan. Fitur ini menetapkan jumlah hari di mana cadangan otomatis disimpan. Untuk memodifikasi cluster, cluster harus dalam keadaan yang tersedia dengan tipe mesin`docdb`. 

 [Jalankan Otomasi ini (konsol)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-EnableDocDbClusterBackupRetentionPeriod) 

**Jenis dokumen**

Otomatisasi

**Pemilik**

Amazon

**Platform**

Linux, macOS, Windows

**Parameter**
+ AutomationAssumeRole

  Tipe: String

  Deskripsi: (Opsional) Nama Sumber Daya Amazon (ARN) peran AWS Identity and Access Management (IAM) yang memungkinkan Otomasi Systems Manager untuk melakukan tindakan atas nama Anda. Jika tidak ada peran yang ditentukan, Systems Manager Automation menggunakan izin pengguna yang memulai runbook ini.
+ DBClusterResourceId

  Tipe: String

  Deskripsi: (Diperlukan) ID sumber daya untuk klaster Amazon DocumentDB yang ingin Anda aktifkan periode retensi cadangan.
+ BackupRetentionPeriod

  Jenis: Integer

  Deskripsi: (Wajib) Jumlah hari di mana cadangan otomatis dipertahankan. Harus nilai dari 7-35 hari.
+ PreferredBackupWindow

  Tipe: String

  Deskripsi: (Opsional) Rentang waktu harian dalam Universal Time Coordinated (UTC) dalam format hh24: mm-hh24: mm, misalnya 07:14-07:44. Nilai harus minimal 30 menit dan tidak dapat bertentangan dengan jendela pemeliharaan yang diinginkan.
+ `ssm:GetAutomationExecution`
+ `ssm:StartAutomationExecution`
+ `docdb:DescribeDBClusters`
+ `docdb:ModifyDBCluster`
+ `rds:DescribeDBClusters`
+ `rds:ModifyDBCluster`

 **Langkah Dokumen** 
+ GetDocDbClusterIdentifier (`aws:executeAwsApi`) - Mengembalikan pengidentifikasi klaster Amazon DocumentDB menggunakan ID sumber daya yang disediakan.
+ VerifyDocDbEngine (`aws:assertAwsResourceProperty`) - Memverifikasi jenis mesin Amazon DocumentDB adalah untuk mencegah perubahan yang tidak disengaja pada `docdb` jenis mesin Amazon RDS lainnya.
+ VerifyDocDbStatus (`aws:waitAwsResourceProperty`) - Memverifikasi status cluster Amazon DocumentDB adalah. `available` 
+ ModifyDocDbRetentionPeriod (`aws:executeAwsApi`) - Menetapkan periode retensi menggunakan nilai yang disediakan untuk klaster Amazon DocumentDB yang ditentukan. 
+ VerifyDocDbBackupsEnabled (`aws:executeScript`) - Memverifikasi periode retensi untuk klaster Amazon DocumentDB dan jendela cadangan pilihan, jika ditentukan, berhasil disetel. 

 **Keluaran** 

ModifyDocDbRetentionPeriod. ModifyDbClusterResponse - Respon dari operasi `ModifyDBCluster` API.

VerifyDocDbBackupsEnabled. VerifyDbClusterBackupsEnabledResponse - Output dari `VerifyDocDbBackupsEnabled` langkah yang mengonfirmasi keberhasilan modifikasi cluster Amazon DocumentDB.