Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # PutBackupVaultLockConfiguration Menerapkan AWS Backup Vault Lock ke brankas cadangan, mencegah upaya untuk menghapus titik pemulihan yang disimpan atau dibuat di brankas cadangan. Vault Lock juga mencegah upaya untuk memperbarui kebijakan siklus hidup yang mengontrol periode penyimpanan titik pemulihan apa pun yang saat ini disimpan di brankas cadangan. Jika ditentukan, Vault Lock memberlakukan periode retensi minimum dan maksimum untuk pekerjaan pencadangan dan penyalinan di masa mendatang yang menargetkan brankas cadangan. **catatan** AWS Backup Vault Lock telah dinilai oleh Cohasset Associates untuk digunakan di lingkungan yang tunduk pada peraturan SEC 17a-4, CFTC, dan FINRA. Untuk informasi selengkapnya tentang bagaimana AWS Backup Vault Lock berhubungan dengan peraturan ini, lihat Penilaian Kepatuhan [Cohasset Associates](https://docs.aws.amazon.com/aws-backup/latest/devguide/samples/cohassetreport.zip). Untuk informasi selengkapnya, lihat [Kunci Penyimpanan AWS Backup](https://docs.aws.amazon.com/aws-backup/latest/devguide/vault-lock.html). ## Minta Sintaks ``` PUT /backup-vaults/backupVaultName/vault-lock HTTP/1.1 Content-type: application/json { "ChangeableForDays": number, "MaxRetentionDays": number, "MinRetentionDays": number } ``` ## Parameter Permintaan URI Permintaan menggunakan parameter URI berikut. ** [backupVaultName](#API_PutBackupVaultLockConfiguration_RequestSyntax) ** Konfigurasi AWS Backup Vault Lock yang menentukan nama brankas cadangan yang dilindunginya. Pola: `^[a-zA-Z0-9\-\_]{2,50}$` Wajib: Ya ## Isi Permintaan Permintaan menerima data berikut dalam format JSON. ** [ChangeableForDays](#API_PutBackupVaultLockConfiguration_RequestSyntax) ** Konfigurasi AWS Backup Vault Lock yang menentukan jumlah hari sebelum tanggal penguncian. Misalnya, pengaturan `ChangeableForDays` ke 30 pada 1 Januari 2022 pukul 8 malam UTC akan menetapkan tanggal kunci menjadi 31 Januari 2022 pukul 8 malam UTC. AWS Backup memberlakukan periode pendinginan 72 jam sebelum Vault Lock berlaku dan menjadi tidak dapat diubah. Oleh karena itu, Anda harus mengatur `ChangeableForDays` ke 3 atau lebih besar. Nilai maksimum yang dapat Anda tentukan adalah 36.500 hari (sekitar 100 tahun). Sebelum tanggal penguncian, Anda dapat menghapus Vault Lock dari vault menggunakan `DeleteBackupVaultLockConfiguration` atau mengubah konfigurasi Vault Lock menggunakan. `PutBackupVaultLockConfiguration` Pada dan setelah tanggal penguncian, Kunci Vault menjadi tidak dapat diubah dan tidak dapat diubah atau dihapus. Jika parameter ini tidak ditentukan, Anda dapat menghapus Vault Lock dari vault menggunakan `DeleteBackupVaultLockConfiguration` atau mengubah konfigurasi Vault Lock menggunakan `PutBackupVaultLockConfiguration` kapan saja. Tipe: Panjang Wajib: Tidak ** [MaxRetentionDays](#API_PutBackupVaultLockConfiguration_RequestSyntax) ** Konfigurasi AWS Backup Vault Lock yang menentukan periode retensi maksimum dimana vault mempertahankan titik pemulihannya. Pengaturan ini dapat berguna jika, misalnya, kebijakan organisasi Anda mengharuskan Anda untuk menghancurkan data tertentu setelah menyimpannya selama empat tahun (1460 hari). Jika parameter ini tidak disertakan, Vault Lock tidak menerapkan periode retensi maksimum pada titik pemulihan di vault. Jika parameter ini disertakan tanpa nilai, Vault Lock tidak akan menerapkan periode retensi maksimum. Jika parameter ini ditentukan, pekerjaan pencadangan atau penyalinan apa pun ke vault harus memiliki kebijakan siklus hidup dengan periode retensi sama dengan atau lebih pendek dari periode retensi maksimum. Jika periode retensi pekerjaan lebih lama dari periode retensi maksimum tersebut, vault akan gagal melakukan pekerjaan pencadangan atau penyalinan, dan Anda harus mengubah setelan siklus hidup atau menggunakan brankas yang berbeda. Periode retensi maksimum terpanjang yang dapat Anda tentukan adalah 36500 hari (sekitar 100 tahun). Titik pemulihan yang sudah disimpan di brankas sebelum Vault Lock tidak terpengaruh. Tipe: Panjang Wajib: Tidak ** [MinRetentionDays](#API_PutBackupVaultLockConfiguration_RequestSyntax) ** Konfigurasi AWS Backup Vault Lock yang menentukan periode retensi minimum tempat vault mempertahankan titik pemulihannya. Pengaturan ini dapat berguna jika, misalnya, kebijakan organisasi Anda mengharuskan Anda menyimpan data tertentu setidaknya selama tujuh tahun (2555 hari). Parameter ini diperlukan saat kunci vault dibuat AWS CloudFormation; jika tidak, parameter ini opsional. Jika parameter ini tidak ditentukan, Vault Lock tidak akan menerapkan periode retensi minimum. Jika parameter ini ditentukan, pekerjaan pencadangan atau penyalinan apa pun ke vault harus memiliki kebijakan siklus hidup dengan periode retensi sama dengan atau lebih lama dari periode penyimpanan minimum. Jika periode retensi pekerjaan lebih pendek dari periode retensi minimum tersebut, vault akan gagal melakukan pencadangan atau penyalinan pekerjaan tersebut, dan Anda harus mengubah setelan siklus hidup atau menggunakan vault yang berbeda. Periode retensi minimum terpendek yang dapat Anda tentukan adalah 1 hari. Titik pemulihan yang sudah disimpan di brankas sebelum Vault Lock tidak terpengaruh. Tipe: Panjang Wajib: Tidak ## Sintaksis Respons ``` HTTP/1.1 200 ``` ## Elemen Respons Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong. ## Kesalahan Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Jenis Kesalahan Umum](CommonErrors.md). ** InvalidParameterValueException ** Menunjukkan bahwa ada sesuatu yang salah dengan nilai parameter. Misalnya, nilainya di luar jangkauan. ** Context ** ** Type ** Kode Status HTTP: 400 ** InvalidRequestException ** Menunjukkan bahwa ada sesuatu yang salah dengan input ke permintaan. Misalnya, parameter adalah tipe yang salah. ** Context ** ** Type ** Kode Status HTTP: 400 ** MissingParameterValueException ** Menunjukkan bahwa parameter yang diperlukan tidak ada. ** Context ** ** Type ** Kode Status HTTP: 400 ** ResourceNotFoundException ** Sumber daya yang diperlukan untuk tindakan tidak ada. ** Context ** ** Type ** Kode Status HTTP: 400 ** ServiceUnavailableException ** Permintaan gagal karena kegagalan sementara server. ** Context ** ** Type ** Kode Status HTTP: 500 ## Lihat Juga Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini: + [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/PutBackupVaultLockConfiguration) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/PutBackupVaultLockConfiguration) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/PutBackupVaultLockConfiguration) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/PutBackupVaultLockConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/PutBackupVaultLockConfiguration) + [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/PutBackupVaultLockConfiguration) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/PutBackupVaultLockConfiguration) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/PutBackupVaultLockConfiguration) + [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/PutBackupVaultLockConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/PutBackupVaultLockConfiguration)