Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# AWS SAM anatomia del modello
Un file AWS SAM modello segue da vicino il formato di un file CloudFormation modello, descritto in [Anatomia del modello](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html) nella Guida per l'*AWS CloudFormation utente*. Le differenze principali tra i file AWS SAM modello e i file CloudFormation modello sono le seguenti:
+ **Dichiarazione Transform.** La dichiarazione `Transform: AWS::Serverless-2016-10-31` è obbligatoria per i file AWS SAM modello. Questa dichiarazione identifica un file CloudFormation modello come file AWS SAM modello. Per ulteriori informazioni sulle trasformazioni, consulta [Transform nella Guida](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-section-structure.html) per l'*AWS CloudFormation utente*.
+ **Sezione Globals.** La `Globals` sezione è unica per. AWS SAM Definisce proprietà comuni a tutte le funzioni serverless e APIs. Tutte le`AWS::Serverless::Function`,`AWS::Serverless::Api`,`AWS::Serverless::CapacityProvider`, `AWS::Serverless::HttpApi``AWS::Serverless::SimpleTable`, e `AWS::Serverless::StateMachine` le risorse ereditano le proprietà definite nella `Globals` sezione. Per ulteriori informazioni su questa sezione, vedere[Sezione Globals del modello AWS SAM](sam-specification-template-anatomy-globals.md).
+ **Sezione Risorse.** Nei AWS SAM modelli la `Resources` sezione può contenere una combinazione di CloudFormation risorse e AWS SAM risorse. Per ulteriori informazioni sulle CloudFormation risorse, consultate il [riferimento ai tipi di AWS risorse e proprietà](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html) nella *Guida AWS CloudFormation per l'utente*. Per ulteriori informazioni sulle AWS SAM risorse, vedere[AWS SAM risorse e proprietà](sam-specification-resources-and-properties.md).
Tutte le altre sezioni di un file AWS SAM modello corrispondono alla sezione del file CloudFormation modello con lo stesso nome.
## YAML
Il seguente esempio mostra un frammento di modello in formato YAML.
```
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
```
## Sezioni del modello
AWS SAM i modelli possono includere diverse sezioni principali. Sono necessarie solo `Resources` le sezioni `Transform` e.
Puoi includere le sezioni del modello in qualsiasi ordine. Tuttavia, se si utilizzano estensioni linguistiche, è necessario aggiungerle `AWS::LanguageExtensions` *prima* della trasformazione serverless (ovvero prima`AWS::Serverless-2016-10-31`), come mostrato nell'esempio seguente:
```
Transform:
- AWS::LanguageExtensions
- AWS::Serverless-2016-10-31
```
Durante la creazione del modello, può essere utile utilizzare l'ordine logico mostrato nell'elenco seguente. Questo perché i valori di una sezione potrebbero fare riferimento a valori di una sezione precedente.
**[Trasforma (obbligatorio)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-section-structure.html)**
Per AWS SAM i modelli, è necessario includere questa sezione con un valore di`AWS::Serverless-2016-10-31`.
Le trasformazioni aggiuntive sono facoltative. Per ulteriori informazioni sulle trasformazioni, consulta [Transform nella Guida](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/transform-section-structure.html) per l'*AWS CloudFormation utente*.
**[Globali (opzionale)](sam-specification-template-anatomy-globals.md)**
Proprietà comuni a tutte le funzioni serverless e APIs tabelle semplici. Tutte le`AWS::Serverless::Function`,`AWS::Serverless::Api`,`AWS::Serverless::CapacityProvider`, `AWS::Serverless::HttpApi``AWS::Serverless::SimpleTable`, e `AWS::Serverless::StateMachine` le risorse ereditano le proprietà definite nella `Globals` sezione.
Questa sezione è esclusiva di. AWS SAM Non esiste una sezione corrispondente nei CloudFormation modelli.
**[Descrizione (facoltativa)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-description-structure.html)**
Stringa di testo che descrive il modello.
Questa sezione corrisponde direttamente alla `Description` sezione dei CloudFormation modelli.
**[Metadata (Metadati) (facoltativa)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/metadata-section-structure.html)**
Oggetti che forniscono informazioni aggiuntive sul modello.
Questa sezione corrisponde direttamente alla `Metadata` sezione dei CloudFormation modelli.
**[Parameters (Parametri) (facoltativa)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html)**
Valori da passare al modello in fase di runtime (quando crei o aggiorni uno stack). Puoi fare riferimento ai parametri dalle sezioni `Resources` e `Outputs` del modello. Gli oggetti dichiarati nella `Parameters` sezione fanno sì che il **sam deploy --guided** comando presenti all'utente istruzioni aggiuntive.
I valori passati utilizzando il `--parameter-overrides` parametro del `sam deploy` comando e le voci nel file di configurazione hanno la precedenza sulle voci del file modello. AWS SAM Per ulteriori informazioni sul comando, vedere nel riferimento ai `sam deploy` comandi. [sam deploy](sam-cli-command-reference-sam-deploy.md) AWS SAMCLI Per ulteriori informazioni sul file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).
**[Mappings (Mappature) (facoltativa)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/mappings-section-structure.html)**
Mappatura di chiavi e valori associati che puoi utilizzare per specificare i valori dei parametri condizionali, in modo analogo a una tabella di ricerca. È possibile abbinare una chiave a un valore corrispondente utilizzando la funzione [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)intrinseca nelle sezioni `Resources` and`Outputs`.
Questa sezione corrisponde direttamente alla `Mappings` sezione dei CloudFormation modelli.
**[Conditions (Condizioni) (facoltativa)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/conditions-section-structure.html)**
Condizioni che consentono di controllare se alcune risorse sono state creati o se a determinate proprietà di risorsa è stato assegnato un valore durante la creazione o l'aggiornamento dello stack. Ad esempio, puoi creare in modo condizionale una risorsa a seconda che lo stack sia destinato a un ambiente di test o di produzione.
Questa sezione corrisponde direttamente alla `Conditions` sezione dei CloudFormation modelli.
**[Resources (Risorse) (obbligatoria)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html)**
Le risorse dello stack e le relative proprietà, ad esempio un'istanza Amazon Elastic Compute Cloud (Amazon EC2) o un bucket Amazon Simple Storage Service (Amazon S3). Puoi fare riferimento alle risorse nelle sezioni `Resources` e `Outputs` del modello.
Questa sezione è simile alla sezione dei `Resources` modelli. CloudFormation Nei AWS SAM modelli, questa sezione può contenere AWS SAM risorse oltre alle CloudFormation risorse.
**[Outputs (Output) (facoltativa)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/outputs-section-structure.html)**
I valori che vengono restituiti ogni volta che si visualizzano le proprietà dello stack. Ad esempio, puoi dichiarare un output per il nome di un bucket S3 e quindi chiamare il comando `aws cloudformation describe-stacks` AWS Command Line Interface (AWS CLI) per visualizzare il nome.
Questa sezione corrisponde direttamente alla `Outputs` sezione dei modelli. CloudFormation
## Fasi successive
Per scaricare e distribuire un'applicazione serverless di esempio che contiene un file AWS SAM modello, consulta [Guida introduttiva con AWS SAM](serverless-getting-started.md) e segui le istruzioni riportate in. [Tutorial: Implementa un'applicazione Hello World con AWS SAM](serverless-getting-started-hello-world.md)