DeletionPolicyatribut - AWS CloudFormation
JSONYAMLOpsi DeletionPolicy

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

DeletionPolicyatribut

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, AWS 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, sepertiAWS::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

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

YAML

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

Opsi DeletionPolicy

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 menentukanDeletionPolicy, 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.

catatan

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

RetainExceptOnCreateberperilaku 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 UpdateStackAPI 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: