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

Bettet eine serverlose Anwendung aus dem [AWS Serverless Application Repository](https://serverlessrepo.aws.amazon.com/applications)oder aus einem Amazon S3 S3-Bucket als verschachtelte Anwendung ein. Verschachtelte Anwendungen werden als verschachtelte [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)Ressourcen bereitgestellt, die mehrere andere Ressourcen, einschließlich anderer Ressourcen, enthalten können. [AWS::Serverless::Application](#sam-resource-application)

**Anmerkung**  
Bei der Bereitstellung auf werden AWS CloudFormation Ihre AWS SAM Ressourcen in AWS SAM Ressourcen umgewandelt. CloudFormation Weitere Informationen finden Sie unter [Generierte CloudFormation Ressourcen für AWS SAM](sam-specification-generated-resources.md).

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

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

### 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
```

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

 `Location`   <a name="sam-application-location"></a>
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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-templateurl) und eine gültige CloudFormation SAM-Vorlage enthalten. An [ApplicationLocationObject](sam-property-application-applicationlocationobject.md) kann verwendet werden, um eine Anwendung anzugeben, die auf der veröffentlicht wurde [AWS Serverless Application Repository](https://docs.aws.amazon.com/serverlessrepo/latest/devguide/what-is-serverlessrepo.html).  
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 \$1 [ApplicationLocationObject](sam-property-application-applicationlocationobject.md)  
*Erforderlich*: Ja  
*CloudFormation Kompatibilität*: Diese Eigenschaft ähnelt der `[TemplateURL](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-templateurl)` Eigenschaft einer `AWS::CloudFormation::Stack` Ressource. Die CloudFormation Version benötigt keine Zeit[ApplicationLocationObject](sam-property-application-applicationlocationobject.md), um eine Anwendung von der abzurufen AWS Serverless Application Repository.

 `NotificationARNs`   <a name="sam-application-notificationarns"></a>
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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-notificationarns)` Eigenschaft einer `AWS::CloudFormation::Stack` Ressource übergeben.

 `Parameters`   <a name="sam-application-parameters"></a>
Werte der Anwendungsparameter.  
*Typ*: Karte  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[Parameters](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-parameters)` Eigenschaft einer `AWS::CloudFormation::Stack` Ressource übergeben.

 `Tags`   <a name="sam-application-tags"></a>
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 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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-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` und`serverlessrepo:semanticVersion:SemanticVersion`.

 `TimeoutInMinutes`   <a name="sam-application-timeoutinminutes"></a>
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 erreicht`CREATE_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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-timeoutinminutes)` Eigenschaft einer Ressource übergeben. `AWS::CloudFormation::Stack`

## Rückgabewerte
<a name="sam-resource-application-return-values"></a>

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

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 [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)im *AWS CloudFormation Benutzerhandbuch*. 

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

`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 [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)im *AWS CloudFormation Benutzerhandbuch*. 

`Outputs.ApplicationOutputName`  <a name="Outputs.ApplicationOutputName-fn::getatt"></a>
Der Wert der Stack-Ausgabe mit dem Namen`ApplicationOutputName`.

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

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

Anwendung, die eine Vorlage aus dem Serverless Application Repository verwendet

#### 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
```

### Normale Anwendung
<a name="sam-resource-application--examples--normal-application"></a>

Anwendung von einer S3-URL

#### 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
```

# ApplicationLocationObject
<a name="sam-property-application-applicationlocationobject"></a>

Eine Anwendung, die auf dem veröffentlicht wurde [AWS Serverless Application Repository](https://docs.aws.amazon.com/serverlessrepo/latest/devguide/what-is-serverlessrepo.html).

## Syntax
<a name="sam-property-application-applicationlocationobject-syntax"></a>

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

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

```
  [ApplicationId](#sam-application-applicationlocationobject-applicationid): String
  [SemanticVersion](#sam-application-applicationlocationobject-semanticversion): String
```

## Eigenschaften
<a name="sam-property-application-applicationlocationobject-properties"></a>

 `ApplicationId`   <a name="sam-application-applicationlocationobject-applicationid"></a>
Der Amazon-Ressourcenname (ARN) der Anwendung.  
*Typ:* Zeichenfolge  
*Erforderlich*: Ja  
*CloudFormation Kompatibilität*: Diese Eigenschaft ist einzigartig für AWS SAM und hat kein CloudFormation Äquivalent.

 `SemanticVersion`   <a name="sam-application-applicationlocationobject-semanticversion"></a>
Die semantische Version der Anwendung.  
*Typ:* Zeichenfolge  
*Erforderlich*: Ja  
*CloudFormation Kompatibilität*: Diese Eigenschaft ist einzigartig für AWS SAM und hat kein CloudFormation Äquivalent.

## Beispiele
<a name="sam-property-application-applicationlocationobject--examples"></a>

### meine Anwendung
<a name="sam-property-application-applicationlocationobject--examples--my-application"></a>

Beispiel für ein Objekt für den Speicherort einer Anwendung

#### YAML
<a name="sam-property-application-applicationlocationobject--examples--my-application--yaml"></a>

```
Location:
  ApplicationId: 'arn:aws:serverlessrepo:us-east-1:012345678901:applications/my-application'
  SemanticVersion: 1.0.0
```