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.

# aws-apigateway-lambda
<a name="aws-apigateway-lambda"></a>

![](http://docs.aws.amazon.com/fr_fr/solutions/latest/constructs/images/experimental.png)


 Toutes les classes sont en cours de développement actif et sujettes à des modifications ou à des suppressions non rétrocompatibles dans n'importe quelle version future. Celles-ci ne sont pas assujetties à la[Gestion sémantique](https://semver.org/)Modèle. Cela signifie que même si vous pouvez les utiliser, vous devrez peut-être mettre à jour votre code source lors de la mise à niveau vers une version plus récente de ce package. 

**Remarque:** Pour garantir une bonne fonctionnalité, les packages AWS Solutions Constructs et AWS CDK de votre projet doivent être la même version. 


|  **Langage**  |  **Package**  | 
| --- | --- | 
|  ![](http://docs.aws.amazon.com/fr_fr/solutions/latest/constructs/images/python.png) Python  |  aws\_solutions\_constructs.aws\_apigateway\_lambda  | 
|  ![](http://docs.aws.amazon.com/fr_fr/solutions/latest/constructs/images/typescript.png) TypeScript  |  @aws-solutions-constructs/aws-apigateway-lambda  | 
|  ![](http://docs.aws.amazon.com/fr_fr/solutions/latest/constructs/images/java.png) Java  |  software.amazon.awsconstructs.services.apigatewaylambda  | 

## Overview
<a name="overview-1"></a>

 AWS Solutions Construct implémente une API REST Amazon API Gateway connectée à une fonction AWS Lambda.

 Voici une définition de modèle déployable minimale dans TypeScript : 

```
import { ApiGatewayToLambda } from '@aws-solutions-constructs/aws-apigateway-lambda';

new ApiGatewayToLambda(this, 'ApiGatewayToLambdaPattern', {
    lambdaFunctionProps: {
      runtime: lambda.Runtime.NODEJS_14_X,
      // This assumes a handler function in lib/lambda/index.js
      code: lambda.Code.fromAsset(`${__dirname}/lambda`),
      handler: 'index.handler'
    }
});
```

## Initializer
<a name="initializer-1"></a>

```
new ApiGatewayToLambda(scope: Construct, id: string, props: ApiGatewayToLambdaProps);
```

 *Paramètres* 
+  scope[https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_core.Construct.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_core.Construct.html) 
+  id`string` 
+  props[`ApiGatewayToLambdaProps`](#pattern-construct-props-1) 

## Accessoires de construction de modèle
<a name="pattern-construct-props-1"></a>


|  **Nom**  |  **Type**  |  **Description**  | 
| --- | --- | --- | 
|  L'existence de Glambdaobj ?  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html)  |  Instance existante de l'objet Lambda Function, fournissant à la fois ceci etlambdaFunctionPropsprovoquera une erreur.  | 
|  LambdaFunctionProps ?  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.FunctionProps.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.FunctionProps.html)  |  Propriétés facultatives fournies par l'utilisateur pour remplacer les propriétés par défaut de la fonction Lambda. Ignoré si unexistingLambdaObjest fourni.  | 
|  ApigatewayProps ?  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-apigateway.LambdaRestApi.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-apigateway.LambdaRestApi.html)  |  Props fournis par l'utilisateur en option pour remplacer les accessoires par défaut de l'API.  | 
|  LogGroupProps ?  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-logs.LogGroupProps.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-logs.LogGroupProps.html)  |  Des accessoires facultatifs fournis par l'utilisateur pour remplacer les accessoires par défaut pour le groupe de journaux CloudWatch Logs.  | 

## Propriétés de modèle
<a name="pattern-properties-1"></a>


|  **Nom**  |  **Type**  |  **Description**  | 
| --- | --- | --- | 
|  ApigateWayCloudWatchRole  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-iam.Role.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-iam.Role.html)  |  Renvoie une instance du rôle IAM créé par le modèle qui active la journalisation des accès à partir de l'API Gateway API vers CloudWatch.  | 
|  ApigateWayLogGroup  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-logs.LogGroup.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-logs.LogGroup.html)  |  Renvoie une instance du groupe de journaux créé par le modèle auquel les journaux d'accès API REST de API Gateway d'API sont envoyés.  | 
|  LambdaFunction  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html)  |  Renvoie une instance de la fonction Lambda créée par le modèle.  | 
|  AppiGateway  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-apigateway.LambdaRestApi.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-apigateway.LambdaRestApi.html)  |  Renvoie une instance de l'API Gateway API créée par le modèle.  | 

## Paramètres par défaut
<a name="default-settings-1"></a>

 L'implémentation prête à l'emploi de ce modèle sans remplacement définira les valeurs par défaut suivantes :

### Amazon API Gateway
<a name="amazon-api-gateway-1"></a>
+  Déploiement d'un terminal d'API optimisé pour les périphériques 
+  Activer la journalisation CloudWatch pour API Gateway 
+  Configurer le rôle IAM d'accès minimal aux privilèges pour API Gateway 
+  Définissez l'AuthorizationType par défaut pour toutes les méthodes d'API sur IAM 
+  Activer le suivi X-Ray
+  Définir les variables d'environnement :
  +  `AWS_NODEJS_CONNECTION_REUSE_ENABLED`(pour les fonctions Nœud 10.x et supérieures)

### Fonction AWS Lambda
<a name="aws-lambda-function"></a>
+  Configuration du rôle IAM d'accès limité pour la fonction Lambda 
+  Activer la réutilisation des connexions avec la fonction Keep-Alive pour NodeJS Lambda 
+  Activer le suivi X-Ray

## Architecture
<a name="architecture-1"></a>

![](http://docs.aws.amazon.com/fr_fr/solutions/latest/constructs/images/aws-apigateway-lambda.png)


## GitHub
<a name="github-1"></a>


<table>
<thead>
  <tr><th colspan="2"> Pour afficher le code de ce modèle, créer/afficher les problèmes et les demandes d'extraction, et plus encore : </th></tr>
</thead>
<tbody>
  <tr><td> ![](http://docs.aws.amazon.com/fr_fr/solutions/latest/constructs/images/GitHub-Mark-32px.png) </td><td> [@aws -solutions-construction/aws-apigateway-lambda](https://github.com/awslabs/aws-solutions-constructs/tree/master/source/patterns/%40aws-solutions-constructs/aws-apigateway-lambda) </td></tr>
</tbody>
</table>