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.

# `DeletionPolicy`atribut
<a name="aws-attribute-deletionpolicy"></a>

Dengan `DeletionPolicy` atribut yang dapat Anda pertahankan, dan dalam beberapa kasus, buat cadangan sumber daya saat tumpukannya dihapus. Anda menentukan `DeletionPolicy` atribut untuk setiap sumber daya yang ingin Anda kontrol. Jika sumber daya tidak memiliki `DeletionPolicy` atribut, CloudFormation menghapus sumber daya secara default.

Kemampuan ini juga berlaku untuk operasi pembaruan tumpukan yang mengarah ke penghapusan sumber daya dari tumpukan. Sebagai contoh, jika Anda menghapus sumber daya dari templat tumpukan, dan kemudian memperbarui tumpukan dengan templat tersebut. Kemampuan ini tidak berlaku untuk sumber daya yang instans fisiknya diganti selama operasi pembaruan tumpukan. Misalnya, jika Anda mengedit properti sumber daya sehingga CloudFormation menggantikan sumber daya tersebut selama pembaruan tumpukan.

**catatan**  
**Pengecualian**: Kebijakan default adalah `Snapshot` untuk sumber daya `AWS::RDS::DBCluster` dan untuk sumber daya `AWS::RDS::DBInstance` yang tidak menentukan properti `DBClusterIdentifier`.

Untuk mempertahankan sumber daya saat tumpukan dihapus, tentukan `Retain` untuk sumber daya itu. Anda dapat menggunakan `Retain` untuk sumber daya apa pun. Misalnya, Anda dapat menyimpan tumpukan bersarang, bucket Amazon S3, atau instans EC2 sehingga Anda dapat terus menggunakan atau memodifikasi sumber daya tersebut setelah menghapus tumpukannya.

**catatan**  
Jika Anda ingin memodifikasi sumber daya di luar CloudFormation, gunakan kebijakan `Retain` penghapusan dan kemudian hapus tumpukan. Jika tidak, sumber daya Anda mungkin tidak sinkron dengan CloudFormation template Anda dan menyebabkan kesalahan tumpukan.

Untuk sumber daya yang mendukung snapshot, seperti`AWS::EC2::Volume`, tentukan `Snapshot` untuk CloudFormation membuat snapshot sebelum menghapus sumber daya.

Cuplikan berikut berisi sumber daya bucket Amazon S3 dengan `Retain` kebijakan penghapusan. Saat tumpukan ini dihapus, CloudFormation tinggalkan ember tanpa menghapusnya.

## JSON
<a name="aws-attribute-deletionpolicy-example.json"></a>

```
{
  "AWSTemplateFormatVersion" : "2010-09-09",
  "Resources" : {
    "MyBucket" : {
      "Type" : "AWS::S3::Bucket",
      "DeletionPolicy" : "Retain"
    }
  }
}
```

## YAML
<a name="aws-attribute-deletionpolicy-example.yaml"></a>

```
AWSTemplateFormatVersion: '2010-09-09'
Resources:
  MyBucket:
    Type: AWS::S3::Bucket
    DeletionPolicy: Retain
```

## Opsi `DeletionPolicy`
<a name="aws-attribute-deletionpolicy-options"></a>

`Delete`  
CloudFormation menghapus sumber daya dan semua kontennya jika berlaku selama penghapusan tumpukan. Anda dapat menambahkan kebijakan penghapusan ini ke jenis sumber daya apa pun. Secara default, jika Anda tidak menentukan`DeletionPolicy`, CloudFormation menghapus sumber daya Anda. Namun, perhatikan pertimbangan berikut ini:  
+ Untuk sumber daya `AWS::RDS::DBCluster`, kebijakan default adalah `Snapshot`.
+ Untuk sumber daya `AWS::RDS::DBInstance` yang tidak menentukan properti `DBClusterIdentifier`, kebijakan default adalah `Snapshot`.
+ Untuk bucket Amazon S3, Anda harus menghapus semua objek di bucket agar penghapusan berhasil.
Perilaku default CloudFormation adalah menghapus rahasia dengan ForceDeleteWithoutRecovery bendera.

`Retain`  
CloudFormation menyimpan sumber daya tanpa menghapus sumber daya atau isinya saat tumpukannya dihapus. Anda dapat menambahkan kebijakan penghapusan ini ke jenis sumber daya apa pun. Saat CloudFormation menyelesaikan penghapusan tumpukan, tumpukan akan dalam `Delete_Complete` status; namun, sumber daya yang dipertahankan terus ada dan terus dikenakan biaya yang berlaku hingga Anda menghapus sumber daya tersebut.  
Untuk operasi pembaruan, pertimbangan berikut berlaku:  
+ Jika sumber daya dihapus, sumber daya `DeletionPolicy` mempertahankan sumber daya fisik tetapi memastikan bahwa itu dihapus dari CloudFormation ruang lingkup.
+ Jika sumber daya diperbarui sedemikian rupa sehingga sumber daya fisik baru dibuat untuk menggantikan sumber daya lama, maka sumber daya lama sepenuhnya dihapus, termasuk dari CloudFormation ruang lingkup.

`RetainExceptOnCreate`  
`RetainExceptOnCreate`berperilaku seperti `Retain` untuk operasi tumpukan, kecuali untuk operasi tumpukan yang awalnya membuat sumber daya. Jika operasi tumpukan yang membuat sumber daya digulung kembali, CloudFormation hapus sumber daya. Untuk semua operasi tumpukan lainnya, seperti penghapusan tumpukan, CloudFormation mempertahankan sumber daya dan isinya. Hasilnya adalah sumber daya baru, kosong, dan tidak terpakai dihapus, sementara sumber daya yang digunakan dan datanya dipertahankan. Lihat dokumentasi [UpdateStack](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_UpdateStack.html)API untuk menggunakan kebijakan penghapusan ini sebagai parameter API tanpa memperbarui template Anda.

`Snapshot`  
Untuk sumber daya yang mendukung snapshot, CloudFormation buat snapshot untuk sumber daya sebelum menghapusnya. Saat CloudFormation menyelesaikan penghapusan tumpukan, tumpukan akan berada dalam `Delete_Complete` status; namun, snapshot yang dibuat dengan kebijakan ini tetap ada dan terus dikenakan biaya yang berlaku hingga Anda menghapus snapshot tersebut.  
Sumber daya yang mendukung snapshot mencakup:  
+ [AWS::DocDB:: DBCluster](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-docdb-dbcluster.html)
+ [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)