

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.

# CloudFormation Ressourcen, die generiert werdenAWS::Serverless::Function, wenn angegeben
<a name="sam-specification-generated-resources-function"></a>

Wenn an angegeben `AWS::Serverless::Function` ist, erstellt AWS Serverless Application Model (AWS SAM) immer eine `AWS::Lambda::Function` CloudFormation Basisressource.

**`AWS::Lambda::Function`**  
*`LogicalId`: *`<function‑LogicalId>`  
*Referenzierbare Eigenschaft:* N/A (Sie müssen den verwenden, um auf diese `LogicalId` Ressource zu verweisen CloudFormation )

Zusätzlich zu dieser CloudFormation Ressource werden, wenn `AWS::Serverless::Function` angegeben, AWS SAM auch CloudFormation Ressourcen für die folgenden Szenarien generiert.

**Topics**
+ [

## Eigenschaften der Kernfunktion
](#sam-specification-generated-resources-function-core-properties)
+ [

## Ereignisquellen
](#sam-specification-generated-resources-function-event-sources)
+ [

## Konfiguration des Ereignisses
](#sam-specification-generated-resources-function-event-configuration)

## Eigenschaften der Kernfunktion
<a name="sam-specification-generated-resources-function-core-properties"></a>

In den folgenden Szenarien werden CloudFormation Ressourcen auf der Grundlage von Kernfunktionseigenschaften generiert:

### Die Rolleneigenschaft ist nicht angegeben
<a name="sam-specification-generated-resources-function-not-role"></a>

Wenn die `Role` Eigenschaft von *nicht* angegeben `AWS::Serverless::Function` ist, wird eine `AWS::IAM::Role` CloudFormation Ressource AWS SAM generiert.

**`AWS::IAM::Role`**  
*`LogicalId`: *`<function‑LogicalId>Role`  
*Referenzierbare Eigenschaft:* N/A (Sie müssen den verwenden, um auf diese `LogicalId` Ressource zu verweisen CloudFormation )

### AutoPublishAlias Eigenschaft ist angegeben
<a name="sam-specification-generated-resources-function-autopublishalias"></a>

Wenn die `AutoPublishAlias` Eigenschaft von an angegeben `AWS::Serverless::Function` ist, werden die folgenden CloudFormation Ressourcen AWS SAM generiert: `AWS::Lambda::Alias` und`AWS::Lambda::Version`.

**`AWS::Lambda::Alias`**  
*`LogicalId`: *`<function‑LogicalId>Alias<alias‑name>`  
`<alias‑name>`ist die Zeichenfolge, die auf gesetzt `AutoPublishAlias` ist. Wenn Sie beispielsweise `AutoPublishAlias` auf einstellen`live`, `LogicalId` lautet das: *MyFunction* Alias*live*.  
*Referenzierbare Eigenschaft:* `<function‑LogicalId>.Alias`

**`AWS::Lambda::Version`**  
*`LogicalId`: *`<function‑LogicalId>Version<sha>`  
`<sha>`ist ein eindeutiger Hashwert, der bei der Erstellung des Stacks generiert wird. Zum Beispiel *MyFunction* Version*926eeb5ff1*.  
*Referenzierbare Eigenschaft:* `<function‑LogicalId>.Version`

Weitere Informationen zur `AutoPublishAlias` Eigenschaft finden Sie im [Abschnitt Eigenschaften von AWS::Serverless::Function](sam-resource-function.md#sam-resource-function-properties).

### DeploymentPreference Eigenschaft ist angegeben
<a name="sam-specification-generated-resources-function-deploymentpreference"></a>

Wenn die `DeploymentPreference` Eigenschaft von an angegeben `AWS::Serverless::Function` ist, werden die folgenden CloudFormation Ressourcen AWS SAM generiert: `AWS::CodeDeploy::Application` und`AWS::CodeDeploy::DeploymentGroup`. Wenn die `Role` Eigenschaft des `DeploymentPreference` Objekts *nicht* angegeben ist, wird AWS SAM außerdem eine `AWS::IAM::Role` CloudFormation Ressource generiert.

**`AWS::CodeDeploy::Application`**  
*`LogicalId`: *`ServerlessDeploymentApplication`  
*Referenzierbare Eigenschaft:* N/A (Sie müssen den verwenden, um auf diese `LogicalId` Ressource zu verweisen CloudFormation )

**`AWS::CodeDeploy::DeploymentGroup`**  
*`LogicalId`: *`<function‑LogicalId>DeploymentGroup`  
*Referenzierbare Eigenschaft:* N/A (Sie müssen das verwenden, um auf diese Ressource `LogicalId` zu verweisen) CloudFormation 

**`AWS::IAM::Role`**  
*`LogicalId`: *`CodeDeployServiceRole`  
*Referenzierbare Eigenschaft:* N/A (Sie müssen das verwenden, um auf diese Ressource `LogicalId` zu verweisen) CloudFormation 

### FunctionUrlConfig Eigenschaft ist angegeben
<a name="sam-specification-generated-resources-function-functionurlconfig"></a>

Wenn die `FunctionUrlConfig` Eigenschaft angegeben ist, AWS SAM generiert verschiedene CloudFormation Ressourcen auf der Grundlage von`AuthType`.

Wenn `AuthType: NONE` angegeben, werden die folgenden CloudFormation Ressourcen AWS SAM generiert:

**`AWS::Lambda::Permission`(Zugriff aufrufen)**  
*`LogicalId`: *`<function‑LogicalId>URLInvokeAllowPublicAccess`  
*Referenzierbare Eigenschaft:* N/A (Sie müssen den verwenden, um auf diese Ressource `LogicalId` zu verweisen) CloudFormation 

**`AWS::Lambda::Permission`(Öffentlicher Zugang)**  
*`LogicalId`: *`<function‑LogicalId>UrlPublicPermissions`  
*Referenzierbare Eigenschaft:* N/A (Sie müssen das verwenden, um auf diese `LogicalId` Ressource zu verweisen CloudFormation )

**`AWS::Lambda::Url`**  
*`LogicalId`: *`<function‑LogicalId>Url`  
*Referenzierbare Eigenschaft:* N/A (Sie müssen das verwenden, um auf diese Ressource `LogicalId` zu verweisen) CloudFormation 

Wenn `AuthType: AWS_IAM` angegeben, AWS SAM generiert nur:

**`AWS::Lambda::Url`**  
*`LogicalId`: *`<function‑LogicalId>Url`  
*Referenzierbare Eigenschaft:* N/A (Sie müssen den verwenden, um auf diese `LogicalId` Ressource zu verweisen CloudFormation )

Weitere Informationen zur `FunctionUrlConfig` Eigenschaft finden Sie unter. [FunctionUrlConfig](sam-property-function-functionurlconfig.md)

## Ereignisquellen
<a name="sam-specification-generated-resources-function-event-sources"></a>

In den folgenden Szenarien werden CloudFormation Ressourcen auf der Grundlage von Ereignisquellen generiert:

### Eine API-Ereignisquelle ist angegeben
<a name="sam-specification-generated-resources-function-api"></a>

Wenn die `Event` Eigenschaft von auf gesetzt `AWS::Serverless::Function` ist`Api`, die `RestApiId` Eigenschaft aber *nicht* angegeben ist, wird die `AWS::ApiGateway::RestApi` CloudFormation Ressource AWS SAM generiert.

**`AWS::ApiGateway::RestApi`**  
*`LogicalId`: *`ServerlessRestApi`  
*Referenzierbare Eigenschaft:* N/A (Sie müssen den verwenden, um auf diese `LogicalId` Ressource zu verweisen CloudFormation )

### Eine HttpApi Ereignisquelle ist angegeben
<a name="sam-specification-generated-resources-function-httpapi"></a>

Wenn die `Event` Eigenschaft von auf gesetzt `AWS::Serverless::Function` ist`HttpApi`, die `ApiId` Eigenschaft aber *nicht* angegeben ist, wird die `AWS::ApiGatewayV2::Api` CloudFormation Ressource AWS SAM generiert.

**`AWS::ApiGatewayV2::Api`**  
*`LogicalId`: *`ServerlessHttpApi`  
*Referenzierbare Eigenschaft:* N/A (Sie müssen den verwenden, um auf diese `LogicalId` Ressource zu verweisen CloudFormation )

### Eine Quelle für Streaming-Ereignisse ist angegeben
<a name="sam-specification-generated-resources-function-streaming"></a>

Wenn die `Event` Eigenschaft von auf einen der Streaming-Typen gesetzt `AWS::Serverless::Function` ist, AWS SAM wird die `AWS::Lambda::EventSourceMapping` CloudFormation Ressource generiert. Dies gilt für die folgenden Typen: `DynamoDB``Kinesis`,`MQ`,`MSK`, und`SQS`.

**`AWS::Lambda::EventSourceMapping`**  
*`LogicalId`: *`<function‑LogicalId><event‑LogicalId>`  
*Referenzierbare Eigenschaft:* N/A (Sie müssen den verwenden, um auf diese `LogicalId` Ressource zu verweisen CloudFormation )

### Eine Ereignisquelle für eine Event-Bridge (oder einen Event-Bus) wurde angegeben
<a name="sam-specification-generated-resources-function-eventbridge"></a>

Wenn die `Event` Eigenschaft von auf einen der Typen Event Bridge (oder Event Bus) gesetzt `AWS::Serverless::Function` ist, AWS SAM wird die `AWS::Events::Rule` CloudFormation Ressource generiert. Dies gilt für die folgenden Typen: `EventBridgeRule``Schedule`, und`CloudWatchEvents`.

**`AWS::Events::Rule`**  
*`LogicalId`: *`<function‑LogicalId><event‑LogicalId>`  
*Referenzierbare Eigenschaft:* N/A (Sie müssen den verwenden, um auf diese `LogicalId` Ressource zu verweisen CloudFormation )

### Eine IotRule Ereignisquelle ist angegeben
<a name="sam-specification-generated-resources-function-iotrule"></a>

Wenn die `Event` Eigenschaft von an auf Io gesetzt `AWS::Serverless::Function` istTRule, wird die `AWS::IoT::TopicRule` CloudFormation Ressource AWS SAM generiert.

**`AWS::IoT::TopicRule`**  
*`LogicalId`: *`<function‑LogicalId><event‑LogicalId>`  
*Referenzierbare Eigenschaft:* N/A (Sie müssen den verwenden, um auf diese `LogicalId` Ressource zu verweisen CloudFormation )

## Konfiguration des Ereignisses
<a name="sam-specification-generated-resources-function-event-configuration"></a>

In den folgenden Szenarien werden CloudFormation Ressourcen basierend auf der Ereigniskonfiguration generiert:

### OnSuccess (oder OnFailure) Die Eigenschaft ist für Amazon SNS SNS-Ereignisse angegeben
<a name="sam-specification-generated-resources-function-sns-onsuccess"></a>

Wenn die Eigenschaft `OnSuccess` (oder`OnFailure`) der `DestinationConfig` Eigenschaft der `EventInvokeConfig` Eigenschaft von an angegeben `AWS::Serverless::Function` ist und der Zieltyp ist, `SNS` aber der Ziel-ARN *nicht* angegeben ist, werden die folgenden CloudFormation Ressourcen AWS SAM generiert: `AWS::Lambda::EventInvokeConfig` und`AWS::SNS::Topic`.

**`AWS::Lambda::EventInvokeConfig`**  
*`LogicalId`: *`<function‑LogicalId>EventInvokeConfig`  
*Referenzierbare Eigenschaft:* N/A (Sie müssen den verwenden, um auf diese `LogicalId` Ressource zu verweisen CloudFormation )

**`AWS::SNS::Topic`**  
*`LogicalId`: `<function‑LogicalId>OnSuccessTopic` (oder*) `<function‑LogicalId>OnFailureTopic`  
*Referenzierbares Eigentum:* `<function‑LogicalId>.DestinationTopic`  
Wenn beide `OnSuccess` und für ein Amazon SNS SNS-Ereignis angegeben `OnFailure` sind, müssen Sie zur Unterscheidung zwischen den generierten Ressourcen den `LogicalId` verwenden.

### OnSuccess (oder OnFailure) Die Eigenschaft ist für Amazon SQS SQS-Ereignisse angegeben
<a name="sam-specification-generated-resources-function-sqs-onsuccess"></a>

Wenn die Eigenschaft `OnSuccess` (oder`OnFailure`) der `DestinationConfig` Eigenschaft der `EventInvokeConfig` Eigenschaft von an angegeben `AWS::Serverless::Function` ist und der Zieltyp ist, `SQS` aber der Ziel-ARN *nicht* angegeben ist, werden die folgenden CloudFormation Ressourcen AWS SAM generiert: `AWS::Lambda::EventInvokeConfig` und`AWS::SQS::Queue`.

**`AWS::Lambda::EventInvokeConfig`**  
*`LogicalId`: *`<function‑LogicalId>EventInvokeConfig`  
*Referenzierbare Eigenschaft:* N/A (Sie müssen den verwenden, um auf diese `LogicalId` Ressource zu verweisen CloudFormation )

**`AWS::SQS::Queue`**  
*`LogicalId`: `<function‑LogicalId>OnSuccessQueue` (oder*) `<function‑LogicalId>OnFailureQueue`  
*Referenzierbares Eigentum:* `<function‑LogicalId>.DestinationQueue`  
Wenn beide `OnSuccess` und für ein Amazon SQS SQS-Ereignis angegeben `OnFailure` sind, müssen Sie zur Unterscheidung zwischen den generierten Ressourcen den `LogicalId` verwenden.