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 eine Stack-Aktualisierung initiieren, aktualisiert CloudFormation Ressourcen basierend auf den Unterschieden zwischen dem, was Sie senden, und der aktuellen Vorlage und den aktuellen Parametern des Stacks. Wenn Sie eine Ressourceneigenschaft aktualisieren, die eine Ressourcenersetzung erfordert, erstellt CloudFormation die Ressource bei der Aktualisierung erneut. Weitere Informationen finden Sie unter Aktualisieren von Verhalten von Stack-Ressourcen im AWS CloudFormation-Benutzerhandbuch.

Wenn die Ressource neu erstellt wird, wird eine neue physische ID generiert. CloudFormation erstellt zunächst die Ersatz-Ressource und ändert dann Referenzen von anderen abhängigen Ressourcen so, dass sie auf die Ersatz-Ressource zeigen. Die alte Ressource wird dann standardmäßig von CloudFormation gelöscht. Sie können mit UpdateReplacePolicy angeben, dass CloudFormation einen Snapshot der alten Ressource beibehalten oder (in einigen Fällen) erstellen soll.

Bei Ressourcen, die Snapshots unterstützen, wie beispielsweise AWS::EC2::Volume, geben Sie Snapshot an. Auf diese Weise erstellt CloudFormation einen Snapshot, bevor die alte Ressourcen-Instance gelöscht wird.

Sie können das Attribut UpdateReplacePolicy auf jede beliebige Ressource anwenden. UpdateReplacePolicy wird nur ausgeführt, wenn Sie eine Ressourceneigenschaft aktualisieren, deren Aktualisierungsverhalten als Ersatzangegeben ist, wodurch CloudFormation veranlasst wird, die alte Ressource durch eine neue mit einer neuen physischen ID zu ersetzen. Wenn Sie beispielsweise die Engine-Eigenschaft eines AWS::RDS::DBInstance-Ressourcentyps aktualisieren, erstellt CloudFormation eine neue Ressource und ersetzt die aktuelle DB-Instance-Ressource durch die neue. Das UpdateReplacePolicy-Attribut gibt dann vor, ob CloudFormation einen Snapshot der alten DB-Instance löscht, beibehält oder erstellt. Das Aktualisierungsverhalten für jede Eigenschaft einer Ressource ist im Referenzthema zur jeweiligen Ressource in der angegeben AWSReferenz zu Ressourcen- und Eigenschaftstypen.

Das UpdateReplacePolicy-Attribut gilt für direkt ausgeführte Stack-Aktualisierungenund für Stack-Aktualisierungen, die mithilfe von Änderungssätzen ausgeführt werden.

UpdateReplacePolicy unterscheidet sich darin vom DeletionPolicy-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 Stapel gelöscht wird, oder wenn die Ressourcendefinition selbst als Teil einer Stapelaktualisierung 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 physischen ID ersetzt wird, bleibt die alte Datenbank-Instance erhalten und wird nicht von CloudFormation gelöscht.

{
  "AWSTemplateFormatVersion" : "2010-09-09",
  "Resources" : {
    "myDB" : {
      "Type" : "AWS::RDS::DBInstance",
      "DeletionPolicy" : "Retain",
      "UpdateReplacePolicy" : "Retain",
      "Properties" : {}
    }
  }
}

AWSTemplateFormatVersion: 2010-09-09
Resources:
  myDB:
    Type: 'AWS::RDS::DBInstance'
    DeletionPolicy: Retain
    UpdateReplacePolicy: Retain
    Properties: {} 

UpdateReplacePolicy-Optionen