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::Serverless::Application
<a name="sam-resource-application"></a>

Incorpora un'applicazione serverless da [AWS Serverless Application Repository](https://serverlessrepo.aws.amazon.com/applications)o da un bucket Amazon S3 come applicazione annidata. Le applicazioni annidate vengono distribuite come risorse annidate, che possono contenere molte altre [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-stack.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-stack.html)risorse, incluse altre risorse. [AWS::Serverless::Application](#sam-resource-application)

**Nota**  
Quando esegui la distribuzione su AWS CloudFormation, AWS SAM trasforma le tue risorse in risorse. AWS SAM CloudFormation Per ulteriori informazioni, consulta [CloudFormation Risorse generate per AWS SAM](sam-specification-generated-resources.md).

## Sintassi
<a name="sam-resource-application-syntax"></a>

Per dichiarare questa entità nel tuo modello AWS Serverless Application Model (AWS SAM), usa la seguente sintassi.

### YAML
<a name="sam-resource-application-syntax.yaml"></a>

```
Type: AWS::Serverless::Application
Properties:
  [Location](#sam-application-location): String | ApplicationLocationObject
  [NotificationARNs](#sam-application-notificationarns): List
  [Parameters](#sam-application-parameters): Map
  [Tags](#sam-application-tags): Map
  [TimeoutInMinutes](#sam-application-timeoutinminutes): Integer
```

## Properties
<a name="sam-resource-application-properties"></a>

 `Location`   <a name="sam-application-location"></a>
URL del modello, percorso del file o oggetto di posizione di un'applicazione annidata.  
Se viene fornito un URL del modello, deve seguire il formato specificato nella [CloudFormation TemplateUrl documentazione](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-templateurl) e contenere un modello SAM CloudFormation o valido. An [ApplicationLocationObject](sam-property-application-applicationlocationobject.md) può essere utilizzato per specificare un'applicazione che è stata pubblicata su [AWS Serverless Application Repository](https://docs.aws.amazon.com/serverlessrepo/latest/devguide/what-is-serverlessrepo.html).  
Se viene fornito un percorso di file locale, il modello deve passare attraverso il flusso di lavoro che include il `sam package` comando `sam deploy` or, affinché l'applicazione venga trasformata correttamente.  
*Tipo*: String \$1 [ApplicationLocationObject](sam-property-application-applicationlocationobject.md)  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: Questa proprietà è simile alla `[TemplateURL](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-templateurl)` proprietà di una `AWS::CloudFormation::Stack` risorsa. La CloudFormation versione non richiede un [ApplicationLocationObject](sam-property-application-applicationlocationobject.md) per recuperare un'applicazione da. AWS Serverless Application Repository

 `NotificationARNs`   <a name="sam-application-notificationarns"></a>
Un elenco di argomenti Amazon SNS esistenti a cui vengono inviate le notifiche sugli eventi dello stack.  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[NotificationARNs](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-notificationarns)` proprietà di una `AWS::CloudFormation::Stack` risorsa.

 `Parameters`   <a name="sam-application-parameters"></a>
Valori dei parametri dell'applicazione.  
*Tipo*: Mappa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Parameters](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-parameters)` proprietà di una `AWS::CloudFormation::Stack` risorsa.

 `Tags`   <a name="sam-application-tags"></a>
Una mappa (da stringa a stringa) che specifica i tag da aggiungere a questa applicazione. Le chiavi e i valori sono limitati ai caratteri alfanumerici. Le chiavi possono contenere da 1 a 127 caratteri Unicode e non possono avere come prefisso aws:. I valori possono avere una lunghezza compresa tra 1 e 255 caratteri Unicode.  
*Tipo*: Mappa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è simile alla `[Tags](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-tags)` proprietà di una `AWS::CloudFormation::Stack` risorsa. La proprietà Tags in SAM è costituita da coppie Key:Value; in CloudFormation essa è costituita da un elenco di oggetti Tag. Quando lo stack viene creato, SAM aggiungerà automaticamente un `lambda:createdBy:SAM` tag a questa applicazione. Inoltre, se questa applicazione proviene da AWS Serverless Application Repository, SAM invierà automaticamente anche i due tag aggiuntivi `serverlessrepo:applicationId:ApplicationId` e`serverlessrepo:semanticVersion:SemanticVersion`.

 `TimeoutInMinutes`   <a name="sam-application-timeoutinminutes"></a>
Periodo di tempo, in minuti, che CloudFormation attende che lo stack annidato raggiunga lo stato. `CREATE_COMPLETE` Il valore predefinito non prevede alcun timeout. Quando CloudFormation rileva che lo stack nidificato ha raggiunto `CREATE_COMPLETE` lo stato, contrassegna la risorsa dello stack nidificato come nello stack principale e riprende `CREATE_COMPLETE` a creare lo stack principale. Se il periodo di timeout scade prima del raggiungimento dello stack nidificato`CREATE_COMPLETE`, CloudFormation contrassegna lo stack nidificato come fallito e ripristina sia lo stack nidificato che lo stack principale.  
*Tipo*: integer  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla proprietà di una risorsa. `[TimeoutInMinutes](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-timeoutinminutes)` `AWS::CloudFormation::Stack`

## Valori restituiti
<a name="sam-resource-application-return-values"></a>

### Ref
<a name="sam-resource-application-return-values-ref"></a>

Quando l'ID logico di questa risorsa viene fornito alla funzione `Ref` intrinseca, restituisce il nome della risorsa sottostante`AWS::CloudFormation::Stack`.

Per ulteriori informazioni sull'uso della `Ref` funzione, consulta [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html)la Guida per l'*AWS CloudFormation utente*. 

### Fn: GetAtt
<a name="sam-resource-application-return-values-fn--getatt"></a>

`Fn::GetAtt` restituisce un valore per un attributo specificato di questo tipo. Di seguito sono riportati gli attributi disponibili e i valori restituiti di esempio. 

Per ulteriori informazioni sull'utilizzo`Fn::GetAtt`, consulta [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html)la *Guida per l'AWS CloudFormation utente*. 

`Outputs.ApplicationOutputName`  <a name="Outputs.ApplicationOutputName-fn::getatt"></a>
Il valore dello stack in uscita con il nome`ApplicationOutputName`.

## Esempi
<a name="sam-resource-application--examples"></a>

### Applicazione SAR
<a name="sam-resource-application--examples--sar-application"></a>

Applicazione che utilizza un modello dal Serverless Application Repository

#### YAML
<a name="sam-resource-application--examples--sar-application--yaml"></a>

```
Type: AWS::Serverless::Application
Properties:
  Location:
    ApplicationId: 'arn:aws:serverlessrepo:us-east-1:012345678901:applications/my-application'
    SemanticVersion: 1.0.0
  Parameters:
    StringParameter: parameter-value
    IntegerParameter: 2
```

### Applicazione normale
<a name="sam-resource-application--examples--normal-application"></a>

Applicazione da un URL S3

#### YAML
<a name="sam-resource-application--examples--normal-application--yaml"></a>

```
Type: AWS::Serverless::Application
Properties:
  Location: https://s3.amazonaws.com/sam-s3-demo-bucket/template.yaml
```