AWS::Serverless::Application

Incorpora un'applicazione serverless da AWS Serverless Application Repositoryo da un bucket Amazon S3 come applicazione annidata. Le applicazioni annidate vengono distribuite come risorse annidate, che possono contenere molte altre AWS::CloudFormation::Stackrisorse, incluse altre risorse. AWS::Serverless::Application

Nota

Quando esegui la distribuzione su AWS CloudFormation, AWS SAM trasforma le tue risorse in risorse. AWS SAM AWS CloudFormation Per ulteriori informazioni, consulta AWS CloudFormation Risorse generate.

Sintassi

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

YAML

Type: AWS::Serverless::Application
Properties:
  Location: String | ApplicationLocationObject
  NotificationARNs: List
  Parameters: Map
  Tags: Map
  TimeoutInMinutes: Integer

Proprietà

Location

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 e contenere un modello SAM CloudFormation o valido. An ApplicationLocationObject può essere utilizzato per specificare un'applicazione che è stata pubblicata su AWS Serverless Application Repository.

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 | ApplicationLocationObject

Campo obbligatorio: sì

AWS CloudFormation compatibilità: Questa proprietà è simile alla TemplateURL proprietà di una AWS::CloudFormation::Stack risorsa. La CloudFormation versione non richiede un ApplicationLocationObject per recuperare un'applicazione da. AWS Serverless Application Repository

NotificationARNs

Un elenco di argomenti Amazon SNS esistenti a cui vengono inviate le notifiche sugli eventi dello stack.

Tipo: Elenco

Required: No

AWS CloudFormation compatibilità: questa proprietà viene passata direttamente alla NotificationARNs proprietà di una AWS::CloudFormation::Stack risorsa.

Parameters

Valori dei parametri dell'applicazione.

Tipo: Mappa

Required: No

AWS CloudFormation compatibilità: questa proprietà viene passata direttamente alla Parameters proprietà di una AWS::CloudFormation::Stack risorsa.

Tags

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

Required: No

AWS CloudFormation compatibilità: questa proprietà è simile alla 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 eserverlessrepo:semanticVersion:SemanticVersion.

TimeoutInMinutes

Periodo di tempo, in minuti, che AWS CloudFormation attende che lo stack annidato raggiunga lo stato. CREATE_COMPLETE Il valore predefinito non prevede alcun timeout. Quando AWS 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 nidificatoCREATE_COMPLETE, AWS CloudFormation contrassegna lo stack nidificato come fallito e ripristina sia lo stack nidificato che lo stack principale.

Tipo: integer

Required: No

AWS CloudFormation compatibilità: questa proprietà viene passata direttamente alla proprietà di una risorsa. TimeoutInMinutes AWS::CloudFormation::Stack

Valori restituiti

Ref

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

Per ulteriori informazioni sull'uso della Ref funzione, consulta Refla Guida per l'AWS CloudFormation utente.

Fn: GetAtt

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'utilizzoFn::GetAtt, consulta Fn::GetAttla Guida per l'AWS CloudFormation utente.

Outputs.ApplicationOutputName

Il valore dello stack in uscita con il nomeApplicationOutputName.

Esempi

Applicazione SAR

Applicazione che utilizza un modello dal Serverless Application Repository

YAML

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

Applicazione da un URL S3

YAML

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