DeletionPolicy Attribut

Mit dem DeletionPolicy-Attribut können Sie eine Ressource beibehalten und in einigen Fällen sichern, wenn deren Stack gelöscht wird. Sie können ein DeletionPolicy-Attribut für jede Ressource angeben, die Sie kontrollieren wollen. Wenn eine Ressource kein DeletionPolicy Attribut hat, AWS CloudFormation wird die Ressource standardmäßig gelöscht.

Diese Funktion gilt auch für Stack-Aktualisierungsoperationen, die dazu führen, dass Ressourcen in Stacks gelöscht werden. Dies ist der Fall, wenn Sie zum Beispiel die Ressource aus der Stack-Vorlage entfernen und dann den Stack mit der Vorlage aktualisieren. Diese Funktion gilt nicht für Ressourcen, deren physische Instance während der Stack-Aktualisierungsoperationen ersetzt wird. Wenn Sie beispielsweise die Eigenschaften einer Ressource so bearbeiten, dass diese Ressource bei einem Stack-Update CloudFormation ersetzt wird.

Anmerkung

Ausnahme: Die Standardrichtlinie ist Snapshot für AWS::RDS::DBCluster-Ressourcen und für AWS::RDS::DBInstance-Ressourcen, die die Eigenschaft DBClusterIdentifier nicht angeben.

Um eine Ressource beizubehalten, wenn deren Stack gelöscht wird, geben Sie Retain für diese Ressource an. Sie können Retain für alle beliebigen Ressourcen verwenden. Sie können beispielsweise einen verschachtelten Stack, einen Amazon S3 S3-Bucket oder eine EC2 Instance beibehalten, sodass Sie diese Ressourcen weiterhin verwenden oder ändern können, nachdem Sie ihre Stacks gelöscht haben.

Anmerkung

Wenn Sie Ressourcen außerhalb von ändern möchten CloudFormation, verwenden Sie eine Retain Löschrichtlinie und löschen Sie dann den Stack. Andernfalls könnten Ihre Ressourcen nicht mehr mit Ihrer CloudFormation Vorlage synchron sein und Stack-Fehler verursachen.

Geben Sie für Ressourcen, die Snapshots unterstützen, z. B. Snapshot anAWS::EC2::Volume, dass vor dem Löschen der Ressource ein Snapshot CloudFormation erstellt werden soll.

Das folgende Snippet enthält eine Amazon S3-Bucket-Ressource mit einer Retain-Löschrichtlinie. Wenn dieser Stapel gelöscht wird, wird der Bucket CloudFormation verlassen, ohne ihn zu löschen.

JSON

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

YAML

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

DeletionPolicy-Optionen

Delete

CloudFormation löscht die Ressource und ihren gesamten Inhalt, falls zutreffend, beim Löschen des Stacks. Sie können diese Löschungs-Richtlinie jedem Ressourcentyp hinzufügen. Standardmäßig werden Ihre Ressourcen CloudFormation gelöschtDeletionPolicy, wenn Sie keine angeben. Dabei sollten Sie allerdings Folgendes beachten:

• Für AWS::RDS::DBCluster-Ressourcen ist die Standardrichtlinie Snapshot.

• Für AWS::RDS::DBInstance-Ressourcen, die die DBClusterIdentifier-Eigenschaft nicht angeben, ist die Standardrichtlinie Snapshot.

• Bei Amazon S3-Buckets müssen Sie alle Objekte innerhalb des Buckets löschen, damit die Löschung erfolgreich ausgeführt werden kann.

Anmerkung

Das Standardverhalten von CloudFormation besteht darin, das Geheimnis mit der ForceDeleteWithoutRecovery Markierung zu löschen.

Retain

CloudFormation behält die Ressource bei, ohne die Ressource oder ihren Inhalt zu löschen, wenn ihr Stapel gelöscht wird. Sie können diese Löschungs-Richtlinie jedem Ressourcentyp hinzufügen. Wenn das Löschen des Stacks CloudFormation abgeschlossen ist, befindet sich der Stapel im Delete_Complete Status. Ressourcen, die beibehalten wurden, sind jedoch weiterhin vorhanden und es fallen weiterhin Gebühren an, bis Sie diese Ressourcen löschen.

Für Aktualisierungen sind die folgenden Aspekte zu berücksichtigen:

• Wenn eine Ressource gelöscht wird, DeletionPolicy behält sie die physische Ressource bei, stellt jedoch sicher, dass sie aus dem CloudFormation Gültigkeitsbereich gelöscht wurde.

• Wenn eine Ressource so aktualisiert wird, dass eine neue physische Ressource erstellt wird, um die alte Ressource zu ersetzen, wird die alte Ressource vollständig gelöscht, auch aus dem CloudFormation Gültigkeitsbereich.

RetainExceptOnCreate

RetainExceptOnCreate verhält sich wie Retain bei Stack-Vorgängen, mit Ausnahme des Stack-Vorgangs, mit dem die Ressource ursprünglich erstellt wurde. Wenn der Stack-Vorgang, mit dem die Ressource erstellt wurde, zurückgesetzt wird, wird die Ressource CloudFormation gelöscht. Bei allen anderen Stack-Vorgängen, wie z. B. beim Löschen von Stacks, werden die Ressource und ihr Inhalt CloudFormation beibehalten. Dadurch werden neue, leere und ungenutzte Ressourcen gelöscht, während genutzte Ressourcen und ihre Daten beibehalten werden. Informationen zur Verwendung dieser Löschrichtlinie als API Parameter, ohne Ihre Vorlage zu aktualisieren, finden Sie in der UpdateStackAPIDokumentation.

Snapshot

Bei Ressourcen, die Snapshots unterstützen, CloudFormation erstellt vor dem Löschen einen Snapshot für die Ressource. Wenn das Löschen des Stacks CloudFormation abgeschlossen ist, befindet sich der Stack im Delete_Complete Status. Die mit dieser Richtlinie erstellten Snapshots sind jedoch weiterhin vorhanden und es fallen weiterhin Gebühren an, bis Sie diese Snapshots löschen.

Zu den Ressourcen, die Snapshots unterstützen, gehören:

• AWS::DocDB::DBCluster

• AWS::EC2::Volume

• AWS::ElastiCache::CacheCluster

• AWS::ElastiCache::ReplicationGroup

• AWS::Neptune::DBCluster

• AWS::RDS::DBCluster

• AWS::RDS::DBInstance

• AWS::Redshift::Cluster