Dies ist das neue *CloudFormation Template Reference Guide*. Bitte aktualisieren Sie Ihre Lesezeichen und Links. Hilfe zu den ersten CloudFormation Schritten finden Sie im [AWS CloudFormation Benutzerhandbuch](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# `UpdateReplacePolicy` Attribut
Verwenden Sie das `UpdateReplacePolicy`-Attribut, um die vorhandene physische Instance einer Ressource beizubehalten oder (in einigen Fällen) zu sichern, wenn sie während einer Stack-Aktualisierung ersetzt wird.
Wenn Sie ein Stack-Update initiieren, CloudFormation aktualisiert die Ressourcen auf der Grundlage von Unterschieden zwischen dem, was Sie einreichen, und der aktuellen Vorlage und den Parametern des Stacks. Wenn Sie eine Ressourceneigenschaft aktualisieren, die erfordert, dass die Ressource ersetzt werden muss, wird die Ressource während der Aktualisierung CloudFormation neu erstellt. Weitere Informationen finden Sie unter [Aktualisieren von Verhalten von Stack-Ressourcen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html) im *AWS CloudFormation -Benutzerhandbuch*.
Durch die Neuerstellung der Ressource wird eine neue physische ID generiert. CloudFormation erstellt zuerst die Ersatzressource und ändert dann Verweise von anderen abhängigen Ressourcen so, dass sie auf die Ersatzressource verweisen. Löscht CloudFormation dann standardmäßig die alte Ressource. Mithilfe von können Sie angeben`UpdateReplacePolicy`, dass die alte Ressource CloudFormation beibehalten oder in einigen Fällen ein Snapshot erstellt werden soll.
Geben Sie für Ressourcen, die Snapshots unterstützen, z. B. `Snapshot` an`AWS::EC2::Volume`, dass vor dem Löschen der alten Ressourceninstanz ein Snapshot CloudFormation erstellt werden soll.
Sie können das `UpdateReplacePolicy`-Attribut auf beliebige Ressourcen anwenden. `UpdateReplacePolicy` wird nur ausgeführt, wenn Sie eine Ressourceneigenschaft aktualisieren, für deren Aktualisierungsverhalten **Ersatz** angegeben ist. Dadurch ersetzt CloudFormation die alte Ressource durch eine neue mit einer neuen physischen ID. Wenn Sie beispielsweise die `Engine` Eigenschaft eines [AWS: :RDS:: DBInstance](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-rds-database-instance.html) -Ressourcentyps aktualisieren, CloudFormation eine neue Ressource erstellen und die aktuelle DB-Instance-Ressource durch die neue ersetzen. Das `UpdateReplacePolicy` Attribut würde dann vorgeben, ob die alte DB-Instance CloudFormation gelöscht, beibehalten oder ein Snapshot erstellt wurde. Das Aktualisierungsverhalten für jede Eigenschaft einer Ressource ist im Referenzthema zur jeweiligen Ressource in der [AWS Referenz zu Ressourcen- und Eigenschaftstypen](aws-template-resource-type-ref.md) angegeben.
Das `UpdateReplacePolicy`-Attribut gilt für [direkt ausgeführte Stack-Aktualisierungen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-direct.html)und für Stack-Aktualisierungen, die mithilfe von [Änderungssätzen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-changesets.html) ausgeführt werden.
**Anmerkung**
Beibehaltene Ressourcen bleiben so lange erhalten und verursachen so lange weitere Gebühren, bis Sie diese Ressourcen löschen. Snapshots, die mit dieser Richtlinie erstellt wurden, existieren weiterhin und es fallen weiterhin Gebühren an, bis Sie diese Snapshots löschen. `UpdateReplacePolicy`behält die alte physische Ressource oder den alten Snapshot bei, entfernt ihn jedoch aus dem CloudFormation Gültigkeitsbereich.
`UpdateReplacePolicy` unterscheidet sich darin vom [`DeletionPolicy`](aws-attribute-deletionpolicy.md)-Attribut, dass es nur auf Ressourcen angewendet wird, die während Stack-Aktualisierungen ersetzt werden. Verwenden Sie `DeletionPolicy` für Ressourcen, die gelöscht werden, wenn ein Stack gelöscht wird, oder wenn die Ressourcendefinition selbst als Teil einer Stack-Aktualisierung aus der Vorlage gelöscht wird.
Das folgende Snippet enthält eine Amazon RDS-Datenbank-Instance-Ressource mit einer `Retain`-Richtlinie für Ersetzungen. Wenn diese Ressource durch eine neue Ressource mit einer neuen physikalischen ID ersetzt wird, wird die alte Datenbankinstanz CloudFormation verlassen, ohne sie zu löschen.
## 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: {}
```
## `UpdateReplacePolicy`-Optionen
`Delete`
CloudFormation löscht die Ressource und ihren gesamten Inhalt, falls zutreffend, während die Ressource ersetzt wird. Sie können diese Richtlinie jedem Ressourcentyp hinzufügen. Wenn Sie kein angeben `UpdateReplacePolicy`, werden Ihre Ressourcen standardmäßig von CloudFormation gelöscht. Dabei sollten Sie allerdings Folgendes beachten:
Bei Amazon S3-Buckets müssen Sie alle Objekte innerhalb des Buckets löschen, damit die Löschung erfolgreich ausgeführt werden kann.
`Retain`
CloudFormation behält die Ressource bei, ohne die Ressource oder ihren Inhalt zu löschen, wenn die Ressource ersetzt wird. Sie können diese Richtlinie jedem Ressourcentyp hinzufügen. Beibehaltene Ressourcen bleiben so lange erhalten und verursachen so lange weitere Gebühren, bis Sie diese Ressourcen löschen.
Wenn eine Ressource ersetzt wird, `UpdateReplacePolicy` behält sie die alte physische Ressource bei, entfernt sie jedoch aus dem CloudFormation Gültigkeitsbereich.
`Snapshot`
Bei Ressourcen, die Snapshots unterstützen, CloudFormation wird vor dem Löschen ein Snapshot für die Ressource erstellt. Mit dieser Richtlinie erstellte Snapshots bleiben so lange erhalten und verursachen so lange weitere Gebühren, bis Sie diese Snapshots löschen.
Wenn Sie die `Snapshot` Option `UpdateReplacePolicy` für eine Ressource angeben, die keine Snapshots unterstützt, wird zur Standardoption CloudFormation zurückgesetzt, die lautet. `Delete`
Zu den Ressourcen, die Snapshots unterstützen, gehören:
+ `[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)`