

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.

# AWS SAM Anatomie der Vorlage
<a name="sam-specification-template-anatomy"></a>

Eine AWS SAM Vorlagendatei folgt weitgehend dem Format einer CloudFormation Vorlagendatei, das im *AWS CloudFormation Benutzerhandbuch* unter [Anatomie der Vorlage](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html) beschrieben wird. Die Hauptunterschiede zwischen AWS SAM Vorlagendateien und CloudFormation Vorlagendateien sind die folgenden:
+ **Deklaration transformieren.** Die Deklaration `Transform: AWS::Serverless-2016-10-31` ist für AWS SAM Vorlagendateien erforderlich. Diese Deklaration identifiziert eine CloudFormation Vorlagendatei als AWS SAM Vorlagendatei. Weitere Informationen zu Transformationen finden Sie unter [Transform](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-section-structure.html) im *AWS CloudFormation Benutzerhandbuch*.
+ **Abschnitt „Globals“.** Der `Globals` Abschnitt ist einzigartig für AWS SAM. Er definiert Eigenschaften, die allen Ihren serverlosen Funktionen gemeinsam sind, und APIs. Alle `AWS::Serverless::StateMachine` Ressourcen`AWS::Serverless::Function`,`AWS::Serverless::Api`,`AWS::Serverless::CapacityProvider`, `AWS::Serverless::HttpApi``AWS::Serverless::SimpleTable`, und erben die Eigenschaften, die `Globals` im Abschnitt definiert sind. Weitere Informationen zu diesem Abschnitt finden Sie unter[Abschnitt „Globals“ der Vorlage AWS SAM](sam-specification-template-anatomy-globals.md).
+ **Abschnitt „Ressourcen“.** In AWS SAM Vorlagen kann der `Resources` Abschnitt eine Kombination aus CloudFormation Ressourcen und AWS SAM Ressourcen enthalten. Weitere Informationen zu CloudFormation Ressourcen finden Sie in der [Referenz zu AWS Ressourcen- und Eigenschaftstypen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html) im *AWS CloudFormation Benutzerhandbuch*. Weitere Informationen zu AWS SAM Ressourcen finden Sie unter[AWS SAM Ressourcen und Immobilien](sam-specification-resources-and-properties.md).

Alle anderen Abschnitte einer AWS SAM Vorlagendatei entsprechen dem gleichnamigen Abschnitt der CloudFormation Vorlagendatei.

## YAML
<a name="template-anatomy-outline.yaml"></a>

Das folgende Beispiel zeigt ein in YAML formatiertes Vorlagenfragment.

```
Transform: AWS::Serverless-2016-10-31

Globals:
  set of globals

Description:
  String

Metadata:
  template metadata

Parameters:
  set of parameters

Mappings:
  set of mappings

Conditions:
  set of conditions

Resources:
  set of resources

Outputs:
  set of outputs
```

## Abschnitte einer Vorlage
<a name="template-anatomy-sections"></a>

AWS SAM Vorlagen können mehrere Hauptabschnitte enthalten. Nur die `Resources` Abschnitte `Transform` und sind erforderlich.

Sie können die Vorlagenabschnitte in beliebiger Reihenfolge einfügen. Wenn Sie jedoch Spracherweiterungen verwenden, sollten Sie `AWS::LanguageExtensions` *sie vor* der serverlosen Transformation (also vor`AWS::Serverless-2016-10-31`) hinzufügen, wie im folgenden Beispiel gezeigt:

```
Transform:
  - AWS::LanguageExtensions
  - AWS::Serverless-2016-10-31
```

Beim Erstellen Ihrer Vorlage kann es hilfreich sein, die logische Reihenfolge zu verwenden, die in der folgenden Liste aufgeführt ist. Das liegt daran, dass sich die Werte in einem Abschnitt möglicherweise auf Werte aus einem vorherigen Abschnitt beziehen.

**[Transformieren (erforderlich)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-section-structure.html)**  
Bei AWS SAM Vorlagen müssen Sie diesen Abschnitt mit einem Wert von einschließen`AWS::Serverless-2016-10-31`.  
Zusätzliche Transformationen sind optional. Weitere Informationen zu Transformationen finden Sie unter [Transform](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-section-structure.html) im *AWS CloudFormation Benutzerhandbuch*.

**[Globale Werte (optional)](sam-specification-template-anatomy-globals.md)**  
Eigenschaften, die all Ihren serverlosen Funktionen und einfachen Tabellen APIs gemeinsam sind. Alle `AWS::Serverless::StateMachine` Ressourcen`AWS::Serverless::Function`,`AWS::Serverless::Api`, `AWS::Serverless::CapacityProvider` `AWS::Serverless::HttpApi``AWS::Serverless::SimpleTable`, und erben die Eigenschaften, die `Globals` im Abschnitt definiert sind.  
Dieser Abschnitt ist einzigartig für AWS SAM. In CloudFormation Vorlagen gibt es keinen entsprechenden Abschnitt.

**[Description (optional)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-description-structure.html)**  
Gibt eine Textzeichenfolge als Beschreibung der Vorlage an.  
Dieser Abschnitt entspricht direkt dem `Description` Abschnitt CloudFormation Vorlagen.

**[Metadata (optional)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/metadata-section-structure.html)**  
Gibt Objekte an, die zusätzliche Informationen über die Vorlage liefern.  
Dieser Abschnitt entspricht direkt dem `Metadata` Abschnitt der CloudFormation Vorlagen.

**[Parameters (optional)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html)**  
Werte, die zur Laufzeit an die Vorlage übergeben werden sollen (also bei der Erstellung oder Aktualisierung eines Stacks). Hier können Sie Parameter aus den Vorlagenabschnitten `Resources` und `Outputs` referenzieren. Objekte, die in diesem `Parameters` Abschnitt deklariert sind, veranlassen den **sam deploy --guided** Befehl, dem Benutzer zusätzliche Eingabeaufforderungen anzuzeigen.  
Werte, die mithilfe des `--parameter-overrides` `sam deploy` Befehlsparameters übergeben werden, und Einträge in der Konfigurationsdatei haben Vorrang vor Einträgen in der Vorlagendatei. AWS SAM Weitere Informationen zu dem `sam deploy` Befehl finden Sie [sam deploy](sam-cli-command-reference-sam-deploy.md) in der Befehlsreferenz. AWS SAMCLI Weitere Informationen zur Konfigurationsdatei finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

**[Mappings (optional)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/mappings-section-structure.html)**  
Eine Sammlung von Zuweisungen ähnlich einer Lookup-Tabelle, die Schlüssel und die ihnen zugeordneten Werte enthält. Mit ihrer Hilfe lassen sich Werte für bedingte Parameter festlegen. Sie können einen Schlüssel einem entsprechenden Wert zuordnen, indem Sie die [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-findinmap.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-findinmap.html)systeminterne Funktion in den Abschnitten `Resources` und `Outputs` verwenden.  
Dieser Abschnitt entspricht direkt dem `Mappings` Abschnitt mit den Vorlagen. CloudFormation 

**[Conditions (optional)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/conditions-section-structure.html)**  
Bedingungen, die steuern, ob während der Erstellung oder Aktualisierung eines Stacks bestimmte Ressourcen erstellt werden oder ein Wert für bestimmte Ressourceneigenschaften festgelegt wird. Beispielsweise könnten Sie über Bedingungen festlegen, wie eine Ressource erstellt wird, wenn der Stack für eine Produktionsumgebung gedacht ist, und wie sie erstellt wird, wenn der Stack für eine Testumgebung gedacht ist.  
Dieser Abschnitt entspricht direkt dem `Conditions` Abschnitt der CloudFormation Vorlagen.

**[Resources (erforderlich)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html)**  
Die Stack-Ressourcen und ihre Eigenschaften, z. B. eine Amazon Elastic Compute Cloud (Amazon EC2) -Instance oder ein Amazon Simple Storage Service (Amazon S3) -Bucket. Hier können Sie Ressourcen aus den Vorlagenabschnitten `Resources` und `Outputs` referenzieren.  
Dieser Abschnitt ähnelt dem `Resources` Abschnitt mit CloudFormation Vorlagen. In AWS SAM Vorlagen kann dieser Abschnitt zusätzlich zu AWS SAM Ressourcen CloudFormation Ressourcen enthalten.

**[Outputs (optional)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/outputs-section-structure.html)**  
Die Werte, die zurückgegeben werden, wenn Sie sich die Eigenschaften Ihres Stacks ansehen. Sie können beispielsweise eine Ausgabe für einen S3-Bucket-Namen deklarieren und dann den Befehl `aws cloudformation describe-stacks` AWS Command Line Interface (AWS CLI) aufrufen, um den Namen anzuzeigen.  
Dieser Abschnitt entspricht direkt dem `Outputs` Abschnitt der CloudFormation Vorlagen.

## Nächste Schritte
<a name="template-anatomy-next-steps"></a>

Informationen zum Herunterladen und Bereitstellen einer serverlosen Beispielanwendung, die eine AWS SAM Vorlagendatei enthält, finden [Erste Schritte mit AWS SAM](serverless-getting-started.md) Sie in [Tutorial: Stellen Sie eine Hello World-Anwendung bereit mit AWS SAM](serverless-getting-started-hello-world.md) den Anweisungen unter.