

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# CloudFormation Ressources générées pour AWS SAM
<a name="sam-specification-generated-resources"></a>

Cette section fournit des informations détaillées sur les CloudFormation ressources créées lors du traitement AWS SAM de votre AWS modèle. L'ensemble de CloudFormation ressources AWS SAM généré varie en fonction des scénarios que vous spécifiez. Un *scénario* est la combinaison des ressources et propriétés AWS SAM spécifiées dans votre fichier de modèle. Vous pouvez référencer les ressources CloudFormation générées ailleurs dans votre fichier de modèle, de la même manière que vous référencez les ressources que vous déclarez explicitement dans votre fichier de modèle.

Par exemple, si vous spécifiez une ressource `AWS::Serverless::Function` dans votre fichier de modèle AWS SAM , AWS SAM génère toujours une ressource de base `AWS::Lambda::Function`. Si vous spécifiez également la `AutoPublishAlias` propriété facultative, des AWS SAM sources `AWS::Lambda::Alias` et `AWS::Lambda::Version` des ressources supplémentaires.

Cette section répertorie les scénarios et les CloudFormation ressources qu'ils génèrent, et montre comment référencer les CloudFormation ressources générées dans votre fichier AWS SAM modèle.

## Référencement des ressources générées CloudFormation
<a name="sam-specification-generated-resources-referencing"></a>

Vous avez deux options pour référencer les CloudFormation ressources générées dans votre fichier AWS SAM modèle, par `LogicalId` ou par propriété référençable.

### Référencement des CloudFormation ressources générées par LogicalId
<a name="sam-specification-generated-resources-referencing-logicalid"></a>

Les CloudFormation ressources AWS SAM générées possèdent chacune un `[LogicalId](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html#resources-section-structure-logicalid)` identifiant alphanumérique (A-Z, a-z, 0-9) unique dans un fichier modèle. AWS SAM utilise les AWS SAM ressources `LogicalIds` de votre fichier modèle pour créer `LogicalIds` les CloudFormation ressources qu'il génère. Vous pouvez utiliser une CloudFormation ressource générée pour accéder aux propriétés de cette ressource dans votre fichier modèle, comme vous le feriez pour une CloudFormation ressource que vous avez explicitement déclarée. `LogicalId` Pour plus d'informations sur `LogicalIds` les modèles intégrés CloudFormation et les AWS SAM modèles, consultez la section [Ressources](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html) du *guide de AWS CloudFormation l'utilisateur*.

**Note**  
Les `LogicalIds` de certaines ressources générées incluent une valeur de hachage unique pour éviter les conflits d'espace de noms. Les `LogicalIds` de ces ressources sont dérivées lorsque la pile est créée. Vous ne pouvez les récupérer qu'une fois que la pile a été créée à l'aide du AWS Management Console AWS CLI, ou de l'un des AWS SDKs. Nous vous déconseillons de référencer ces ressources par `LogicalId` car les valeurs de hachage peuvent être modifiées.

### Référencement des CloudFormation ressources générées par une propriété référençable
<a name="sam-specification-generated-resources-referencing-referenceable-property"></a>

 AWS SAM Fournit une propriété référençable de la ressource pour certaines ressources générées. AWS SAM Vous pouvez utiliser cette propriété pour référencer une CloudFormation ressource générée et ses propriétés dans votre fichier AWS SAM modèle.

**Note**  
Les CloudFormation ressources générées ne possèdent pas toutes des propriétés référençables. Pour ces ressources, vous devez utiliser le `LogicalId`.

## Scénarios CloudFormation de ressources générés
<a name="sam-specification-generated-resources-scenarios"></a>

Le tableau suivant récapitule les AWS SAM ressources et les propriétés qui constituent les scénarios qui génèrent des CloudFormation ressources. Les rubriques de la colonne **Scénarios** fournissent des détails sur les CloudFormation ressources supplémentaires AWS SAM générées pour ce scénario.


| AWS SAM ressource |  CloudFormation Ressource de base | Scénarios | 
| --- | --- | --- | 
| AWS::Serverless::Api  | [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-restapi.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-restapi.html) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/serverless-application-model/latest/developerguide/sam-specification-generated-resources.html)  | 
| AWS::Serverless::Application  | [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/serverless-application-model/latest/developerguide/sam-specification-generated-resources.html)  | 
| AWS::Serverless::CapacityProvider  | [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/serverless-application-model/latest/developerguide/sam-specification-generated-resources.html)  | 
| AWS::Serverless::Function | [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/serverless-application-model/latest/developerguide/sam-specification-generated-resources.html)  | 
| AWS::Serverless::HttpApi | [AWS::ApiGatewayV2::Api](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigatewayv2-api.html) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/serverless-application-model/latest/developerguide/sam-specification-generated-resources.html)  | 
| AWS::Serverless::LayerVersion  | [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/serverless-application-model/latest/developerguide/sam-specification-generated-resources.html)  | 
| AWS::Serverless::SimpleTable  | [AWS::DynamoDB::Table](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-table.html) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/serverless-application-model/latest/developerguide/sam-specification-generated-resources.html)  | 
| AWS::Serverless::StateMachine  | [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/serverless-application-model/latest/developerguide/sam-specification-generated-resources.html)  | 

**Topics**
+ [

## Référencement des ressources générées CloudFormation
](#sam-specification-generated-resources-referencing)
+ [

## Scénarios CloudFormation de ressources générés
](#sam-specification-generated-resources-scenarios)
+ [

# CloudFormation ressources générées lorsque cela AWS::Serverless::Api est spécifié
](sam-specification-generated-resources-api.md)
+ [

# CloudFormation ressources générées lorsque cela AWS::Serverless::Application est spécifié
](sam-specification-generated-resources-application.md)
+ [

# CloudFormation ressources générées lorsque cela AWS::Serverless::CapacityProvider est spécifié
](sam-specification-generated-resources-capacityprovider.md)
+ [

# CloudFormation ressources générées lorsque vous spécifiez AWS::Serverless::Connector
](sam-specification-generated-resources-connector.md)
+ [

# CloudFormation ressources générées lorsque cela AWS::Serverless::Function est spécifié
](sam-specification-generated-resources-function.md)
+ [

# CloudFormation ressources générées lorsque cela AWS::Serverless::GraphQLApi est spécifié
](sam-specification-generated-resources-graphqlapi.md)
+ [

# CloudFormation ressources générées lorsque cela AWS::Serverless::HttpApi est spécifié
](sam-specification-generated-resources-httpapi.md)
+ [

# CloudFormation ressources générées lorsque cela AWS::Serverless::LayerVersion est spécifié
](sam-specification-generated-resources-layerversion.md)
+ [

# CloudFormation ressources générées lorsque cela AWS::Serverless::SimpleTable est spécifié
](sam-specification-generated-resources-simpletable.md)
+ [

# CloudFormation ressources générées lorsque cela AWS::Serverless::StateMachine est spécifié
](sam-specification-generated-resources-statemachine.md)

# CloudFormation ressources générées lorsque cela AWS::Serverless::Api est spécifié
<a name="sam-specification-generated-resources-api"></a>

Lorsqu'un `AWS::Serverless::Api` est spécifié, AWS Serverless Application Model (AWS SAM) génère toujours une CloudFormation ressource `AWS::ApiGateway::RestApi` de base. En outre, il génère toujours une ressource `AWS::ApiGateway::Stage` et `AWS::ApiGateway::Deployment`.

**`AWS::ApiGateway::RestApi`**  
*`LogicalId`: *`<api‑LogicalId>`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

**`AWS::ApiGateway::Stage`**  
*`LogicalId`: *`<api‑LogicalId><stage‑name>Stage`  
`<stage‑name>` est la chaîne sur laquelle la propriété `StageName` est définie. Par exemple, si vous définissez `StageName` sur `Gamma`, le `LogicalId` est `MyRestApiGammaStage`.  
*Propriété référençable :*`<api‑LogicalId>.Stage`

**`AWS::ApiGateway::Deployment`**  
*`LogicalId`: *`<api‑LogicalId>Deployment<sha>`  
`<sha>` est une valeur de hachage unique qui est générée lors de la création de la pile. Par exemple, `MyRestApiDeployment926eeb5ff1`.  
*Propriété référençable :*`<api‑LogicalId>.Deployment`

En plus de ces CloudFormation ressources, lorsqu'elles `AWS::Serverless::Api` sont spécifiées, cela AWS SAM génère des CloudFormation ressources supplémentaires pour les scénarios suivants.

**Topics**
+ [

## DomainName la propriété est spécifiée
](#sam-specification-generated-resources-api-domain-name)
+ [

## UsagePlan la propriété est spécifiée
](#sam-specification-generated-resources-api-usage-plan)

## DomainName la propriété est spécifiée
<a name="sam-specification-generated-resources-api-domain-name"></a>

Lorsque la `DomainName` propriété de la `Domain` propriété de an `AWS::Serverless::Api` est spécifiée, AWS SAM génère la `AWS::ApiGateway::DomainName` CloudFormation ressource.

**`AWS::ApiGateway::DomainName`**  
*`LogicalId`: *`ApiGatewayDomainName<sha>`  
`<sha>` est une valeur de hachage unique qui est générée lors de la création de la pile. Par exemple : `ApiGatewayDomainName926eeb5ff1`.  
*Propriété référençable :*`<api‑LogicalId>.DomainName`

## UsagePlan la propriété est spécifiée
<a name="sam-specification-generated-resources-api-usage-plan"></a>

Lorsque la `UsagePlan` propriété de la `Auth` propriété de an `AWS::Serverless::Api` est spécifiée, AWS SAM génère les CloudFormation ressources suivantes : `AWS::ApiGateway::UsagePlan``AWS::ApiGateway::UsagePlanKey`, et`AWS::ApiGateway::ApiKey`.

**`AWS::ApiGateway::UsagePlan`**  
*`LogicalId`: *`<api‑LogicalId>UsagePlan`  
*Propriété référençable :*`<api‑LogicalId>.UsagePlan`

**`AWS::ApiGateway::UsagePlanKey`**  
*`LogicalId`: *`<api‑LogicalId>UsagePlanKey`  
*Propriété référençable :*`<api‑LogicalId>.UsagePlanKey`

**`AWS::ApiGateway::ApiKey`**  
*`LogicalId`: *`<api‑LogicalId>ApiKey`  
*Propriété référençable :*`<api‑LogicalId>.ApiKey`

# CloudFormation ressources générées lorsque cela AWS::Serverless::Application est spécifié
<a name="sam-specification-generated-resources-application"></a>

Lorsqu'un `AWS::Serverless::Application` est spécifié, AWS Serverless Application Model (AWS SAM) génère une CloudFormation ressource `AWS::CloudFormation::Stack` de base.

**`AWS::CloudFormation::Stack`**  
*`LogicalId`: *`<application‑LogicalId>`   
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

# CloudFormation ressources générées lorsque cela AWS::Serverless::CapacityProvider est spécifié
<a name="sam-specification-generated-resources-capacityprovider"></a>

Lorsqu'une `AWS::Serverless::CapacityProvider` est spécifiée, AWS Serverless Application Model (AWS SAM) génère une ressource CloudFormation de base `AWS::Lambda::CapacityProvider`.

**`AWS::Lambda::CapacityProvider`**  
*`LogicalId`: *`<capacityprovider‑LogicalId>`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

Outre cette CloudFormation ressource, lorsqu'elle `AWS::Serverless::CapacityProvider` est spécifiée, elle génère AWS SAM également CloudFormation des ressources pour les scénarios suivants :

**Topics**
+ [

## OperatorRole la propriété n'est pas spécifiée
](#sam-specification-generated-resources-capacityprovider-iam-role)

## OperatorRole la propriété n'est pas spécifiée
<a name="sam-specification-generated-resources-capacityprovider-iam-role"></a>

Lorsque la `OperatorRole` propriété de an *n'`AWS::Serverless::CapacityProvider`est pas* spécifiée, AWS SAM génère une `AWS::IAM::Role` CloudFormation ressource à laquelle est attachée la politique `AWSLambdaManagedEC2ResourceOperator` gérée.

**`AWS::IAM::Role`**  
*`LogicalId`: *`<capacityprovider‑LogicalId>OperatorRole`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

# CloudFormation ressources générées lorsque vous spécifiez AWS::Serverless::Connector
<a name="sam-specification-generated-resources-connector"></a>

**Note**  
Lorsque vous définissez des connecteurs via la propriété `Connectors` propriété, celle-ci est d'abord transformée en ressource `AWS::Serverless::Connector` avant de générer ces ressources.

Lorsque vous spécifiez une `AWS::Serverless::Connector` ressource dans un AWS SAM modèle, AWS SAM génère les AWS CloudFormation ressources suivantes selon les besoins.

**`AWS::IAM::ManagedPolicy`**  
 *`LogicalId`:*`<connector‑LogicalId>Policy`   
 *Propriété référençable :* N/A (Pour référencer cette CloudFormation ressource, vous devez utiliser le`LogicalId`.) 

**`AWS::SNS::TopicPolicy`**  
 *`LogicalId`:*`<connector‑LogicalId>TopicPolicy`   
 *Propriété référençable :* N/A (Pour référencer cette CloudFormation ressource, vous devez utiliser le`LogicalId`.) 

**`AWS::SQS::QueuePolicy`**  
 *`LogicalId`:*`<connector‑LogicalId>QueuePolicy`   
 *Propriété référençable :* N/A (Pour référencer cette CloudFormation ressource, vous devez utiliser le`LogicalId`.) 

**`AWS::Lambda::Permission`**  
 *`LogicalId`:*`<connector‑LogicalId><permission>LambdaPermission`   
 `<permission>` est une autorisation spécifiée par la propriété `Permissions`. Par exemple, `Write`.   
*Propriété référençable :* N/A (Pour référencer cette CloudFormation ressource, vous devez utiliser le`LogicalId`.) 

# CloudFormation ressources générées lorsque cela AWS::Serverless::Function est spécifié
<a name="sam-specification-generated-resources-function"></a>

Lorsqu'un `AWS::Serverless::Function` est spécifié, AWS Serverless Application Model (AWS SAM) crée toujours une CloudFormation ressource `AWS::Lambda::Function` de base.

**`AWS::Lambda::Function`**  
*`LogicalId`: *`<function‑LogicalId>`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

En plus de cette CloudFormation ressource, lorsqu'elle `AWS::Serverless::Function` est spécifiée, elle génère AWS SAM également CloudFormation des ressources pour les scénarios suivants.

**Topics**
+ [

## Propriétés des fonctions de base
](#sam-specification-generated-resources-function-core-properties)
+ [

## Sources des évènements
](#sam-specification-generated-resources-function-event-sources)
+ [

## Configuration de l'événement
](#sam-specification-generated-resources-function-event-configuration)

## Propriétés des fonctions de base
<a name="sam-specification-generated-resources-function-core-properties"></a>

Les scénarios suivants génèrent des CloudFormation ressources en fonction des propriétés des fonctions principales :

### La propriété Role n'est pas spécifiée
<a name="sam-specification-generated-resources-function-not-role"></a>

Lorsque la `Role` propriété de an *n'`AWS::Serverless::Function`est pas* spécifiée, AWS SAM génère une `AWS::IAM::Role` CloudFormation ressource.

**`AWS::IAM::Role`**  
*`LogicalId`: *`<function‑LogicalId>Role`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

### AutoPublishAlias la propriété est spécifiée
<a name="sam-specification-generated-resources-function-autopublishalias"></a>

Lorsque la `AutoPublishAlias` propriété de an `AWS::Serverless::Function` est spécifiée, AWS SAM génère les CloudFormation ressources suivantes : `AWS::Lambda::Alias` et`AWS::Lambda::Version`.

**`AWS::Lambda::Alias`**  
*`LogicalId`: *`<function‑LogicalId>Alias<alias‑name>`  
`<alias‑name>` est la chaîne sur laquelle `AutoPublishAlias` est défini. Par exemple, si vous définissez sur `AutoPublishAlias``live`, `LogicalId` c'est : *MyFunction* Alias*live*.  
*Propriété référençable :*`<function‑LogicalId>.Alias`

**`AWS::Lambda::Version`**  
*`LogicalId`: *`<function‑LogicalId>Version<sha>`  
`<sha>` est une valeur de hachage unique qui est générée lors de la création de la pile. Par exemple, *MyFunction* Version*926eeb5ff1*.  
*Propriété référençable :*`<function‑LogicalId>.Version`

Pour plus d'informations sur la `AutoPublishAlias` propriété, consultez la [section Propriétés de AWS::Serverless::Function](sam-resource-function.md#sam-resource-function-properties).

### DeploymentPreference la propriété est spécifiée
<a name="sam-specification-generated-resources-function-deploymentpreference"></a>

Lorsque la `DeploymentPreference` propriété de an `AWS::Serverless::Function` est spécifiée, AWS SAM génère les CloudFormation ressources suivantes : `AWS::CodeDeploy::Application` et`AWS::CodeDeploy::DeploymentGroup`. En outre, si la `Role` propriété de l'`DeploymentPreference`objet *n'est pas* spécifiée, génère AWS SAM également une `AWS::IAM::Role` CloudFormation ressource.

**`AWS::CodeDeploy::Application`**  
*`LogicalId`: *`ServerlessDeploymentApplication`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

**`AWS::CodeDeploy::DeploymentGroup`**  
*`LogicalId`: *`<function‑LogicalId>DeploymentGroup`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

**`AWS::IAM::Role`**  
*`LogicalId`: *`CodeDeployServiceRole`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

### FunctionUrlConfig la propriété est spécifiée
<a name="sam-specification-generated-resources-function-functionurlconfig"></a>

Lorsque la `FunctionUrlConfig` propriété est spécifiée, AWS SAM génère différentes CloudFormation ressources en fonction de`AuthType`.

Lorsque `AuthType: NONE` cela est spécifié, AWS SAM génère les CloudFormation ressources suivantes :

**`AWS::Lambda::Permission`(Invoquer l'accès)**  
*`LogicalId`: *`<function‑LogicalId>URLInvokeAllowPublicAccess`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

**`AWS::Lambda::Permission`(Accès public)**  
*`LogicalId`: *`<function‑LogicalId>UrlPublicPermissions`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

**`AWS::Lambda::Url`**  
*`LogicalId`: *`<function‑LogicalId>Url`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

Lorsqu'il `AuthType: AWS_IAM` est spécifié, AWS SAM génère uniquement :

**`AWS::Lambda::Url`**  
*`LogicalId`: *`<function‑LogicalId>Url`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

Pour plus d'informations sur la `FunctionUrlConfig` propriété, voir [FunctionUrlConfig](sam-property-function-functionurlconfig.md).

## Sources des évènements
<a name="sam-specification-generated-resources-function-event-sources"></a>

Les scénarios suivants génèrent des CloudFormation ressources en fonction des sources d'événements :

### Une source d'événement Api est spécifiée
<a name="sam-specification-generated-resources-function-api"></a>

Lorsque la `Event` propriété de an `AWS::Serverless::Function` est définie sur`Api`, mais que la `RestApiId` propriété *n'est pas* spécifiée, AWS SAM la `AWS::ApiGateway::RestApi` CloudFormation ressource est générée.

**`AWS::ApiGateway::RestApi`**  
*`LogicalId`: *`ServerlessRestApi`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

### Une source d' HttpApi événement est spécifiée
<a name="sam-specification-generated-resources-function-httpapi"></a>

Lorsque la `Event` propriété de an `AWS::Serverless::Function` est définie sur`HttpApi`, mais que la `ApiId` propriété *n'est pas* spécifiée, AWS SAM la `AWS::ApiGatewayV2::Api` CloudFormation ressource est générée.

**`AWS::ApiGatewayV2::Api`**  
*`LogicalId`: *`ServerlessHttpApi`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

### Une source d'événements de streaming en continu est spécifiée
<a name="sam-specification-generated-resources-function-streaming"></a>

Lorsque la `Event` propriété de an `AWS::Serverless::Function` est définie sur l'un des types de streaming, AWS SAM génère la `AWS::Lambda::EventSourceMapping` CloudFormation ressource. Cela s'applique aux types suivants : `DynamoDB`, `Kinesis`, `MQ`, `MSK`, et `SQS`.

**`AWS::Lambda::EventSourceMapping`**  
*`LogicalId`: *`<function‑LogicalId><event‑LogicalId>`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

### Une source d'événement pont d'événements (ou bus d'événements) est spécifiée
<a name="sam-specification-generated-resources-function-eventbridge"></a>

Lorsque la `Event` propriété de an `AWS::Serverless::Function` est définie sur l'un des types de pont d'événements (ou bus d'événements), AWS SAM génère la `AWS::Events::Rule` CloudFormation ressource. Cela s'applique aux types suivants : `EventBridgeRule`, `Schedule`, et `CloudWatchEvents`.

**`AWS::Events::Rule`**  
*`LogicalId`: *`<function‑LogicalId><event‑LogicalId>`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

### Une source d' IotRule événement est spécifiée
<a name="sam-specification-generated-resources-function-iotrule"></a>

Lorsque la `Event` propriété de an `AWS::Serverless::Function` est définie sur IoTRule, AWS SAM génère la `AWS::IoT::TopicRule` CloudFormation ressource.

**`AWS::IoT::TopicRule`**  
*`LogicalId`: *`<function‑LogicalId><event‑LogicalId>`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

## Configuration de l'événement
<a name="sam-specification-generated-resources-function-event-configuration"></a>

Les scénarios suivants génèrent des CloudFormation ressources en fonction de la configuration des événements :

### OnSuccess (ou OnFailure) la propriété est spécifiée pour les événements Amazon SNS
<a name="sam-specification-generated-resources-function-sns-onsuccess"></a>

Lorsque la propriété `OnSuccess` (ou`OnFailure`) de la `DestinationConfig` propriété de la `EventInvokeConfig` propriété d'un `AWS::Serverless::Function` est spécifiée, et que le type de destination est spécifié `SNS` mais que l'ARN de destination *n'est pas* spécifié, AWS SAM génère les CloudFormation ressources suivantes : `AWS::Lambda::EventInvokeConfig` et`AWS::SNS::Topic`.

**`AWS::Lambda::EventInvokeConfig`**  
*`LogicalId`: *`<function‑LogicalId>EventInvokeConfig`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

**`AWS::SNS::Topic`**  
*`LogicalId`:* `<function‑LogicalId>OnSuccessTopic` (ou`<function‑LogicalId>OnFailureTopic`)  
*Propriété référençable :*`<function‑LogicalId>.DestinationTopic`  
Si les deux `OnSuccess` et `OnFailure` sont spécifiés pour un événement Amazon SNS, pour faire la distinction entre les ressources générées, vous devez utiliser la `LogicalId`.

### OnSuccess la propriété (ou OnFailure) est spécifiée pour les événements Amazon SQS
<a name="sam-specification-generated-resources-function-sqs-onsuccess"></a>

Lorsque la propriété `OnSuccess` (ou`OnFailure`) de la `DestinationConfig` propriété de la `EventInvokeConfig` propriété d'un `AWS::Serverless::Function` est spécifiée, et que le type de destination est spécifié `SQS` mais que l'ARN de destination *n'est pas* spécifié, AWS SAM génère les CloudFormation ressources suivantes : `AWS::Lambda::EventInvokeConfig` et`AWS::SQS::Queue`.

**`AWS::Lambda::EventInvokeConfig`**  
*`LogicalId`: *`<function‑LogicalId>EventInvokeConfig`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

**`AWS::SQS::Queue`**  
*`LogicalId`:* `<function‑LogicalId>OnSuccessQueue` (ou`<function‑LogicalId>OnFailureQueue`)  
*Propriété référençable :*`<function‑LogicalId>.DestinationQueue`  
Si les deux `OnSuccess` et `OnFailure` sont spécifiés pour un événement Amazon SQS, pour faire la distinction entre les ressources générées, vous devez utiliser la `LogicalId`.

# CloudFormation ressources générées lorsque cela AWS::Serverless::GraphQLApi est spécifié
<a name="sam-specification-generated-resources-graphqlapi"></a>

Lorsque vous spécifiez une `AWS::Serverless::GraphQLApi` ressource dans un modèle AWS Serverless Application Model (AWS SAM), crée AWS SAM toujours les AWS CloudFormation ressources de base suivantes.

**`AWS::AppSync::DataSource`**  
*`LogicalId`: *`<graphqlapi-LogicalId><datasource-RelativeId><datasource-Type>DataSource`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

**`AWS::AppSync::FunctionConfiguration`**  
*`LogicalId`: *`<graphqlapi-LogicalId><function-RelativeId>`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

**`AWS::AppSync::GraphQLApi`**  
*`LogicalId`: *`<graphqlapi-LogicalId>`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

**`AWS::AppSync::GraphQLSchema`**  
*`LogicalId`: *`<graphqlapi-LogicalId>Schema`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

**`AWS::AppSync::Resolver`**  
*`LogicalId`: *`<graphqlapi-LogicalId><OperationType><resolver-RelativeId>`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

En plus de ces CloudFormation ressources, `AWS::Serverless::GraphQLApi` le moment spécifié AWS SAM peut également générer les CloudFormation ressources suivantes.

`AWS::AppSync::ApiCache`  
*`LogicalId`: *`<graphqlapi-LogicalId>ApiCache`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

`AWS::AppSync::ApiKey`  
*`LogicalId`: *`<graphqlapi-LogicalId><apikey-RelativeId>`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

`AWS::AppSync::DomainName`  
*`LogicalId`: *`<graphqlapi-LogicalId>DomainName`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

`AWS::AppSync::DomainNameApiAssociation`  
*`LogicalId`: *`<graphqlapi-LogicalId>DomainNameApiAssociation`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

AWS SAM peut également utiliser la `AWS::Serverless::Connector` ressource pour octroyer des autorisations. Pour de plus amples informations, veuillez consulter [CloudFormation ressources générées lorsque vous spécifiez AWS::Serverless::Connector](sam-specification-generated-resources-connector.md).

# CloudFormation ressources générées lorsque cela AWS::Serverless::HttpApi est spécifié
<a name="sam-specification-generated-resources-httpapi"></a>

Lorsqu'un `AWS::Serverless::HttpApi` est spécifié, AWS Serverless Application Model (AWS SAM) génère une CloudFormation ressource `AWS::ApiGatewayV2::Api` de base.

**`AWS::ApiGatewayV2::Api`**  
*`LogicalId`: *`<httpapi‑LogicalId>`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

En plus de cette CloudFormation ressource, lorsqu'elle `AWS::Serverless::HttpApi` est spécifiée, elle génère AWS SAM également CloudFormation des ressources pour les scénarios suivants :

**Topics**
+ [

## StageName la propriété est spécifiée
](#sam-specification-generated-resources-httpapi-stage-name)
+ [

## StageName la propriété *n'est pas* spécifiée
](#sam-specification-generated-resources-httpapi-not-stage-name)
+ [

## DomainName la propriété est spécifiée
](#sam-specification-generated-resources-httpapi-domain-name)

## StageName la propriété est spécifiée
<a name="sam-specification-generated-resources-httpapi-stage-name"></a>

Lorsque la `StageName` propriété de an `AWS::Serverless::HttpApi` est spécifiée, AWS SAM génère la `AWS::ApiGatewayV2::Stage` CloudFormation ressource.

**`AWS::ApiGatewayV2::Stage`**  
*`LogicalId`: *`<httpapi‑LogicalId><stage‑name>Stage`  
`<stage‑name>` est la chaîne sur laquelle la propriété `StageName` est définie. Par exemple, si vous définissez sur `StageName``Gamma`, `LogicalId` c'est : *MyHttpApiGamma* Stage.  
*Propriété référençable :*`<httpapi‑LogicalId>.Stage`

## StageName la propriété *n'est pas* spécifiée
<a name="sam-specification-generated-resources-httpapi-not-stage-name"></a>

Lorsque la `StageName` propriété de an *n'`AWS::Serverless::HttpApi`est pas* spécifiée, AWS SAM génère la `AWS::ApiGatewayV2::Stage` CloudFormation ressource.

**`AWS::ApiGatewayV2::Stage`**  
*`LogicalId`: *`<httpapi‑LogicalId>ApiGatewayDefaultStage`  
*Propriété référençable :*`<httpapi‑LogicalId>.Stage`

## DomainName la propriété est spécifiée
<a name="sam-specification-generated-resources-httpapi-domain-name"></a>

Lorsque la `DomainName` propriété de la `Domain` propriété de an `AWS::Serverless::HttpApi` est spécifiée, AWS SAM génère la `AWS::ApiGatewayV2::DomainName` CloudFormation ressource.

**`AWS::ApiGatewayV2::DomainName`**  
*`LogicalId`: *`ApiGatewayDomainNameV2<sha>`  
`<sha>` est une valeur de hachage unique qui est générée lors de la création de la pile. Par exemple, `ApiGatewayDomainNameV2`*926eeb5ff1*.  
*Propriété référençable :*`<httpapi‑LogicalId>.DomainName`

# CloudFormation ressources générées lorsque cela AWS::Serverless::LayerVersion est spécifié
<a name="sam-specification-generated-resources-layerversion"></a>

Lorsqu'un `AWS::Serverless::LayerVersion` est spécifié, AWS Serverless Application Model (AWS SAM) génère une CloudFormation ressource `AWS::Lambda::LayerVersion` de base.

**`AWS::Lambda::LayerVersion`**  
*`LogicalId`: *`<layerversion‑LogicalId>`   
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

# CloudFormation ressources générées lorsque cela AWS::Serverless::SimpleTable est spécifié
<a name="sam-specification-generated-resources-simpletable"></a>

Lorsqu'un `AWS::Serverless::SimpleTable` est spécifié, AWS Serverless Application Model (AWS SAM) génère une CloudFormation ressource `AWS::DynamoDB::Table` de base.

**`AWS::DynamoDB::Table`**  
*`LogicalId`: *`<simpletable‑LogicalId>`   
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

# CloudFormation ressources générées lorsque cela AWS::Serverless::StateMachine est spécifié
<a name="sam-specification-generated-resources-statemachine"></a>

Lorsqu'une `AWS::Serverless::StateMachine` est spécifiée, AWS Serverless Application Model (AWS SAM) génère une ressource CloudFormation de base `AWS::StepFunctions::StateMachine`.

**`AWS::StepFunctions::StateMachine`**  
*`LogicalId`: *`<statemachine‑LogicalId>`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

Outre cette CloudFormation ressource, lorsqu'elle `AWS::Serverless::StateMachine` est spécifiée, elle génère AWS SAM également CloudFormation des ressources pour les scénarios suivants :

**Topics**
+ [

## La propriété Role n'est pas spécifiée
](#sam-specification-generated-resources-statemachine-not-role)
+ [

## Une source d'événement d'API est spécifiée
](#sam-specification-generated-resources-statemachine-api)
+ [

## Une source d'événement pont d'événements (ou bus d'événements) est spécifiée
](#sam-specification-generated-resources-statemachine-eventbridge)

## La propriété Role n'est pas spécifiée
<a name="sam-specification-generated-resources-statemachine-not-role"></a>

Lorsque la `Role` propriété de an *n'`AWS::Serverless::StateMachine`est pas* spécifiée, AWS SAM génère une `AWS::IAM::Role` CloudFormation ressource.

**`AWS::IAM::Role`**  
*`LogicalId`: *`<statemachine‑LogicalId>Role`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

## Une source d'événement d'API est spécifiée
<a name="sam-specification-generated-resources-statemachine-api"></a>

Lorsque la `Event` propriété de an `AWS::Serverless::StateMachine` est définie sur`Api`, mais que la `RestApiId` propriété *n'est pas* spécifiée, AWS SAM la `AWS::ApiGateway::RestApi` CloudFormation ressource est générée.

**`AWS::ApiGateway::RestApi`**  
*`LogicalId`: *`ServerlessRestApi`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)

## Une source d'événement pont d'événements (ou bus d'événements) est spécifiée
<a name="sam-specification-generated-resources-statemachine-eventbridge"></a>

Lorsque la `Event` propriété de an `AWS::Serverless::StateMachine` est définie sur l'un des types de pont d'événements (ou bus d'événements), AWS SAM génère la `AWS::Events::Rule` CloudFormation ressource. Cela s'applique aux types suivants : `EventBridgeRule`, `Schedule`, et `CloudWatchEvents`.

**`AWS::Events::Rule`**  
*`LogicalId`: *`<statemachine‑LogicalId><event‑LogicalId>`  
*Propriété référençable :* N/A (vous devez utiliser le `LogicalId` pour référencer cette CloudFormation ressource)