AWS::Serverless::Application

Bettet eine Serverless-Anwendung aus der AWS Serverless Application Repository oder aus einem Amazon S3-Bucket als verschachtelte Anwendung ein. Verschachtelte Anwendungen werden als verschachtelte AWS::CloudFormation::Stack Ressourcen bereitgestellt, die mehrere andere Ressourcen enthalten können, einschließlich anderer AWS::Serverless::Application Ressourcen.

Anmerkung

Wenn Sie in bereitstellenAWS CloudFormation, AWS SAMwandelt Ihre AWS SAM Ressourcen in -AWS CloudFormationRessourcen um. Weitere Informationen finden Sie unter Generierte AWS CloudFormation Ressourcen.

Syntax

Verwenden Sie die folgende Syntax, um diese Entität in Ihrer AWS Serverless Application Model (AWS SAM)-Vorlage zu deklarieren.

YAML

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

Eigenschaften

Location

Vorlagen-URL, Dateipfad oder Speicherortobjekt einer verschachtelten Anwendung.

Wenn eine Vorlagen-URL bereitgestellt wird, muss sie dem in der CloudFormation TemplateUrl Dokumentation angegebenen Format entsprechen und eine gültige - CloudFormation oder SAM-Vorlage enthalten. Ein ApplicationLocationObject kann verwendet werden, um eine Anwendung anzugeben, die im veröffentlicht wurdeAWS Serverless Application Repository.

Wenn ein lokaler Dateipfad bereitgestellt wird, muss die Vorlage den Workflow durchlaufen, der den sam package Befehl sam deploy oder enthält, damit die Anwendung ordnungsgemäß transformiert werden kann.

Typ : Zeichenfolge | ApplicationLocationObject

Erforderlich: Ja

AWS CloudFormation Kompatibilität: Diese Eigenschaft ähnelt der Eigenschaft einer -AWS::CloudFormation::StackRessource. TemplateURL Die - CloudFormation Version verwendet kein ApplicationLocationObject, um eine Anwendung aus dem abzurufenAWS Serverless Application Repository.

NotificationARNs

Eine Liste der vorhandenen Amazon SNS-Themen, an die Benachrichtigungen über Stack-Ereignisse gesendet werden.

Typ : Liste

Required: No

AWS CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die -NotificationARNsEigenschaft einer -AWS::CloudFormation::StackRessource übergeben.

Parameters

Anwendungsparameterwerte.

Typ : Map

Required: No

AWS CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die -ParametersEigenschaft einer -AWS::CloudFormation::StackRessource übergeben.

Tags

Eine Zuordnung (Zeichenfolge zu Zeichenfolge), die die Tags angibt, die dieser Anwendung hinzugefügt werden sollen. Schlüssel und Werte sind auf alphanumerische Zeichen beschränkt. Schlüssel können 1 bis 127 Unicode-Zeichen lang sein und dürfen nicht mit aws vorangestellt werden: Werte können zwischen 1 und 255 Unicode-Zeichen lang sein.

Typ : Map

Required: No

AWS CloudFormation Kompatibilität: Diese Eigenschaft ähnelt der Tags Eigenschaft einer -AWS::CloudFormation::StackRessource. Die Tags-Eigenschaft in SAM besteht aus Schlüssel:Wert-Paaren; darin besteht CloudFormation sie aus einer Liste von Tag-Objekten. Wenn der Stack erstellt wird, fügt SAM dieser Anwendung automatisch ein lambda:createdBy:SAM Tag hinzu. Wenn diese Anwendung aus der stammtAWS Serverless Application Repository, dann wird SAM auch automatisch die beiden zusätzlichen Tags serverlessrepo:applicationId:ApplicationId und verwendenserverlessrepo:semanticVersion:SemanticVersion.

TimeoutInMinutes

Der Zeitraum in Minuten, den AWS CloudFormation darauf wartet, dass der verschachtelte Stack den Status CREATE_COMPLETE erreicht. Standardmäßig gibt es keine Zeitüberschreitung. Wenn AWS CloudFormation feststellt, dass der verschachtelte Stack den Status CREATE_COMPLETE erreicht hat, wird die verschachtelte Stack-Ressource im übergeordneten Stack als CREATE_COMPLETE markiert und das Erstellen des übergeordneten Stacks wird fortgesetzt. Wenn die Zeitüberschreitung abläuft, bevor der verschachtelte Stack CREATE_COMPLETE erreicht, markiert AWS CloudFormation den verschachtelten Stack als fehlgeschlagen und setzt sowohl den verschachtelten Stack als auch den übergeordneten Stack zurück.

Typ: Ganzzahl

Required: No

AWS CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die -TimeoutInMinutesEigenschaft einer -AWS::CloudFormation::StackRessource übergeben.

Rückgabewerte

Punkt

Wenn die logische ID dieser Ressource der Ref intrinsischen -Funktion bereitgestellt wird, gibt sie den Ressourcennamen der zugrunde liegenden AWS::CloudFormation::Stack Ressource zurück.

Weitere Informationen zur Verwendung der Ref Funktion finden Sie unter Ref im AWS CloudFormation -Benutzerhandbuch.

Fn::GetAtt

Fn::GetAtt gibt einen Wert für ein angegebenes Attribut dieses Typs zurück. Im Folgenden sehen Sie die verfügbaren Attribute und Beispielrückgabewerte.

Weitere Informationen zur Verwendung von finden Sie Fn::GetAttunter Fn::GetAtt im AWS CloudFormation -Benutzerhandbuch.

Outputs.ApplicationOutputName

Der Wert der Stack-Ausgabe mit dem Namen ApplicationOutputName.

Beispiele

SAR-Anwendung

Anwendung, die eine Vorlage aus dem Serverless Application Repository verwendet

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

Normale Anwendung

Anwendung von einer S3-URL

YAML

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