AWS::Serverless::Application - AWS Serverless Application Model
SyntaxEigenschaftenRückgabewerteBeispiele

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

AWS::Serverless::Application

Bettet eine serverlose Anwendung aus dem AWS Serverless Application Repositoryoder aus einem Amazon S3 S3-Bucket als verschachtelte Anwendung ein. Verschachtelte Anwendungen werden verschachtelt bereitgestellt AWS::CloudFormation::StackRessourcen, die mehrere andere Ressourcen, einschließlich anderer AWS::Serverless::Application Ressourcen, enthalten können.

Anmerkung

Bei der Bereitstellung von AWS CloudFormation werden Ihre AWS SAM Ressourcen in AWS SAM CloudFormation Ressourcen umgewandelt. Weitere Informationen finden Sie unter Generierte CloudFormation Ressourcen für AWS SAM.

Syntax

Verwenden Sie die folgende Syntax, um diese Entität in Ihrer Vorlage AWS Serverless Application Model (AWS SAM) 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 Standortobjekt 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 SAM-Vorlage enthalten. An ApplicationLocationObject kann verwendet werden, um eine Anwendung anzugeben, die auf der veröffentlicht wurde AWS Serverless Application Repository.

Wenn ein lokaler Dateipfad angegeben 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

CloudFormation Kompatibilität: Diese Eigenschaft ähnelt der TemplateURL Eigenschaft einer AWS::CloudFormation::Stack Ressource. Die CloudFormation Version benötigt keine ZeitApplicationLocationObject, um eine Anwendung von der abzurufen AWS Serverless Application Repository.

NotificationARNs

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

Typ: Liste

Required: No

CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die NotificationARNs Eigenschaft einer AWS::CloudFormation::Stack Ressource übergeben.

Parameters

Werte der Anwendungsparameter.

Typ: Karte

Required: No

CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die Parameters Eigenschaft einer AWS::CloudFormation::Stack Ressource übergeben.

Tags

Eine Zuordnung (von Zeichenfolge zu Zeichenfolge), die die Tags angibt, die zu 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 ihnen darf nicht das Präfix aws: vorangestellt werden. Werte können 1 bis 255 Unicode-Zeichen lang sein.

Typ: Karte

Required: No

CloudFormation Kompatibilität: Diese Eigenschaft ähnelt der Tags Eigenschaft einer AWS::CloudFormation::Stack Ressource. Die Tags-Eigenschaft in SAM besteht aus Key:Value-Paaren; darin besteht CloudFormation sie aus einer Liste von Tag-Objekten. Wenn der Stack erstellt ist, fügt SAM dieser Anwendung automatisch ein lambda:createdBy:SAM Tag hinzu. Wenn diese Anwendung aus dem stammt AWS Serverless Application Repository, dann wird SAM außerdem automatisch die beiden zusätzlichen Tags serverlessrepo:applicationId:ApplicationId undserverlessrepo:semanticVersion:SemanticVersion.

TimeoutInMinutes

Die Zeitspanne in Minuten, die darauf CloudFormation wartet, dass der verschachtelte Stapel den CREATE_COMPLETE Status erreicht. Standardmäßig gibt es keine Zeitüberschreitung. Wenn CloudFormation erkannt wird, dass der verschachtelte Stapel den CREATE_COMPLETE Status erreicht hat, markiert es die Ressource des verschachtelten Stacks als CREATE_COMPLETE im übergeordneten Stapel und setzt die Erstellung des übergeordneten Stacks fort. Wenn der Timeout-Zeitraum abläuft, bevor der verschachtelte Stack den Wert erreichtCREATE_COMPLETE, wird der verschachtelte Stack als ausgefallen CloudFormation markiert und sowohl der verschachtelte Stack als auch der übergeordnete Stack zurückgesetzt.

Typ: Ganzzahl

Required: No

CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die TimeoutInMinutes Eigenschaft einer Ressource übergeben. AWS::CloudFormation::Stack

Rückgabewerte

Punkt

Wenn die logische ID dieser Ressource der Ref systemeigenen Funktion zur Verfügung gestellt wird, gibt sie den Ressourcennamen der zugrunde liegenden AWS::CloudFormation::Stack Ressource zurück.

Weitere Informationen zur Verwendung der Ref Funktion finden Sie Refim 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 Fn::GetAtt finden Sie Fn::GetAttim AWS CloudFormation Benutzerhandbuch.

Outputs.ApplicationOutputName

Der Wert der Stack-Ausgabe mit dem NamenApplicationOutputName.

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/sam-s3-demo-bucket/template.yaml