AWS::Serverless::Application

Incorpora un'applicazione serverless daAWS Serverless Application Repositoryo da un bucket Amazon S3 come applicazione nidificata. Le applicazioni nidificate vengono distribuite come nidificateAWS::CloudFormation::Stackrisorse, che possono contenere più altre risorse, tra cui altreAWS::Serverless::Applicationrisorse AWS.

Sintassi

Per dichiarare questa entità nel tuoAWS Serverless Application Model(AWS SAM) template, utilizzare la sintassi seguente.

YAML

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

Proprietà

Location

URL modello, percorso file o oggetto posizione di un'applicazione nidificata.

Se viene fornito un URL del modello, deve seguire il formato specificato nellaDocumentazione CloudFormation TemplateUrle contengono un modello CloudFormation o SAM valido. Un recordApplicationLocationObjectpuò essere utilizzato per specificare un'applicazione che è stata pubblicata nellaAWS Serverless Application Repository.

Se viene fornito un percorso di file locale, il modello deve passare attraverso il flusso di lavoro che includesam deployosam packagecomando, affinché l'applicazione venga trasformata correttamente.

Type: Stringa |Oggetto ApplicationLocation

Campo obbligatorio: Sì

AWS CloudFormationcompatibilità: Questa proprietà è simile alTemplateURLproprietà di unAWS::CloudFormation::Stackrisorsa. La versione CloudFormation non richiedeApplicationLocationObjectper recuperare un'applicazione dalAWS Serverless Application Repository.

NotificationARNs

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

Type: Elenco

Campo obbligatorio: No

AWS CloudFormationcompatibilità: Questa proprietà viene passata direttamente alNotificationARNsproprietà di unAWS::CloudFormation::Stackrisorsa.

Parameters

Valori dei parametri dell'applicazione.

Type: Eseguire la mappatura

Campo obbligatorio: No

AWS CloudFormationcompatibilità: Questa proprietà viene passata direttamente alParametersproprietà di unAWS::CloudFormation::Stackrisorsa.

Tags

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 il prefisso aws:. I valori possono contenere da 1 a 255 caratteri Unicode.

Type: Eseguire la mappatura

Campo obbligatorio: No

AWS CloudFormationcompatibilità: Questa proprietà è simile alTagsproprietà di unAWS::CloudFormation::Stackrisorsa. La proprietà Tags in SAM è costituita da coppie Key:Value; in CloudFormation è costituita da un elenco di oggetti Tag. Quando viene creato lo stack, SAM aggiungerà automaticamente unlambda:createdBy:SAMtag a questa applicazione. Inoltre, se questa applicazione proviene dalAWS Serverless Application Repository, quindi SAM eseguirà automaticamente anche i due tag aggiuntiviserverlessrepo:applicationId:ApplicationIdeserverlessrepo:semanticVersion:SemanticVersion.

TimeoutInMinutes

L'intervallo di tempo, espresso in minuti, durante il quale AWS CloudFormation attende che lo stack nidificato raggiunga lo stato CREATE_COMPLETE. Il valore predefinito non prevede alcun timeout. Quando AWS CloudFormation rileva il raggiungimento dello stato CREATE_COMPLETE da parte dello stack nidificato, contrassegna la risorsa dello stack nidificato come CREATE_COMPLETE nello stack padre e riprende la creazione di quest'ultimo. Se il periodo di timeout scade prima che lo stack nidificato raggiunga lo stato CREATE_COMPLETE, AWS CloudFormation indica che la procedura non è andata a buon fine ed esegue il rollback dello stack nidificato e dello stack padre.

Type: Numero intero

Campo obbligatorio: No

AWS CloudFormationcompatibilità: Questa proprietà viene passata direttamente alTimeoutInMinutesproprietà di unAWS::CloudFormation::Stackrisorsa.

Valori restituiti

Ref

Quando l'ID logico di questa risorsa viene fornito alReffunzione intrinseca, restituisce il nome della risorsa del sottostanteAWS::CloudFormation::Stackrisorsa.

Per ulteriori informazioni sull'utilizzo delRefconsulta la funzioneRefnellaAWS CloudFormationGuida per l’utente di.

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'utilizzo diFn::GetAtt, consultaFn::GetAttnellaAWS CloudFormationGuida per l’utente di.

Outputs.ApplicationOutputName

Il valore dell'output dello stack con 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

Normal Application

Applicazione da un URL S3

YAML

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