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 SEC 17a-4,, dan peraturan. CFTC FINRA Untuk informasi selengkapnya tentang bagaimana AWS Backup Vault Lock berhubungan dengan peraturan ini, lihat Penilaian Kepatuhan Cohasset Associates.
Untuk informasi selengkapnya, lihat Kunci Penyimpanan AWS Backup.
Sintaks Permintaan
PUT /backup-vaults/backupVaultName/vault-lock HTTP/1.1
Content-type: application/json
{
"ChangeableForDays": number,
"MaxRetentionDays": number,
"MinRetentionDays": number
}URIParameter Permintaan
Permintaan menggunakan URI parameter berikut.
- backupVaultName
-
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 JSON format.
- ChangeableForDays
-
Konfigurasi AWS Backup Vault Lock yang menentukan jumlah hari sebelum tanggal penguncian. Misalnya, pengaturan
ChangeableForDayske 30 pada 1 Januari 2022 pukul 8 malam UTC akan mengatur tanggal kunci menjadi 31 Januari 2022 pukul 8 malam. UTCAWS Backup memberlakukan periode pendinginan 72 jam sebelum Vault Lock berlaku dan menjadi tidak dapat diubah. Karena itu, Anda harus mengatur
ChangeableForDayske 3 atau lebih besar.Sebelum tanggal penguncian, Anda dapat menghapus Vault Lock dari vault menggunakan
DeleteBackupVaultLockConfigurationatau mengubah konfigurasi Vault Lock menggunakan.PutBackupVaultLockConfigurationPada 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
DeleteBackupVaultLockConfigurationatau mengubah konfigurasi Vault Lock menggunakanPutBackupVaultLockConfigurationkapan saja.Tipe: Panjang
Wajib: Tidak
- MaxRetentionDays
-
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
-
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 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 HTTP tubuh kosong.
Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.
- InvalidParameterValueException
-
Menunjukkan bahwa ada sesuatu yang salah dengan nilai parameter. Misalnya, nilainya di luar jangkauan.
HTTPKode Status: 400
- InvalidRequestException
-
Menunjukkan bahwa ada sesuatu yang salah dengan input ke permintaan. Misalnya, parameter adalah tipe yang salah.
HTTPKode Status: 400
- MissingParameterValueException
-
Menunjukkan bahwa parameter yang diperlukan tidak ada.
HTTPKode Status: 400
- ResourceNotFoundException
-
Sumber daya yang diperlukan untuk tindakan tidak ada.
HTTPKode Status: 400
- ServiceUnavailableException
-
Permintaan gagal karena kegagalan sementara server.
HTTPKode Status: 500
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan ini API di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
