Ini adalah *Panduan Referensi CloudFormation Template* baru. Harap perbarui bookmark dan tautan Anda. Untuk bantuan memulai CloudFormation, lihat [Panduan AWS CloudFormation Pengguna](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# `UpdateReplacePolicy`atribut
Gunakan atribut `UpdateReplacePolicy` untuk mempertahankan atau, dalam beberapa kasus, mencadangkan instans fisik sumber daya yang ada saat diganti selama operasi pembaruan tumpukan.
Saat Anda memulai pembaruan tumpukan, CloudFormation memperbarui sumber daya berdasarkan perbedaan antara apa yang Anda kirimkan dan templat serta parameter tumpukan saat ini. Jika Anda memperbarui properti sumber daya yang mengharuskan sumber daya diganti, CloudFormation buat ulang sumber daya selama pembaruan. Untuk informasi selengkapnya, lihat [Memperbarui perilaku sumber daya tumpukan](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html) di *Panduan AWS CloudFormation Pengguna*.
Membuat ulang sumber daya menghasilkan ID fisik baru. CloudFormation membuat sumber daya pengganti terlebih dahulu, dan kemudian mengubah referensi dari sumber daya dependen lainnya untuk menunjuk ke sumber daya pengganti. Secara default, CloudFormation kemudian menghapus sumber daya lama. Dengan menggunakan`UpdateReplacePolicy`, Anda dapat menentukan yang CloudFormation mempertahankan atau, dalam beberapa kasus, membuat snapshot dari sumber daya lama.
Untuk sumber daya yang mendukung snapshot, seperti`AWS::EC2::Volume`, tentukan `Snapshot` untuk CloudFormation membuat snapshot sebelum menghapus instance sumber daya lama.
Anda dapat menerapkan atribut `UpdateReplacePolicy` ke sumber daya apa pun. `UpdateReplacePolicy` hanya dijalankan jika Anda memperbarui properti sumber daya yang perilaku pembaruannya ditetapkan sebagai **Pengganti**, sehingga menyebabkan CloudFormation mengganti sumber daya lama dengan yang baru dengan ID fisik baru. Misalnya, jika Anda memperbarui `Engine` properti tipe DBInstance sumber daya [AWS: :RDS::](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-rds-database-instance.html), CloudFormation membuat sumber daya baru dan mengganti sumber daya instans DB saat ini dengan yang baru. `UpdateReplacePolicy`Atribut kemudian akan menentukan apakah CloudFormation dihapus, dipertahankan, atau membuat snapshot dari instance DB lama. Perilaku pembaruan untuk setiap properti sumber daya yang ditentukan dalam topik referensi untuk sumber daya tersebut di [AWS referensi jenis sumber daya dan properti](aws-template-resource-type-ref.md).
Atribut `UpdateReplacePolicy` berlaku untuk [pembaruan tumpukan yang Anda lakukan secara langsung](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-direct.html), selain pembaruan tumpukan yang dilakukan menggunakan [set perubahan](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-changesets.html).
**catatan**
Sumber daya yang dipertahankan tetap ada dan terus dikenakan biaya yang berlaku hingga Anda menghapus sumber daya tersebut. Snapshot yang dibuat dengan kebijakan ini tetap ada dan terus dikenakan biaya yang berlaku hingga Anda menghapus snapshot tersebut. `UpdateReplacePolicy`mempertahankan sumber daya fisik atau snapshot lama, tetapi menghapusnya dari ruang lingkup CloudFormation.
`UpdateReplacePolicy` berbeda dari atribut [`DeletionPolicy`](aws-attribute-deletionpolicy.md) karena hanya berlaku untuk sumber daya yang diganti selama pembaruan tumpukan. Gunakan `DeletionPolicy` untuk sumber daya yang dihapus saat tumpukan dihapus, atau ketika definisi sumber daya itu sendiri dihapus dari template sebagai bagian dari pembaruan tumpukan.
Cuplikan berikut berisi sumber daya instans database Amazon RDS dengan `Retain` kebijakan penggantian. Ketika sumber daya ini diganti dengan sumber daya baru dengan ID fisik baru, CloudFormation meninggalkan instance database lama tanpa menghapusnya.
## JSON
```
{
"AWSTemplateFormatVersion" : "2010-09-09",
"Resources" : {
"myDB" : {
"Type" : "AWS::RDS::DBInstance",
"DeletionPolicy" : "Retain",
"UpdateReplacePolicy" : "Retain",
"Properties" : {}
}
}
}
```
## YAML
```
AWSTemplateFormatVersion: 2010-09-09
Resources:
myDB:
Type: AWS::RDS::DBInstance
DeletionPolicy: Retain
UpdateReplacePolicy: Retain
Properties: {}
```
## Opsi `UpdateReplacePolicy`
`Delete`
CloudFormation menghapus sumber daya dan semua kontennya jika berlaku selama penggantian sumber daya. Anda dapat menambahkan kebijakan ini ke jenis sumber daya apa pun. Secara default, jika Anda tidak menentukan `UpdateReplacePolicy`, CloudFormation menghapus sumber daya Anda. Namun, perhatikan pertimbangan berikut ini:
Untuk bucket Amazon S3, Anda harus menghapus semua objek di bucket agar penghapusan berhasil.
`Retain`
CloudFormation menyimpan sumber daya tanpa menghapus sumber daya atau isinya saat sumber daya diganti. Anda dapat menambahkan kebijakan ini ke jenis sumber daya apa pun. Sumber daya yang dipertahankan tetap ada dan terus dikenakan biaya yang berlaku hingga Anda menghapus sumber daya tersebut.
Jika sumber daya diganti, sumber daya `UpdateReplacePolicy` mempertahankan sumber daya fisik lama tetapi menghapusnya dari CloudFormation ruang lingkup.
`Snapshot`
Untuk sumber daya yang mendukung snapshot, CloudFormation buat snapshot untuk sumber daya sebelum menghapusnya. Snapshot yang dibuat dengan kebijakan ini akan tetap ada dan terus dikenakan biaya yang berlaku hingga Anda menghapus snapshot tersebut.
Jika Anda menentukan `Snapshot` opsi `UpdateReplacePolicy` untuk sumber daya yang tidak mendukung snapshot, CloudFormation kembali ke opsi default, yaitu. `Delete`
Sumber daya yang mendukung snapshot mencakup:
+ `[AWS::EC2::Volume](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-volume.html)`
+ `[AWS::ElastiCache::CacheCluster](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-elasticache-cachecluster.html)`
+ `[AWS::ElastiCache::ReplicationGroup](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-elasticache-replicationgroup.html)`
+ `[AWS::Neptune::DBCluster](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-neptune-dbcluster.html)`
+ `[AWS::RDS::DBCluster](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-rds-dbcluster.html)`
+ `[AWS::RDS::DBInstance](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-rds-dbinstance.html)`
+ `[AWS::Redshift::Cluster](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-redshift-cluster.html)`