Ressourcenattribute, unterstützt von AWS SAM

Ressourcenattribute sind Attribute, die Sie hinzufügen können, AWS SAM und AWS CloudFormation Ressourcen, um zusätzliche Verhaltensweisen und Beziehungen zu steuern. Weitere Informationen zu Ressourcenattributen finden Sie unter Referenz zu Ressourcenattributen im AWS CloudFormation Benutzerhandbuch.

AWS SAM unterstützt eine Teilmenge von Ressourcenattributen, die von AWS CloudFormation definiert sind. Einige der unterstützten Ressourcenattribute werden nur auf die generierte AWS CloudFormation Basisressource der entsprechenden AWS SAM Ressource kopiert, andere wiederum auf alle generierten AWS CloudFormation Ressourcen, die sich aus der entsprechenden AWS SAM Ressource ergeben. Weitere Hinweise zu AWS CloudFormation Ressourcen, die aus entsprechenden AWS SAM Ressourcen generiert wurden, finden Sie unterGenerierte AWS CloudFormation Ressourcen für AWS SAM.

In der folgenden Tabelle wird die Unterstützung von Ressourcenattributen zusammengefasst AWS SAM, abhängig von den unten Ausnahmen aufgeführten Kriterien.

Ressourcenattribute	Vom Ziel generierte Ressource (n)
DependsOn Metadaten 1, 2	Nur von der Basis AWS CloudFormation generierte Ressource. Informationen zur Zuordnung zwischen AWS SAM Ressourcen und AWS CloudFormation Basisressourcen finden Sie unterGenerierte AWS CloudFormation Ressourcenszenarien.
Zustand DeletionPolicy UpdateReplacePolicy	Alle generierten AWS CloudFormation Ressourcen aus der entsprechenden AWS SAM Ressource. Hinweise zu Szenarien für generierte AWS CloudFormation Ressourcen finden Sie unterGenerierte AWS CloudFormation Ressourcenszenarien.

Hinweise:

1. Weitere Hinweise zur Verwendung des Metadata Ressourcenattributs mit dem AWS::Serverless::Function Ressourcentyp finden Sie unterErstellen von Lambda-Funktionen mit benutzerdefinierten Laufzeiten in AWS SAM.

2. Weitere Hinweise zur Verwendung des Metadata Ressourcenattributs mit dem AWS::Serverless::LayerVersion Ressourcentyp finden Sie unterAufbau von Lambda-Schichten in AWS SAM.

Ausnahmen

Es gibt eine Reihe von Ausnahmen zu den zuvor beschriebenen Regeln für Ressourcenattribute:

• Für RetentionPolicy legt AWS::Lambda::LayerVersion das benutzerdefinierte Feld AWS SAM-only das DeletionPolicy für die generierten AWS CloudFormation Ressourcen fest. Dies hat eine höhere Priorität als DeletionPolicy es selbst. Wenn keiner von beiden festgelegt ist, DeletionPolicy ist standardmäßig auf Retain gesetzt.

• Wenn nicht angegeben, DeletionPolicy ist die StandardeinstellungRetain. AWS::Lambda::Version

• In dem Szenario, in dem dies für eine serverlose Funktion angegeben DeploymentPreferences ist, werden Ressourcenattribute nicht auf die folgenden generierten AWS CloudFormation Ressourcen kopiert:

  • AWS::CodeDeploy::Application

  • AWS::CodeDeploy::DeploymentGroup

  • Der AWS::IAM::Role NameCodeDeployServiceRole, der für dieses Szenario erstellt wurde

• Wenn Ihre AWS SAM Vorlage mehrere Funktionen mit implizit erstellten API-Ereignisquellen enthält, teilen sich die Funktionen die generierte AWS::ApiGateway::RestApi Ressource. Wenn die Funktionen in diesem Szenario unterschiedliche Ressourcenattribute haben, werden für die generierte AWS::ApiGateway::RestApi Ressource die Ressourcenattribute gemäß den folgenden priorisierten Listen AWS SAM kopiert:

  • UpdateReplacePolicy:

    1. Retain

    2. Snapshot

    3. Delete

  • DeletionPolicy:

    1. Retain

    2. Delete