Atributo DeletionPolicy - AWS CloudFormation

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Atributo DeletionPolicy

Con el atributo DeletionPolicy puede conservar o (en algunos casos) crear un backup de un recurso cuando se elimina su pila. Puede especificar un atributo DeletionPolicy para cada recurso que desea controlar. Si un recurso no tiene ningún atributo DeletionPolicy, AWS CloudFormation elimina el recurso de forma predeterminada.

Tenga en cuenta que esta capacidad también se aplica a las operaciones de actualización de pilas que hacen que se eliminen recursos de las pilas. Por ejemplo, si elimina el recurso de la plantilla de pila y, a continuación, actualiza la pila con la plantilla. Esta capacidad no se aplica a los recursos cuya instancia física se sustituye durante las operaciones de actualización de la pila. Por ejemplo, si edita las propiedades de un recurso de tal forma que AWS CloudFormation sustituya dicho recurso durante la actualización de una pila.

nota

Excepción: la política predeterminada es Snapshot para los recursos de AWS::RDS::DBCluster y para los recursos de AWS::RDS::DBInstance que no especifican la propiedad DBClusterIdentifier.

Para mantener un recurso cuando se elimina su pila, especifique Retain para ese recurso. Puede utilizar conservar para cualquier recurso. Por ejemplo, puede conservar una pila anidada, el bucket de Amazon S3 o la instancia EC2 para poder seguir utilizando o modificando esos recursos después de eliminar sus pilas.

nota

Si desea modificar recursos fuera de AWS CloudFormation, utilice una política de conservación y, a continuación, elimine la pila. De lo contrario, sus recursos podrían desactualizarse con la plantilla de AWS CloudFormation y producir errores de pila.

Para los recursos que admiten instantáneas, como por ejemplo AWS::EC2::Volume, puede especificar Snapshot para que AWS CloudFormation cree una instantánea antes de eliminar el recurso.

El siguiente fragmento de código contiene un recurso de bucket de Amazon S3 con una política de eliminación Retain. Cuando se elimina esta pila, AWS CloudFormation deja el bucket sin eliminarlo.

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

Opciones DeletionPolicy

Delete

AWS CloudFormation elimina el recurso y todo su contenido si procede durante la eliminación de la pila. Puede añadir esta política de eliminación a cualquier tipo de recurso. De forma predeterminada, si no especifica una DeletionPolicy, AWS CloudFormation elimina sus recursos. Sin embargo, debe tener en cuenta las siguientes consideraciones:

  • En el caso de recursos AWS::RDS::DBCluster, la política predeterminada es Snapshot.

  • Para los recursos AWS::RDS::DBInstance que no especifican la propiedad DBClusterIdentifier, la política predeterminada es Snapshot.

  • Para buckets de Amazon S3, debe eliminar todos los objetos en el bucket para una correcta eliminación.

Retener

AWS CloudFormation mantiene el recurso sin eliminar el recurso o su contenido cuando se elimina su pila. Puede añadir esta política de eliminación a cualquier tipo de recurso. Tenga en cuenta que cuando AWS CloudFormation completa la eliminación de la pila, la pila tendrá el estado Delete_Complete; sin embargo, los recursos que se conservan siguen existiendo y siguen devengando cargos aplicables hasta que elimina esos recursos.

Para actualizar operaciones, las siguientes consideraciones son aplicables:

  • Si se elimina un recurso, la política DeletionPolicy conserva el recurso físico, pero garantiza que se elimine del ámbito de AWS CloudFormation.

  • Si un recurso se actualiza de forma que se crea un nuevo recurso físico para sustituir el recurso anterior, el recurso anterior se elimina por completo, incluido el ámbito de AWS CloudFormation.

Instantánea

Para los recursos que admiten instantáneas, AWS CloudFormation crea una instantánea para el recurso antes de eliminarlo. Tenga en cuenta que cuando AWS CloudFormation completa la eliminación de la pila, la pila tendrá el estado Delete_Complete; sin embargo, las instantáneas que se crean con esta política siguen existiendo y siguen devengando cargos hasta que elimina esas instantáneas.

Entre los recursos que admiten instantáneas se incluyen: