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 SAM référence
<a name="serverless-sam-reference"></a>

 Cette section contient des documents AWS SAM de référence. Cela inclut des documents de AWS SAMCLI référence, tels que des informations de référence sur AWS SAMCLI les commandes et des AWS SAMCLI informations supplémentaires, telles que des informations de configuration, de contrôle de version et de dépannage. En outre, cette section inclut des informations de référence sur la AWS SAM spécification et le AWS SAM modèle, telles que des informations de référence sur les connecteurs, les référentiels d'images et les déploiements. 

## AWS SAM spécification et AWS SAM modèle
<a name="serverless-sam-spec"></a>

La AWS SAM spécification est une spécification open source sous licence Apache 2.0. La version actuelle de la AWS SAM spécification est disponible dans le[AWS SAM modèle](sam-specification.md). AWS SAM La spécification est fournie avec une syntaxe abrégée simplifiée que vous utilisez pour définir les fonctions, les événements APIs, les configurations et les autorisations de votre application sans serveur. 

Vous interagissez avec les AWS SAM spécifications par le biais du répertoire du projet d' AWS SAM application, qui comprend les dossiers et les fichiers créés lorsque vous exécutez la **sam init** commande. Ce répertoire inclut le AWS SAM modèle, un fichier important qui définit vos AWS ressources. Le AWS SAM modèle est une extension d'un AWS CloudFormation modèle. Pour la référence complète pour les modèles CloudFormation , veuillez consulter la rubrique [Référence de modèles](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-reference.html) dans le *Guide de l'utilisateur AWS CloudFormation *.

## Référence des commandes CLI AWS SAM
<a name="serverless-sam-cli"></a>

L'interface de ligne de AWS Serverless Application Model commande (AWS SAMCLI) est un outil de ligne de commande que vous pouvez utiliser avec des AWS SAM modèles et des intégrations tierces prises en charge pour créer et exécuter vos applications sans serveur.

Vous pouvez utiliser les commandes de la CLI  AWS SAM pour développer, tester et déployer vos applications sans serveur dans le AWS Cloud. Voici quelques exemples de commandes de la CLI  AWS SAM :
+ `sam init` – Si vous utilisez la CLI  AWS SAM pour la première fois, vous pouvez exécuter la commande `sam init` sans aucun paramètre pour créer une application Hello World. La commande génère un AWS SAM modèle préconfiguré et un exemple de code d'application dans la langue de votre choix.
+ `sam local invoke` et `sam local start-api` : utilisez ces commandes pour tester le code de votre application localement, avant de le déployer sur l' AWS Cloud.
+ `sam logs` : utilisez cette commande pour récupérer les journaux générés par votre fonction Lambda. Cela peut vous aider à tester et à déboguer votre application après l'avoir déployée sur l' AWS Cloud.
+ `sam package` : utilisez cette commande pour regrouper votre code d'application et vos dépendances dans un *package de déploiement*. Le package de déploiement est nécessaire pour charger votre application dans l' AWS Cloud.
+ `sam deploy` : utilisez cette commande pour déployer votre application sans serveur sur l' AWS Cloud. Il crée les AWS ressources et définit les autorisations et les autres configurations définies dans le AWS SAM modèle.

Pour obtenir des instructions sur l'installation du AWS SAMCLI, voir[Installer la CLI  AWS SAM](install-sam-cli.md).

## Modèles de politique AWS SAM
<a name="serverless-policy-temps"></a>

Avec AWS SAM, vous pouvez choisir parmi une liste de modèles de politique pour définir les autorisations de votre AWS Lambda fonction sur les ressources utilisées par votre application. Pour obtenir la liste des modèles de politiques disponibles, reportez-vous à[Tableau de modèle de stratégie](serverless-policy-templates.md#serverless-policy-template-table). Pour obtenir des informations générales sur les modèles de politiques AWS SAM, reportez-vous à[Modèles de politique AWS SAM](serverless-policy-templates.md).

## Rubriques
<a name="reference-sam-topics"></a>
+ [AWS SAM modèle](sam-specification.md)
+ [Référence des commandes CLI AWS SAM](serverless-sam-cli-command-reference.md)
+ [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md)
+  [AWS SAM référence du connecteur](reference-sam-connector.md) 
+ [Modèles de politique AWS SAM](serverless-policy-templates.md)
+ [Référentiels d'images pour AWS SAM](serverless-image-repositories.md)
+ [Télémétrie dans la CLI  AWS SAM](serverless-sam-telemetry.md)
+ [Configuration et gestion de l'accès aux ressources dans votre AWS SAM modèle](sam-permissions.md)

# Référence des commandes CLI AWS SAM
<a name="serverless-sam-cli-command-reference"></a>

Cette section inclut des informations de référence sur AWS SAMCLI les commandes. Cela inclut des détails sur l'utilisation, une liste complète des différentes options disponibles pour chaque commande et des informations supplémentaires. Le cas échéant, les informations supplémentaires incluent des détails tels que les arguments, les variables d'environnement et les événements. Consultez chaque commande pour plus de détails. Pour obtenir des instructions sur l'installation du AWS SAMCLI, voir[Installer la CLI  AWS SAM](install-sam-cli.md).

**Topics**
+ [

# sam build
](sam-cli-command-reference-sam-build.md)
+ [

# sam delete
](sam-cli-command-reference-sam-delete.md)
+ [

# sam deploy
](sam-cli-command-reference-sam-deploy.md)
+ [

# sam init
](sam-cli-command-reference-sam-init.md)
+ [

# sam list
](sam-cli-command-reference-sam-list.md)
+ [

# sam local callback
](sam-cli-command-reference-sam-local-callback.md)
+ [

# sam local execution
](sam-cli-command-reference-sam-local-execution.md)
+ [

# sam local generate-event
](sam-cli-command-reference-sam-local-generate-event.md)
+ [

# sam local invoke
](sam-cli-command-reference-sam-local-invoke.md)
+ [

# sam local start-api
](sam-cli-command-reference-sam-local-start-api.md)
+ [

# sam local start-lambda
](sam-cli-command-reference-sam-local-start-lambda.md)
+ [

# sam logs
](sam-cli-command-reference-sam-logs.md)
+ [

# sam package
](sam-cli-command-reference-sam-package.md)
+ [

# sam pipeline bootstrap
](sam-cli-command-reference-sam-pipeline-bootstrap.md)
+ [

# sam pipeline init
](sam-cli-command-reference-sam-pipeline-init.md)
+ [

# sam publish
](sam-cli-command-reference-sam-publish.md)
+ [

# sam remote callback
](sam-cli-command-reference-sam-remote-callback.md)
+ [

# sam remote execution
](sam-cli-command-reference-sam-remote-execution.md)
+ [

# sam remote invoke
](sam-cli-command-reference-remote-invoke.md)
+ [

# sam remote test-event
](sam-cli-command-reference-remote-test-event.md)
+ [

# sam sync
](sam-cli-command-reference-sam-sync.md)
+ [

# sam traces
](sam-cli-command-reference-sam-traces.md)
+ [

# sam validate
](sam-cli-command-reference-sam-validate.md)

# sam build
<a name="sam-cli-command-reference-sam-build"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model commande Command Line Interface (AWS SAMCLI)`sam build`.
+ Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)
+ Pour obtenir de la documentation sur l'utilisation de la AWS SAMCLI `sam build` commande, consultez[Initiation à la construction avec AWS SAM](using-sam-cli-build.md).

La commande `sam build` prépare une application pour les étapes suivantes du flux de travail du développeur, telles que le test local ou le déploiement sur AWS Cloud.

## Usage
<a name="ref-sam-cli-build-usage"></a>

```
$ sam build <arguments> <options>
```

## Arguments
<a name="ref-sam-cli-build-args"></a>

**ID de ressource**  <a name="ref-sam-cli-build-args-resource-id"></a>
Facultatif. Indique AWS SAM de créer une seule ressource déclarée dans un [AWS SAM modèle](what-is-sam-overview.md#what-is-sam-template). Les artefacts de création pour la ressource spécifiée sont les seuls disponibles pour les commandes suivantes du flux de travail ; c’est-à-dire `sam package` et `sam deploy`.

## Options
<a name="ref-sam-cli-build-options"></a>

`--base-dir, -s DIRECTORY`  <a name="ref-sam-cli-build-options-base-dir"></a>
Résout les chemins relatifs au code source de la fonction ou de la couche par rapport à ce répertoire. Utilisez cette option si vous souhaitez modifier la façon dont les chemins d’accès relatifs aux dossiers de code source sont résolus. Par défaut, les chemins relatifs sont résolus selon l’emplacement du modèle AWS SAM .  
Outre les ressources de l’application racine ou de la pile que vous créez, cette option applique également des applications ou des piles imbriquées.  
Cette option s’applique aux types de ressources et propriétés suivants :  
+ Type de ressource : propriété `AWS::Serverless::Function` : `CodeUri`
+ Type de ressource : attribut de ressource `AWS::Serverless::Function` : entrée `Metadata` : `DockerContext`
+ Type de ressource : propriété `AWS::Serverless::LayerVersion` : `ContentUri`
+ Type de ressource : propriété `AWS::Lambda::Function` : `Code`
+ Type de ressource : propriété `AWS::Lambda::LayerVersion` : `Content`

`--beta-features | --no-beta-features`  <a name="ref-sam-cli-build-options-beta-features"></a>
Autorisez ou refusez les fonctionnalités bêta.

`--build-dir, -b DIRECTORY`  <a name="ref-sam-cli-build-options-build-dir"></a>
Le chemin d’accès à un répertoire dans lequel les artefacts créés sont stockés. Ce répertoire et tout son contenu sont supprimés avec cette option.

`--build-image TEXT`  <a name="ref-sam-cli-build-options-build-image"></a>
L’URI de l’image de conteneur que vous souhaitez extraire pour la création. Par défaut, AWS SAM extrait l’image de conteneur depuis Amazon ECR Public. Utilisez cette option pour extraire l’image à partir d’un autre emplacement.  
Vous pouvez spécifier cette option plusieurs fois. Chaque instance de cette option peut prendre une chaîne ou une paire valeur clé. Si vous spécifiez une chaîne, il s’agit de l’URI de l’image de conteneur à utiliser pour toutes les ressources de l’application. Par exemple, `sam build --use-container --build-image amazon/aws-sam-cli-build-image-python3.8`. Si vous spécifiez une paire valeur clé, la clé est le nom de la ressource et la valeur est l’URI de l’image de conteneur à utiliser pour cette ressource. Par exemple `sam build --use-container --build-image Function1=amazon/aws-sam-cli-build-image-python3.8`. Avec les paires valeur clé, vous pouvez spécifier différentes images de conteneur pour différentes ressources.  
Cette option ne s'applique que si l'option `--use-container` est spécifiée, dans le cas contraire, une erreur se produit.

`--build-in-source | --no-build-in-source`  <a name="ref-sam-cli-build-options-build-in-source"></a>
Procurez-vous `--build-in-source` pour créer votre projet directement dans le dossier source.  
L'option `--build-in-source` prend en charge les systèmes d’exécution ainsi que les méthodes de création suivantes :  
+ **exécutions** : toute méthode d’exécution Node.js prise en charge par l'option `sam init --runtime`.
+ **Méthodes de construction** : `Makefile`, `esbuild`.
L'option `--build-in-source` n'est pas compatible avec celles suivantes :  
+ `--hook-name`
+ `--use-container `
*Par défaut* : `--no-build-in-source`

`--cached | --no-cached`  <a name="ref-sam-cli-build-options-cached"></a>
Activez ou désactivez les créations mises en cache. Utilisez cette option pour réutiliser les artefacts de build qui n'ont pas changé par rapport aux versions précédentes. AWS SAM évalue si vous avez modifié des fichiers dans le répertoire de votre projet. Par défaut, les créations ne sont pas mises en cache. Si l'`--no-cached`option est invoquée, elle remplace le `cached = true` paramètre défini dans samconfig.toml.  
AWS SAM n’évalue pas si vous avez modifié des modules tiers dont le projet dépend, si vous n’avez pas fourni de version spécifique. Par exemple, si votre fonction Python inclut un `requirements.txt` fichier contenant l'entrée `requests=1.x` et que la dernière version du module de requête passe de `1.1` à`1.2`, AWS SAM elle n'extrait pas la dernière version tant que vous n'avez pas exécuté une version non mise en cache.

`--cache-dir`  <a name="ref-sam-cli-build-options-cached-dir"></a>
Le répertoire dans lequel les artefacts mis en cache sont stockés lorsque `--cached` est spécifié. Le répertoire mis en caché par défaut est `.aws-sam/cache`.

`--config-env TEXT`  <a name="ref-sam-cli-build-options-config-env"></a>
Le nom d’environnement spécifiant les valeurs de paramètre par défaut dans le fichier de configuration à utiliser. La valeur par défaut est « par défaut ». Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-build-options-config-file"></a>
Le chemin d’accès et le nom du fichier de configuration contenant les valeurs de paramètres par défaut à utiliser. La valeur par défaut est « `samconfig.toml` » dans la racine du répertoire du projet. Pour plus d’informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--container-env-var, -e TEXT`  <a name="ref-sam-cli-build-options-container-env-var"></a>
Variables d’environnement à transmettre au conteneur de création. Vous pouvez spécifier cette option plusieurs fois. Chaque instance de cette option prend une paire clé-valeur, où la clé est la variable de ressource et d’environnement et la valeur est la valeur de la variable d’environnement. Par exemple : `--container-env-var Function1.GITHUB_TOKEN=TOKEN1 --container-env-var Function2.GITHUB_TOKEN=TOKEN2`.  
Cette option ne s’applique que si l’option `--use-container` est spécifiée, dans le cas contraire, une erreur se produit.

`--container-env-var-file, -ef PATH`  <a name="ref-sam-cli-build-options-container-env-var-file"></a>
Le chemin d’accès et le nom d’un fichier JSON contenant les valeurs des variables d’environnement de conteneur. Pour plus d’informations sur les fichier des variables d’environnement de conteneur, consultez [Fichier de variables d'environnement du conteneur.](serverless-sam-cli-using-build.md#serverless-sam-cli-using-container-environment-file).  
Cette option ne s'applique que si l'option `--use-container` est spécifiée, dans le cas contraire, une erreur se produit.

`--debug`  <a name="ref-sam-cli-build-options-debug"></a>
Active la journalisation de débogage pour imprimer les messages de débogage générés par la CLI  AWS SAM et pour afficher les horodatages.

`--docker-network TEXT`  <a name="ref-sam-cli-build-options-docker-network"></a>
Spécifie le nom ou l’identifiant d’un réseau Docker existant auquel les conteneurs Docker Lambda doivent se connecter, avec le réseau de pont par défaut. Si cela n’est pas spécifié, les conteneurs Lambda se connectent uniquement au réseau Docker de pont par défaut.

`--exclude, -x`  <a name="ref-sam-cli-build-options-exclude"></a>
Le nom de la ou des ressource(s) à exclure de `sam build`. Par exemple, si votre modèle contient `Function1`, `Function2` et `Function3` et vous exécutez `sam build --exclude Function2`, uniquement `Function1` et `Function3` seront créés.

`--help`  <a name="ref-sam-cli-build-options-help"></a>
Affiche ce message, puis se ferme.

`--hook-name TEXT`  <a name="ref-sam-cli-build-options-hook-name"></a>
Nom du hook utilisé pour étendre la fonctionnalité de la CLI  AWS SAM.  
Valeurs acceptées : `terraform`.

`--manifest , -m PATH`  <a name="ref-sam-cli-build-options-manifest"></a>
Le chemin d’accès à un fichier manifeste de dépendance personnalisé (par exemple, package.json) à utiliser à la place du fichier par défaut.

`--mount-symlinks`  <a name="ref-sam-cli-build-options-mount-symlinks"></a>
Garantit le AWS SAMCLI montage permanent des liens symboliques présents dans les fichiers à créer ou à invoquer. Cela s'applique uniquement aux liens symboliques du répertoire de niveau supérieur (c'est-à-dire aux liens symboliques situés directement à la racine de la fonction). Par défaut, les liens symboliques ne sont pas montés, à l'exception de ceux nécessaires pour être utilisés `node_modules` dans `build-in-source` NodeJS.

`--no-use-container`  <a name="ref-sam-cli-build-options-no-use-container"></a>
Option qui vous permet d'utiliser le kit d'outils IDE pour définir le comportement par défaut. Vous pouvez également l'utiliser `sam build --no-use-container` pour exécuter un build sur votre machine locale au lieu d'un conteneur docker.

`--parallel`  <a name="ref-sam-cli-build-options-parallel"></a>
Active les builds parallèles. Utilisez cette option pour créer les fonctions et les couches de votre AWS SAM modèle en parallèle. Par défaut, les fonctions et les couches sont créées en séquence.

`--parameter-overrides`  <a name="ref-sam-cli-build-options-parameter-overrides"></a>
(Facultatif) Chaîne contenant des remplacements de CloudFormation paramètres codés sous forme de paires clé-valeur. Utilise le même format que le AWS Command Line Interface (AWS CLI). Par exemple : « `ParameterKey`=`KeyPairName`, `ParameterValue`=`MyKey` `ParameterKey`=`InstanceType`, `ParameterValue`=`t1.micro` ». Cette option n'est pas compatible avec `--hook-name`.

`--profile TEXT`  <a name="ref-sam-cli-build-options-profile"></a>
Le profil spécifique de votre fichier d'informations d'identification qui obtient les AWS informations d'identification.

`--region TEXT`  <a name="ref-sam-cli-build-options-region"></a>
Le Région AWS vers lequel déployer. Par exemple, us-east-1.

`--save-params`  <a name="ref-sam-cli-build-options-save-params"></a>
Enregistrez les paramètres que vous fournissez sur la ligne de commande dans le fichier AWS SAM de configuration.

`--skip-prepare-infra`  <a name="ref-sam-cli-build-options-skip-prepare-infra"></a>
Ignore l'étape de préparation si aucune modification d'infrastructure n'a été apportée. À utiliser avec l'option `--hook-name`.

`--skip-pull-image`  <a name="ref-sam-cli-build-options-skip-pull-image"></a>
Spécifie si la commande doit ignorer la dernière image Docker pour l’exécution Lambda.

`--template-file, --template, -t PATH`  <a name="ref-sam-cli-build-options-template-file"></a>
Le chemin et le nom du fichier AWS SAM modèle`[default: template.[yaml|yml]]`. Cette option n'est pas compatible avec `--hook-name`.

`--terraform-project-root-path`  <a name="ref-sam-cli-build-options-terraform-project-root-path"></a>
Le chemin relatif ou absolu vers le répertoire de premier niveau contenant vos fichiers de configuration Terraform ou le code source de vos fonctions. Si ces fichiers se trouvent en dehors du répertoire contenant votre module racine Terraform, utilisez cette option pour spécifier son chemin absolu ou relatif. Cette option nécessite que `--hook-name` soit défini sur `terraform`.

`--use-container`, `-u`  <a name="ref-sam-cli-build-options-use-container"></a>
Si les fonctions dépendent de packages avec des dépendances compilées nativement, utilisez cette option pour créer la fonction dans un conteneur Docker de type Lambda.

## Exemple
<a name="sam-cli-command-reference-sam-build-examples"></a>

Pour un exemple détaillé et une présentation détaillée de l'utilisation de la `sam build` sous-commande, reportez-vous à. [Initiation à la construction avec AWS SAM](using-sam-cli-build.md)

# sam delete
<a name="sam-cli-command-reference-sam-delete"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model commande Command Line Interface (AWS SAMCLI)`sam delete`.

Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)

La `sam delete` commande supprime une AWS SAM application en supprimant la CloudFormation pile, les artefacts empaquetés et déployés sur Amazon S3 et Amazon ECR, ainsi que le AWS SAM fichier modèle.

Cette commande vérifie également si une pile complémentaire Amazon ECR est déployée et, dans l'affirmative, invite l'utilisateur à supprimer cette pile et les référentiels Amazon ECR. Si `--no-prompts` est spécifié, alors les piles compagnons et les répertoires Amazon ECR sont supprimés par défaut.

## Usage
<a name="sam-cli-command-reference-sam-delete-usage"></a>

```
$ sam delete <options>
```

## Options
<a name="sam-cli-command-reference-sam-delete-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-delete-options-config-env"></a>
Le nom d'environnement spécifiant les valeurs de paramètre par défaut dans le fichier de configuration à utiliser. La valeur par défaut est `default`. Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-delete-options-config-file"></a>
Le chemin d'accès et le nom du fichier de configuration contenant les valeurs de paramètres par défaut à utiliser. La valeur par défaut est `samconfig.toml` à la racine du répertoire du projet. Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-delete-options-debug"></a>
Active la journalisation de débogage pour imprimer le message de débogage généré par la CLI  AWS SAM et pour afficher les horodatages.

`--help`  <a name="sam-cli-command-reference-sam-delete-options-help"></a>
Affiche ce message, puis se ferme.

`--no-prompts`  <a name="sam-cli-command-reference-sam-delete-options-no-prompts"></a>
Spécifiez cette option pour AWS SAM fonctionner en mode non interactif. Le nom de la pile doit être fourni, soit avec l’option `--stack-name`, soit dans le fichier de configuration `toml`.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-delete-options-profile"></a>
Le profil spécifique de votre fichier d'informations d'identification qui obtient les AWS informations d'identification.

`--region TEXT`  <a name="sam-cli-command-reference-sam-delete-options-region"></a>
La AWS région dans laquelle le déploiement doit être effectué. Par exemple, us-east-1.

`--s3-bucket`  <a name="sam-cli-command-reference-sam-delete-options-s3-bucket"></a>
Le chemin du compartiment Amazon S3 que vous voulez supprimer.

`--s3-prefix`  <a name="sam-cli-command-reference-sam-delete-options-s3-prefix"></a>
Le préfixe du compartiment Amazon S3 que vous voulez supprimer.

`--save-params`  <a name="sam-cli-command-reference-sam-delete-options-save-params"></a>
Enregistrez les paramètres que vous fournissez sur la ligne de commande dans le fichier AWS SAM de configuration.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-delete-options-stack-name"></a>
Nom de la CloudFormation pile que vous souhaitez supprimer.

## Exemples
<a name="sam-cli-command-reference-sam-delete-examples"></a>

La commande suivante supprime la pile`MY-STACK`. 

```
$ sam delete --stack-name MY-STACK
```

La commande suivante supprime la pile `MY-STACK` et le compartiment `sam-s3-demo-bucket` S3 :

```
$ sam delete \
    --stack-name MyStack \
    --s3-bucket MySAMBucket
```

# sam deploy
<a name="sam-cli-command-reference-sam-deploy"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model commande Command Line Interface (AWS SAMCLI)`sam deploy`.
+ Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)
+ Pour obtenir de la documentation sur l'utilisation de la AWS SAMCLI `sam deploy` commande, consultez[Présentation du déploiement avec AWS SAM](using-sam-cli-deploy.md).

La `sam deploy` commande déploie une application auprès de l'utilisateur AWS Cloud . AWS CloudFormation

## Usage
<a name="ref-sam-cli-deploy-usage"></a>

```
$ <environment variables> sam deploy <options>
```

## Variables d’environnement
<a name="ref-sam-cli-deploy-env"></a>

`SAM_CLI_POLL_DELAY`  <a name="ref-sam-cli-deploy-env-sam-cli-poll-delay"></a>
Définissez la variable d'`SAM_CLI_POLL_DELAY`environnement avec une valeur de secondes dans votre shell pour configurer la fréquence à laquelle la CLI AWS SAM vérifie l'état de la CloudFormation pile, ce qui est utile lorsque vous constatez une limitation provenant de. CloudFormation Cette variable d'environnement est utilisée pour interroger les appels `describe_stack` d'API, qui sont effectués pendant l'exécution`sam deploy`.   
Voici un exemple de cette variable :  

```
$ SAM_CLI_POLL_DELAY=5 sam deploy
```

## Options
<a name="ref-sam-cli-deploy-options"></a>

`--capabilities LIST`  <a name="ref-sam-cli-deploy-options-capabilities"></a>
Liste des fonctionnalités que vous devez spécifier pour autoriser la création CloudFormation de certaines piles. Certains modèles de pile peuvent inclure des ressources qui affectent les autorisations de votre compte Compte AWS, par exemple en créant de nouveaux utilisateurs Gestion des identités et des accès AWS (IAM). Pour ces piles, vous devez explicitement reconnaître leurs capacités en spécifiant cette option. Les seules valeurs valides sont `CAPABILITY_IAM` et `CAPABILITY_NAMED_IAM`. Si vous disposez de ressources IAM, vous pouvez spécifier l'une ou l'autre de ces capacités. Si vous disposez de ressources IAM avec des noms personnalisés, vous devez spécifier `CAPABILITY_NAMED_IAM`. Si vous ne spécifiez pas cette option, l'opération renvoie une erreur `InsufficientCapabilities`.  
Lorsque vous déployez une application contenant des applications imbriquées, vous devez utiliser `CAPABILITY_AUTO_EXPAND` pour confirmer que l'application contient des applications imbriquées. Pour de plus amples informations, veuillez consulter [Déploiement d'applications imbriquées](serverless-sam-template-nested-applications.md#serverless-sam-templates-nested-applications-deploying).

`--config-env TEXT`  <a name="ref-sam-cli-deploy-options-config-env"></a>
Le nom d'environnement spécifiant les valeurs de paramètre par défaut dans le fichier de configuration à utiliser. La valeur par défaut est `default`. Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-deploy-options-config-file"></a>
Le chemin d'accès et le nom du fichier de configuration contenant les valeurs de paramètres par défaut à utiliser. La valeur par défaut est `samconfig.toml` à la racine du répertoire du projet. Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--confirm-changeset | --no-confirm-changeset`  <a name="ref-sam-cli-deploy-options-confirm-changeset"></a>
Invite à confirmer si la CLI  AWS SAM déploie le jeu de modifications calculé.

`--debug`  <a name="ref-sam-cli-deploy-options-debug"></a>
Activez la journalisation de débogage pour imprimer le message de débogage généré par la CLI  AWS SAM et pour afficher les horodatages.

`--disable-rollback | --no-disable-rollback`  <a name="ref-sam-cli-deploy-options-disable-rollback"></a>
Spécifiez si vous souhaitez annuler votre CloudFormation pile en cas d'erreur lors d'un déploiement. Par défaut, en cas d'erreur lors d'un déploiement, votre CloudFormation pile revient à son dernier état stable. Si vous spécifiez `--disable-rollback` et une erreur se produit pendant un déploiement, les ressources créées ou mises à jour avant l'erreur ne sont pas restaurées.

`--fail-on-empty-changeset | --no-fail-on-empty-changeset`  <a name="ref-sam-cli-deploy-options-fail-on-empty-changeset"></a>
Indiquez s'il faut renvoyer un code de sortie différent de zéro s'il n'existe aucune modification à apporter à la pile. Le comportement par défaut consiste à renvoyer un code de sortie autre que zéro.

`--force-upload`  <a name="ref-sam-cli-deploy-options-force-upload"></a>
Spécifiez cette option pour télécharger des artefacts, même s’ils correspondent à des artefacts existants dans le compartiment Amazon S3. Les artefacts correspondants sont remplacés.

`--guided, -g`  <a name="ref-sam-cli-deploy-options-guided"></a>
Spécifiez cette option pour que la CLI  AWS SAM utilise des invites pour vous guider tout au long du déploiement.

`--help`  <a name="ref-sam-cli-deploy-options-help"></a>
Affichez ce message et quittez.

`--image-repositories TEXT`  <a name="ref-sam-cli-deploy-options-image-repositories"></a>
Un mappage des fonctions vers l'URI de leur référentiel Amazon ECR. Référencez les fonctions par leur identifiant logique. Voici un exemple :  

```
$ sam deploy --image-repositories Function1=123456789012.dkr.ecr.us-east-1.amazonaws.com/my-repo
```
Vous pouvez spécifier cette option plusieurs fois au sein d'une même commande.

`--image-repository TEXT`  <a name="ref-sam-cli-deploy-options-image-repository"></a>
Le nom du référentiel Amazon ECR vers lequel cette commande charge l'image de la fonction. Cette option est requise pour les fonctions déclarées avec le type de package `Image`.

`--kms-key-id TEXT`  <a name="ref-sam-cli-deploy-options-kms-key-id"></a>
L'ID d'une clé AWS Key Management Service (AWS KMS) utilisée pour chiffrer les artefacts inactifs dans le compartiment Amazon S3. Si vous ne spécifiez pas cette option, AWS SAM utilise les clés de chiffrement gérées par Amazon S3.

`--metadata`  <a name="ref-sam-cli-deploy-options-metadata"></a>
Une carte de métadonnées à attacher à tous les artefacts référencés dans le modèle.

`--no-execute-changeset`  <a name="ref-sam-cli-deploy-options-no-execute-changeset"></a>
Indique s'il faut appliquer le jeu de modifications. Spécifiez cette option si vous voulez afficher les modifications de la pile avant d'appliquer le jeu de modifications. Cette commande crée un jeu de modifications CloudFormation puis se termine sans appliquer le jeu de modifications. Pour appliquer le jeu de modifications, exécutez la même commande sans cette option.

`--no-progressbar`  <a name="ref-sam-cli-deploy-options-no-progressbar"></a>
N’affichez pas de barre de progression lors du téléchargement d’artefacts sur Amazon S3.

`--notification-arns LIST`  <a name="ref-sam-cli-deploy-options-notification-arns"></a>
Liste des rubriques Amazon Simple Notification Service (Amazon SNS) ARNs associées à la CloudFormation pile.

`--on-failure [ROLLBACK | DELETE | DO_NOTHING]`  <a name="ref-sam-cli-deploy-options-on-failure"></a>
Spécifiez l'action à entreprendre lorsqu'une pile ne peut pas être créée.  
Les options suivantes sont disponibles :  
+ `ROLLBACK` – Récupère la pile à un état antérieur connu et valide.
+ `DELETE` – Récupère la pile à un état antérieur connu et valide, s'il en existe un. Sinon, supprime la pile.
+ `DO_NOTHING` – Ne récupère ni ne supprime la pile. L'effet est le même que celui de `--disable-rollback`.
Le comportement par défaut est `ROLLBACK`.  
Vous pouvez spécifier l'`--disable-rollback`option ou l'`--on-failure`option, mais pas les deux.

`--parameter-overrides LIST`  <a name="ref-sam-cli-deploy-options-parameter-overrides"></a>
Chaîne contenant des remplacements de CloudFormation paramètres codés sous forme de paires clé-valeur. Chaque remplacement utilise le format. `ParameterKey=name,ParameterValue=value` Les remplacements multiples sont séparés par des espaces. Voici deux exemples :  

```
$ sam deploy --parameter-overrides ParameterKey=value1,ParameterValue=value2
```

```
$ sam deploy --parameter-overrides ParameterKey=value1,ParameterValue=value2 ParameterKey=hello,ParameterValue=world ParameterKey=apple,ParameterValue=banana
```

`--profile TEXT`  <a name="ref-sam-cli-deploy-options-profile"></a>
Le profil spécifique de votre fichier d'informations d'identification qui obtient les AWS informations d'identification.

`--region TEXT`  <a name="ref-sam-cli-deploy-options-region"></a>
Le Région AWS vers lequel déployer. Par exemple, us-east-1.

`--resolve-image-repos`  <a name="ref-sam-cli-deploy-options-resolve-image-repos"></a>
Créez automatiquement des référentiels Amazon ECR à utiliser pour l’empaquetage et le déploiement de déploiements non guidés. Cette option s’applique uniquement aux fonctions et aux couches avec un `PackageType: Image` spécifié. Si vous spécifiez l'option `--guided`, la CLI  AWS SAM ignore `--resolve-image-repos`.  
Si vous créez AWS SAM automatiquement des référentiels Amazon ECR pour des fonctions ou des couches avec cette option, et que vous supprimez ultérieurement ces fonctions ou couches de votre AWS SAM modèle, les référentiels Amazon ECR correspondants sont automatiquement supprimés.

`--resolve-s3`  <a name="ref-sam-cli-deploy-options-resolve-s3"></a>
Créez automatiquement un compartiment Amazon S3 à utiliser pour l’empaquetage et le déploiement de déploiements non guidés. Si vous spécifiez l'option `--guided`, l'interface CLI AWS SAM ignore `--resolve-s3`. Si vous spécifiez les deux options `--s3-bucket` et `--resolve-s3`, une erreur se produit.

`--role-arn TEXT`  <a name="ref-sam-cli-deploy-options-role-arn"></a>
Nom de ressource Amazon (ARN) d'un rôle IAM CloudFormation assumé lors de l'application de l'ensemble de modifications.

`--s3-bucket TEXT`  <a name="ref-sam-cli-deploy-options-s3-bucket"></a>
Le nom du compartiment Amazon S3 dans lequel cette commande télécharge votre CloudFormation modèle. Si le modèle a une taille supérieure à 51 200 octets, l'option `--s3-bucket` ou l'option `--resolve-s3` est obligatoire. Si vous spécifiez les deux options `--s3-bucket` et `--resolve-s3`, une erreur se produit.

`--s3-prefix TEXT`  <a name="ref-sam-cli-deploy-options-s3-prefix"></a>
Le préfixe ajouté aux noms des artefacts téléchargés vers le compartiment Amazon S3. Le nom du préfixe est un nom de chemin d'accès (nom de dossier) pour le compartiment Amazon S3.

`--save-params`  <a name="ref-sam-cli-deploy-options-save-params"></a>
Enregistrez les paramètres que vous fournissez sur la ligne de commande dans le fichier AWS SAM de configuration.

`--signing-profiles LIST`  <a name="ref-sam-cli-deploy-options-signing-profiles"></a>
Liste des profils de signature pour signer les packages de déploiement. Cette option prend une liste de paires valeur clé, où la clé est le nom de la fonction ou de la couche à signer et la valeur est le profil de signature, avec un propriétaire de profil optionnel délimité par `:`. Par exemple, `FunctionNameToSign=SigningProfileName1 LayerNameToSign=SigningProfileName2:SigningProfileOwner`.

`--stack-name TEXT`  <a name="ref-sam-cli-deploy-options-stack-name"></a>
(Obligatoire) Le nom de la CloudFormation pile sur laquelle vous effectuez le déploiement. Si vous spécifiez une pile existante, la commande met à jour la pile. Si vous spécifiez une nouvelle pile, celle-ci est créée par la commande.

`--tags LIST`  <a name="ref-sam-cli-deploy-options-tags"></a>
Liste de balises à associer à la pile créée ou mise à jour. CloudFormation propage également ces balises aux ressources de la pile qui les supportent.

`--template-file, --template, -t PATH`  <a name="ref-sam-cli-deploy-options-template-file"></a>
Le chemin et le nom du fichier où se trouve votre AWS SAM modèle.  
Si vous spécifiez cette option, AWS SAM déploie uniquement le modèle et les ressources locales vers lesquels il pointe.

`--use-json`  <a name="ref-sam-cli-deploy-options-use-json"></a>
Sortie JSON pour le CloudFormation modèle. La sortie par défaut est YAML.

## Exemple
<a name="sam-cli-command-reference-sam-deploy-examples"></a>

Pour un exemple détaillé et une présentation détaillée de l'utilisation de la `sam deploy` sous-commande, reportez-vous à. [Présentation du déploiement avec AWS SAM](using-sam-cli-deploy.md)

# sam init
<a name="sam-cli-command-reference-sam-init"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model commande Command Line Interface (AWS SAMCLI)`sam init`.
+ Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)
+ Pour obtenir de la documentation sur l'utilisation de la AWS SAMCLI `sam init` commande, consultez[Créez votre application dans AWS SAM](using-sam-cli-init.md).

La commande `sam init` fournit des options pour initialiser une nouvelle application sans serveur.

## Usage
<a name="sam-cli-command-reference-sam-init-usage"></a>

```
$ sam init <options>
```

## Options
<a name="sam-cli-command-reference-sam-init-options"></a>

`--app-template TEXT`  <a name="sam-cli-command-reference-sam-init-options-app-template"></a>
L’identificateur du modèle d’application gérée que vous souhaitez utiliser. En cas de doute, appelez `sam init` sans options pour un flux interactif.  
Ce paramètre est obligatoire si `--no-interactive` est spécifié et que `--location` n'est pas fourni.  
Ce paramètre est uniquement disponible dans la version 0.30.0 et ultérieures de la CLI  AWS SAM. La spécification de ce paramètre avec une version antérieure une erreur se produit.

`--application-insights | --no-application-insights`  <a name="sam-cli-command-reference-sam-init-options-application-insights"></a>
 Activez la surveillance Amazon CloudWatch Application Insights pour votre application. Pour en savoir plus, veuillez consulter la section [Utilisation d' CloudWatch Application Insights pour surveiller vos applications AWS SAM sans serveur](monitor-app-insights.md).   
 L'option par défaut est `--no-application-insights`. 

`--architecture, -a [ x86_64 | arm64 ]`  <a name="sam-cli-command-reference-sam-init-options-architecture"></a>
Architecture du jeu d’instructions pour les fonctions Lambda de l’application. Spécifiez l’un des `x86_64` ou `arm64`.

`--base-image [ amazon/dotnet8-base | amazon/dotnet6-base | amazon/java25-base | amazon/java21-base | amazon/java17-base | amazon/java11-base | amazon/nodejs24.x-base | amazon/nodejs22.x-base | amazon/nodejs20.x-base | amazon/nodejs18.x-base | amazon/nodejs16.x-base | amazon/python3.14-base | amazon/python3.13-base | amazon/python3.12-base | amazon/python3.11-base | amazon/python3.10-base | amazon/python3.9-base | amazon/python3.8-base | amazon/ruby3.4-base | amazon/ruby3.3-base | amazon/ruby3.2-base ]`  <a name="sam-cli-command-reference-sam-init-options-base-image"></a>
L’image de base de l’application. Cette option s'applique uniquement lorsque le type de package est `Image`.  
Ce paramètre est obligatoire si `--no-interactive` est spécifié, `--package-type` est spécifié comme `Image` et `--location` n’est pas spécifié.

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-init-options-config-env"></a>
Le nom d’environnement spécifiant les valeurs de paramètre par défaut dans le fichier de configuration à utiliser. La valeur par défaut est « par défaut ». Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-init-options-config-file"></a>
Le chemin d'accès et le nom du fichier de configuration contenant les valeurs de paramètres par défaut à utiliser. La valeur par défaut est « samconfig.toml » dans la racine du répertoire du projet. Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-init-options-debug"></a>
Active la journalisation de débogage pour imprimer les messages de débogage générés par la CLI  AWS SAM et pour afficher les horodatages.

`--dependency-manager, -d [ gradle | mod | maven | bundler | npm | cli-package | pip ]`  <a name="sam-cli-command-reference-sam-init-options-dependency-manager"></a>
Le gestionnaire de dépendances de l’exécution Lambda.

`--extra-content`  <a name="sam-cli-command-reference-sam-init-options-extra-content"></a>
Remplacez tous les paramètres personnalisés dans la configuration du modèle `cookiecutter.json`, par exemple, `{"customParam1": "customValue1", "customParam2":"customValue2"}`

`--help, -h`  <a name="sam-cli-command-reference-sam-init-options-help"></a>
Affiche ce message, puis se ferme.

`--location, -l TEXT`  <a name="sam-cli-command-reference-sam-init-options-location"></a>
Le modèle ou l’emplacement de l’application (Git, Mercurial, HTTP/HTTPS, fichier .zip, chemin d’accès).  
Ce paramètre est obligatoire si `--no-interactive` est spécifié et `--runtime`, `--name` et `--app-template` ne sont pas fournis.  
Pour les référentiels Git, vous devez utiliser l’emplacement de la racine du référentiel.  
Pour les chemins d’accès locaux, le modèle doit être dans un fichier .zip ou en format [Cookiecutter](https://cookiecutter.readthedocs.io/en/latest/README.html).

`--name, -n TEXT`  <a name="sam-cli-command-reference-sam-init-options-name"></a>
Le nom du projet à générer en tant que répertoire.  
Ce paramètre est obligatoire si `--no-interactive` est spécifié et `--location` n’est pas fourni.

`--no-input`  <a name="sam-cli-command-reference-sam-init-options-no-input"></a>
Désactive l’invite Cookiecutter et accepte les valeurs vcfdefault définies dans la configuration du modèle.

`--no-interactive`  <a name="sam-cli-command-reference-sam-init-options-no-interactive"></a>
Désactivez l’invite interactive pour les paramètres de démarrage et attendez si des valeurs requises sont manquantes.

`--output-dir, -o PATH`  <a name="sam-cli-command-reference-sam-init-options-output-dir"></a>
L’emplacement où l’application initialisée est sortie.

`--package-type [ Zip | Image ]`  <a name="sam-cli-command-reference-sam-init-options-package-type"></a>
Le type de package de l’exemple d’application. `Zip` crée une archive de fichiers .zip, puis `Image` crée une image de conteneur.

`--runtime, -r [ dotnet8 | dotnet6 | java25 | java21 | java17 | java11 | nodejs24.x | nodejs22.x | nodejs20.x | nodejs18.x | nodejs16.x | python3.14 | python3.13 | python3.12 | python3.11 | python3.10 | python3.9 | python3.8 | ruby3.4 | ruby3.3 | ruby3.2 ]`  <a name="sam-cli-command-reference-sam-init-options-runtime"></a>
L’exécution Lambda de l’application. Cette option s’applique uniquement lorsque le type de package est `Zip`.  
Ce paramètre est obligatoire si `--no-interactive` est spécifié, `--package-type` est spécifié comme `Zip` et `--location` n’est pas spécifié.

`--save-params`  <a name="sam-cli-command-reference-sam-init-options-save-params"></a>
Enregistrez les paramètres que vous fournissez sur la ligne de commande dans le fichier AWS SAM de configuration.

`--tracing | --no-tracing`  <a name="sam-cli-command-reference-sam-init-options-tracing"></a>
Activez le AWS X-Ray suivi pour vos fonctions Lambda.

## Exemple
<a name="sam-cli-command-reference-sam-init-examples"></a>

Pour un exemple détaillé et une présentation détaillée de l'utilisation de la `sam init` sous-commande, reportez-vous à. [Créez votre application dans AWS SAM](using-sam-cli-init.md)

# sam list
<a name="sam-cli-command-reference-sam-list"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model commande Command Line Interface (AWS SAMCLI)`sam list`.

Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)

La `sam list` commande génère des informations importantes sur les ressources de votre application sans serveur et sur son état. Utiliser **sam list** avant et après le déploiement pour faciliter le développement local et dans le cloud.

## Usage
<a name="sam-cli-command-reference-sam-list-usage"></a>

```
$ sam list <options> <subcommand>
```

## Options
<a name="sam-cli-command-reference-sam-list-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-sam-list-options-help"></a>
Affichez ce message et quittez.

## Sous-commandes
<a name="sam-cli-command-reference-sam-list-subcommands"></a>

`endpoints`  <a name="sam-cli-command-reference-sam-list-subcommands-endpoints"></a>
Affiche la liste des points de terminaison cloud et locaux de votre CloudFormation stack. Pour de plus amples informations, veuillez consulter [sam list endpoints](sam-cli-command-reference-sam-list-endpoints.md).

`resources`  <a name="sam-cli-command-reference-sam-list-subcommands-resources"></a>
Affiche les ressources de votre modèle AWS Serverless Application Model (AWS SAM) créées AWS CloudFormation lors du déploiement. Pour de plus amples informations, veuillez consulter [sam list resources](sam-cli-command-reference-sam-list-resources.md).

`stack-outputs`  <a name="sam-cli-command-reference-sam-list-subcommands-stack-outputs"></a>
Affiche les sorties de votre CloudFormation pile à partir d'un CloudFormation modèle AWS SAM or. Pour de plus amples informations, veuillez consulter [sam list stack-outputs](sam-cli-command-reference-sam-list-stack-outputs.md).

# sam list endpoints
<a name="sam-cli-command-reference-sam-list-endpoints"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model `sam list endpoints` sous-commande Command Line Interface (AWS SAMCLI).

Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)

La `sam list endpoints` sous-commande affiche une liste des points de terminaison cloud et locaux de votre CloudFormation stack. Vous pouvez interagir avec ces ressources à l'aide des commandes **sam local** et **sam sync**.

AWS Lambda et les types de ressources Amazon API Gateway sont pris en charge par cette commande.

**Note**  
Les domaines personnalisés sont pris en charge lorsqu'ils sont configurés pour vos ressources Amazon API Gateway. Cette commande affichera le domaine personnalisé au lieu du point de terminaison par défaut.

## Usage
<a name="sam-cli-command-reference-sam-list-endpoints-usage"></a>

```
$ sam list endpoints <options>
```

## Options
<a name="sam-cli-command-reference-sam-list-endpoints-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-config-env"></a>
Le nom d’environnement spécifiant les valeurs de paramètre par défaut dans le fichier de configuration à utiliser.  
*Valeur par défaut* : `default`  
Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--config-file TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-config-file"></a>
Le chemin d’accès et le nom du fichier de configuration contenant les valeurs de paramètres par défaut à utiliser.  
*Valeur par défaut* : `samconfig.toml` dans le répertoire de travail actuel.  
Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-list-endpoints-options-debug"></a>
Active la journalisation de débogage pour imprimer le message de débogage généré par la CLI  AWS SAM avec les horodatages.

`--help, -h`  <a name="sam-cli-command-reference-sam-list-endpoints-options-help"></a>
Affichez ce message et quittez.

`--output [json|table]`  <a name="sam-cli-command-reference-sam-list-endpoints-options-output"></a>
Spécifiez le format de sortie des résultats.  
*Valeur par défaut* : `table`

`--profile TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-profile"></a>
Sélectionnez un profil spécifique dans votre fichier d'informations d'identification pour obtenir des AWS informations d'identification.

`--region TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-region"></a>
Définissez la AWS région du service. Par exemple, `us-east-1`.

`--save-params`  <a name="sam-cli-command-reference-sam-list-endpoints-options-save-params"></a>
Enregistrez les paramètres que vous fournissez sur la ligne de commande dans le fichier AWS SAM de configuration.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-stack-name"></a>
Nom de la CloudFormation pile déployée. Le nom de la pile se trouve dans le fichier `samconfig.toml` de votre application ou dans le fichier de configuration désigné.  
Lorsque cette option n'est pas spécifiée, les ressources locales définies dans votre modèle s'affichent.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-list-endpoints-options-template"></a>
AWS SAM fichier modèle.  
*Valeur par défaut* : `template.[yaml|yml|json]`

## Exemples
<a name="sam-cli-command-reference-sam-list-endpoints-examples"></a>

Affichez une sortie, au format json, des points de terminaison des ressources déployées à partir de votre CloudFormation pile nommée`test-stack`.

```
$ sam list endpoints --stack-name test-stack --output json
			
[
  {
    "LogicalResourceId": "HelloWorldFunction",
    "PhysicalResourceId": "sam-app-test-list-HelloWorldFunction-H85Y7yIV7ZLq",
    "CloudEndpoint": "https://zt55oi7kbljxjmcoahsj3cknwu0rposq.lambda-url.us-east-1.on.aws/",
    "Methods": "-"
  },
  {
    "LogicalResourceId": "ServerlessRestApi",
    "PhysicalResourceId": "uj80uoe2o2",
    "CloudEndpoint": [
      "https://uj80uoe2o2.execute-api.us-east-1.amazonaws.com/Prod",
      "https://uj80uoe2o2.execute-api.us-east-1.amazonaws.com/Stage"
    ],
    "Methods": [
      "/hello['get']"
    ]
  }
]
```

# sam list resources
<a name="sam-cli-command-reference-sam-list-resources"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model `sam list resources` sous-commande Command Line Interface (AWS SAMCLI).

Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)

La `sam list resources` sous-commande affiche les ressources de votre modèle AWS Serverless Application Model (AWS SAM) créées AWS CloudFormation par la AWS SAM transformation lors du déploiement.

**sam list resources**À utiliser avec un AWS SAM modèle avant le déploiement pour voir les ressources qui seront créées. Entrez un nom de CloudFormation pile pour afficher une liste consolidée incluant les ressources déployées.

**Note**  
Pour générer une liste de ressources à partir de votre AWS SAM modèle, une transformation locale de votre modèle est effectuée. Les ressources qui seront déployées sous certaines conditions, par exemple dans une région spécifique, sont incluses dans cette liste.

## Usage
<a name="sam-cli-command-reference-sam-list-resources-usage"></a>

```
$ sam list resources <options>
```

## Options
<a name="sam-cli-command-reference-sam-list-resources-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-config-env"></a>
Le nom d’environnement spécifiant les valeurs de paramètre par défaut dans le fichier de configuration à utiliser.  
*Valeur par défaut* : `default`  
Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--config-file TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-config-file"></a>
Le chemin d’accès et le nom du fichier de configuration contenant les valeurs de paramètres par défaut à utiliser.  
*Valeur par défaut* : `samconfig.toml` dans le répertoire de travail actuel.  
Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-list-resources-options-debug"></a>
Active la journalisation de débogage pour imprimer le message de débogage généré par la CLI  AWS SAM avec les horodatages.

`--help, -h`  <a name="sam-cli-command-reference-sam-list-resources-options-help"></a>
Affichez ce message et quittez.

`--output [json|table]`  <a name="sam-cli-command-reference-sam-list-resources-options-output"></a>
Spécifiez le format de sortie des résultats.  
*Valeur par défaut* : `table`

`--profile TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-profile"></a>
Sélectionnez un profil spécifique dans votre fichier d'informations d'identification pour obtenir des AWS informations d'identification.

`--region TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-region"></a>
Définissez la AWS région du service. Par exemple, `us-east-1`.

`--save-params`  <a name="sam-cli-command-reference-sam-list-resources-options-save-params"></a>
Enregistrez les paramètres que vous fournissez sur la ligne de commande dans le fichier AWS SAM de configuration.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-stack-name"></a>
Nom de la CloudFormation pile déployée. Le nom de la pile se trouve dans le fichier `samconfig.toml` de votre application ou dans le fichier de configuration désigné.  
Lorsqu'elle est fournie, la logique IDs des ressources de votre modèle sera mappée à leur entrée physique IDs correspondante. CloudFormation Pour en savoir plus sur les ressources physiques IDs, consultez la section [Champs de ressources](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html#resources-section-structure-resource-fields) dans le *guide de AWS CloudFormation l'utilisateur*.  
Lorsque cette option n'est pas spécifiée, les ressources locales définies dans votre modèle s'affichent.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-list-resources-options-"></a>
AWS SAM fichier modèle.  
*Valeur par défaut* : `template.[yaml|yml|json]`

## Exemples
<a name="sam-cli-command-reference-sam-list-resources-examples"></a>

Affichez une sortie, sous forme de tableau, des ressources locales de votre AWS SAM modèle et des ressources déployées à partir de votre CloudFormation pile nommée`test-stack`. Exécuter à partir du même répertoire que votre fichier local.

```
$ sam list resources --stack-name test-stack --output table
			
-------------------------------------------------------------------------------------------------------------------------
Logical ID                                                   Physical ID
-------------------------------------------------------------------------------------------------------------------------
HelloWorldFunction                                           sam-app-test-list-HelloWorldFunction-H85Y7yIV7ZLq
HelloWorldFunctionHelloWorldPermissionProd                   sam-app-test-list-
                                                             HelloWorldFunctionHelloWorldPermissionProd-1QH7CPOCBL2IK
HelloWorldFunctionRole                                       sam-app-test-list-HelloWorldFunctionRole-SRJDMJ6F7F41
ServerlessRestApi                                            uj80uoe2o2
ServerlessRestApiDeployment47fc2d5f9d                        pncw5f
ServerlessRestApiProdStage                                   Prod
ServerlessRestApiDeploymentf5716dc08b                        -
-------------------------------------------------------------------------------------------------------------------------
```

# sam list stack-outputs
<a name="sam-cli-command-reference-sam-list-stack-outputs"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model `sam list stack-outputs` sous-commande Command Line Interface (AWS SAMCLI).

Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)

La `sam list stack-outputs` sous-commande affiche les sorties de votre AWS CloudFormation pile à partir d'un AWS Serverless Application Model (AWS SAM) ou d'un CloudFormation modèle. Pour plus d'informations sur `Outputs`, consultez [Sorties](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/outputs-section-structure.html) dans le *Guide de l'utilisateur AWS CloudFormation *.

## Usage
<a name="sam-cli-command-reference-sam-list-stack-outputs-usage"></a>

```
$ sam list stack-outputs <options>
```

## Options
<a name="sam-cli-command-reference-sam-list-stack-outputs-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-config-env"></a>
Le nom d’environnement spécifiant les valeurs de paramètre par défaut dans le fichier de configuration à utiliser.  
*Valeur par défaut* : `default`  
Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--config-file TEXT`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-config-file"></a>
Le chemin d’accès et le nom du fichier de configuration contenant les valeurs de paramètres par défaut à utiliser.  
*Valeur par défaut* : `samconfig.toml` dans le répertoire de travail actuel.  
Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-debug"></a>
Active la journalisation de débogage pour imprimer le message de débogage généré par la CLI  AWS SAM avec les horodatages.

`--help, -h`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-help"></a>
Affichez ce message et quittez.

`--output [json|table]`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-output"></a>
Spécifiez le format de sortie des résultats.  
*Valeur par défaut* : `table`

`--profile TEXT`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-profile"></a>
Sélectionnez un profil spécifique dans votre fichier d'informations d'identification pour obtenir des AWS informations d'identification.

`--region TEXT`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-region"></a>
Définissez la AWS région du service. Par exemple, `us-east-1`.

`--save-params`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-save-params"></a>
Enregistrez les paramètres que vous fournissez sur la ligne de commande dans le fichier AWS SAM de configuration.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-"></a>
Nom de la CloudFormation pile déployée. Le nom de la pile se trouve dans le fichier `samconfig.toml` de votre application ou dans le fichier de configuration désigné.  
Cette option est obligatoire.

## Exemples
<a name="sam-cli-command-reference-sam-list-stack-outputs-examples"></a>

Affiche les sorties, sous forme de tableau, des ressources de votre CloudFormation pile nommée`test-stack`.

```
$ sam list stack-outputs --stack-name test-stack --output table
			
------------------------------------------------------------------------------------------------------------------------
OutputKey                                OutputValue                              Description
------------------------------------------------------------------------------------------------------------------------
HelloWorldFunctionIamRole                arn:aws:iam::account-number:role/sam-      Implicit IAM Role created for Hello
                                         app-test-list-HelloWorldFunctionRole-    World function
                                         SRJDMJ6F7F41
HelloWorldApi                            https://uj80uoe2o2.execute-api.us-       API Gateway endpoint URL for Prod
                                         east-1.amazonaws.com/Prod/hello/         stage for Hello World function
HelloWorldFunction                       arn:aws:lambda:us-                       Hello World Lambda Function ARN
                                         east-1:account-number:function:sam-app-
                                         test-list-
                                         HelloWorldFunction-H85Y7yIV7ZLq
------------------------------------------------------------------------------------------------------------------------
```

# sam local callback
<a name="sam-cli-command-reference-sam-local-callback"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model commande Command Line Interface (AWS SAMCLI)`sam local callback`.

Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)

La `sam local callback` commande vous permet d'envoyer des rappels aux exécutions de fonctions durables locales pendant le développement et les tests.

## Usage
<a name="sam-cli-command-reference-sam-local-callback-usage"></a>

```
$ sam local callback <subcommand> <options>
```

## Options
<a name="sam-cli-command-reference-sam-local-callback-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-sam-local-callback-options-help"></a>
Affichez ce message et quittez.

## Sous-commandes
<a name="sam-cli-command-reference-sam-local-callback-subcommands"></a>

`succeed`  <a name="sam-cli-command-reference-sam-local-callback-subcommands-succeed"></a>
Envoyez un rappel de réussite à l'exécution d'une fonction durable. Pour de plus amples informations, veuillez consulter [sam local callback succeed](sam-cli-command-reference-sam-local-callback-succeed.md).

`fail`  <a name="sam-cli-command-reference-sam-local-callback-subcommands-fail"></a>
Envoyez un rappel d'échec à une exécution de fonction durable. Pour de plus amples informations, veuillez consulter [sam local callback fail](sam-cli-command-reference-sam-local-callback-fail.md).

`heartbeat`  <a name="sam-cli-command-reference-sam-local-callback-subcommands-heartbeat"></a>
Envoyez un rappel du rythme cardiaque à une exécution de fonction durable. Pour de plus amples informations, veuillez consulter [sam local callback heartbeat](sam-cli-command-reference-sam-local-callback-heartbeat.md).

# sam local callback succeed
<a name="sam-cli-command-reference-sam-local-callback-succeed"></a>

Envoyez un rappel de réussite à l'exécution d'une fonction durable.

## Usage
<a name="ref-sam-cli-local-callback-succeed-usage"></a>

```
$ sam local callback succeed CALLBACK_ID [OPTIONS]
```

## Arguments obligatoires
<a name="ref-sam-cli-local-callback-succeed-arguments"></a>

`CALLBACK_ID`  
Identifiant unique du rappel auquel envoyer une réponse positive.

## Options
<a name="ref-sam-cli-local-callback-succeed-options"></a>

`-r, --result TEXT`  
Charge utile du résultat de réussite sous forme de chaîne.

`--region TEXT`  
Définissez la AWS région du service (par exemple,`us-east-1`).

`--profile TEXT`  
Sélectionnez un profil spécifique dans votre fichier d'informations d'identification pour obtenir des AWS informations d'identification.

`--config-env TEXT`  
Nom de l'environnement spécifiant les valeurs des paramètres par défaut dans le fichier de configuration. Valeur par défaut : `default`

`--config-file TEXT`  
Fichier de configuration contenant les valeurs des paramètres par défaut. Valeur par défaut : `samconfig.toml`

`--save-params`  
Enregistrez les paramètres fournis via la ligne de commande dans le fichier de configuration.

`--beta-features / --no-beta-features`  
Activer/désactiver les fonctionnalités bêta.

`--debug`  
Activez la journalisation du débogage pour imprimer les messages de débogage générés par la AWS SAM CLI et afficher les horodatages.

`-h, --help`  
Affiche ce message, puis se ferme.

## Exemples
<a name="ref-sam-cli-local-callback-succeed-examples"></a>

Envoyer un rappel de réussite sans résultat :

```
$ sam local callback succeed my-callback-id
```

Envoyer un rappel de réussite avec le résultat :

```
$ sam local callback succeed my-callback-id --result 'Task completed successfully'
```

Envoyer un rappel de réussite avec une option courte :

```
$ sam local callback succeed my-callback-id -r 'Success result'
```

# sam local callback fail
<a name="sam-cli-command-reference-sam-local-callback-fail"></a>

Envoyez un rappel d'échec à une exécution de fonction durable.

## Usage
<a name="ref-sam-cli-local-callback-fail-usage"></a>

```
$ sam local callback fail CALLBACK_ID [OPTIONS]
```

## Arguments obligatoires
<a name="ref-sam-cli-local-callback-fail-arguments"></a>

`CALLBACK_ID`  
Identifiant unique du rappel auquel envoyer une réponse d'échec.

## Options
<a name="ref-sam-cli-local-callback-fail-options"></a>

`--error-data TEXT`  
Données d'erreur supplémentaires.

`--stack-trace TEXT`  
Empilez les entrées de suivi. Cette option peut être spécifiée plusieurs fois.

`--error-type TEXT`  
Type d'erreur.

`--error-message TEXT`  
Message d'erreur détaillé.

`--region TEXT`  
Définissez la AWS région du service (par exemple,`us-east-1`).

`--profile TEXT`  
Sélectionnez un profil spécifique dans votre fichier d'informations d'identification pour obtenir des AWS informations d'identification.

`--config-env TEXT`  
Nom de l'environnement spécifiant les valeurs des paramètres par défaut dans le fichier de configuration. Valeur par défaut : `default`

`--config-file TEXT`  
Fichier de configuration contenant les valeurs des paramètres par défaut. Valeur par défaut : `samconfig.toml`

`--save-params`  
Enregistrez les paramètres fournis via la ligne de commande dans le fichier de configuration.

`--beta-features / --no-beta-features`  
Activer/désactiver les fonctionnalités bêta.

`--debug`  
Activez la journalisation du débogage pour imprimer les messages de débogage générés par la AWS SAM CLI et afficher les horodatages.

`-h, --help`  
Affiche ce message, puis se ferme.

## Exemples
<a name="ref-sam-cli-local-callback-fail-examples"></a>

Envoyer un rappel en cas d'échec sans paramètres :

```
$ sam local callback fail my-callback-id
```

Envoyer un rappel d'échec avec un message d'erreur :

```
$ sam local callback fail my-callback-id --error-message 'Task failed'
```

Envoyer un rappel en cas d'échec avec tous les paramètres :

```
$ sam local callback fail my-callback-id --error-message 'Task failed' --error-type 'ValidationError' --stack-trace 'at line 42' --error-data '{"code": 500}'
```

# sam local callback heartbeat
<a name="sam-cli-command-reference-sam-local-callback-heartbeat"></a>

Envoyez un rappel du rythme cardiaque à une exécution de fonction durable.

## Usage
<a name="ref-sam-cli-local-callback-heartbeat-usage"></a>

```
$ sam local callback heartbeat CALLBACK_ID [OPTIONS]
```

## Arguments obligatoires
<a name="ref-sam-cli-local-callback-heartbeat-arguments"></a>

`CALLBACK_ID`  
Identifiant unique du rappel auquel envoyer un battement de cœur.

## Options
<a name="ref-sam-cli-local-callback-heartbeat-options"></a>

`--region TEXT`  
Définissez la AWS région du service (par exemple,`us-east-1`).

`--profile TEXT`  
Sélectionnez un profil spécifique dans votre fichier d'informations d'identification pour obtenir des AWS informations d'identification.

`--config-env TEXT`  
Nom de l'environnement spécifiant les valeurs des paramètres par défaut dans le fichier de configuration. Valeur par défaut : `default`

`--config-file TEXT`  
Fichier de configuration contenant les valeurs des paramètres par défaut. Valeur par défaut : `samconfig.toml`

`--save-params`  
Enregistrez les paramètres fournis via la ligne de commande dans le fichier de configuration.

`--beta-features / --no-beta-features`  
Activer/désactiver les fonctionnalités bêta.

`--debug`  
Activez la journalisation du débogage pour imprimer les messages de débogage générés par la AWS SAM CLI et afficher les horodatages.

`-h, --help`  
Affiche ce message, puis se ferme.

## Exemples
<a name="ref-sam-cli-local-callback-heartbeat-examples"></a>

Envoyer un rappel du rythme cardiaque :

```
$ sam local callback heartbeat my-callback-id
```

# sam local execution
<a name="sam-cli-command-reference-sam-local-execution"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model commande Command Line Interface (AWS SAMCLI)`sam local execution`.

Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)

La `sam local execution` commande vous permet de gérer et d'inspecter les exécutions de fonctions durables locales pendant le développement et les tests.

**Note**  
Il est possible que ces commandes ne nécessitent pas l'accès aux AWS informations d'identification.

## Usage
<a name="sam-cli-command-reference-sam-local-execution-usage"></a>

```
$ sam local execution <subcommand> <options>
```

## Options
<a name="sam-cli-command-reference-sam-local-execution-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-sam-local-execution-options-help"></a>
Affichez ce message et quittez.

## Sous-commandes
<a name="sam-cli-command-reference-sam-local-execution-subcommands"></a>

`get`  <a name="sam-cli-command-reference-sam-local-execution-subcommands-get"></a>
Obtenez des informations sur l'exécution durable d'une fonction. Pour de plus amples informations, veuillez consulter [sam local execution get](sam-cli-command-reference-sam-local-execution-get.md).

`history`  <a name="sam-cli-command-reference-sam-local-execution-subcommands-history"></a>
Obtenez l'historique d'exécution d'une fonction durable. Pour de plus amples informations, veuillez consulter [sam local execution history](sam-cli-command-reference-sam-local-execution-history.md).

`stop`  <a name="sam-cli-command-reference-sam-local-execution-subcommands-stop"></a>
Arrêtez l'exécution d'une fonction durable. Pour de plus amples informations, veuillez consulter [sam local execution stop](sam-cli-command-reference-sam-local-execution-stop.md).

# sam local execution get
<a name="sam-cli-command-reference-sam-local-execution-get"></a>

Récupérez les détails de l'exécution d'une fonction durable spécifique.

**Note**  
Il est possible que cette commande ne nécessite pas d'accès aux AWS informations d'identification.

## Usage
<a name="ref-sam-cli-local-execution-get-usage"></a>

```
$ sam local execution get DURABLE_EXECUTION_ARN [OPTIONS]
```

## Arguments obligatoires
<a name="ref-sam-cli-local-execution-get-arguments"></a>

`DURABLE_EXECUTION_ARN`  
Le nom de ressource Amazon (ARN) de la fonction durable à exécuter pour laquelle vous souhaitez obtenir des informations.

## Options
<a name="ref-sam-cli-local-execution-get-options"></a>

`--format [summary|json]`  
Format de la sortie. Valeur par défaut : `summary`

`--region TEXT`  
Définissez la AWS région du service (par exemple,`us-east-1`).

`--profile TEXT`  
Sélectionnez un profil spécifique dans votre fichier d'informations d'identification pour obtenir des AWS informations d'identification.

`--config-env TEXT`  
Nom de l'environnement spécifiant les valeurs des paramètres par défaut dans le fichier de configuration. Valeur par défaut : `default`

`--config-file TEXT`  
Fichier de configuration contenant les valeurs des paramètres par défaut. Valeur par défaut : `samconfig.toml`

`--save-params`  
Enregistrez les paramètres fournis via la ligne de commande dans le fichier de configuration.

`--beta-features / --no-beta-features`  
Activer/désactiver les fonctionnalités bêta.

`--debug`  
Activez la journalisation du débogage pour imprimer les messages de débogage générés par la AWS SAM CLI et afficher les horodatages.

`-h, --help`  
Affiche ce message, puis se ferme.

## Exemples
<a name="ref-sam-cli-local-execution-get-examples"></a>

Obtenez les détails de l'exécution avec le format de résumé par défaut :

```
$ sam local execution get arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id
```

Obtenez les détails de l'exécution au format JSON :

```
$ sam local execution get arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id --format json
```

# sam local execution history
<a name="sam-cli-command-reference-sam-local-execution-history"></a>

Obtenez l'historique d'exécution d'une fonction durable.

## Usage
<a name="ref-sam-cli-local-execution-history-usage"></a>

```
$ sam local execution history EXECUTION_ID [OPTIONS]
```

## Arguments obligatoires
<a name="ref-sam-cli-local-execution-history-arguments"></a>

`EXECUTION_ID`  
Identifiant unique de l'exécution de la fonction durable pour laquelle il faut récupérer l'historique.

## Options
<a name="ref-sam-cli-local-execution-history-options"></a>

`--format [table|json]`  
Format de la sortie. Valeur par défaut : `table`

`--region TEXT`  
Définissez la AWS région du service (par exemple,`us-east-1`).

`--profile TEXT`  
Sélectionnez un profil spécifique dans votre fichier d'informations d'identification pour obtenir des AWS informations d'identification.

`--config-env TEXT`  
Nom de l'environnement spécifiant les valeurs des paramètres par défaut dans le fichier de configuration. Valeur par défaut : `default`

`--config-file TEXT`  
Fichier de configuration contenant les valeurs des paramètres par défaut. Valeur par défaut : `samconfig.toml`

`--save-params`  
Enregistrez les paramètres fournis via la ligne de commande dans le fichier de configuration.

`--beta-features / --no-beta-features`  
Activer/désactiver les fonctionnalités bêta.

`--debug`  
Activez la journalisation du débogage pour imprimer les messages de débogage générés par la AWS SAM CLI et afficher les horodatages.

`-h, --help`  
Affiche ce message, puis se ferme.

## Exemples
<a name="ref-sam-cli-local-execution-history-examples"></a>

Obtenez l'historique des exécutions sous forme de tableau :

```
$ sam local execution history my-execution-id
```

Obtenez l'historique des exécutions au format JSON :

```
$ sam local execution history my-execution-id --format json
```

# sam local execution stop
<a name="sam-cli-command-reference-sam-local-execution-stop"></a>

Arrêtez l'exécution d'une fonction durable en cours d'exécution.

**Note**  
Il est possible que cette commande ne nécessite pas d'accès aux AWS informations d'identification.

## Usage
<a name="ref-sam-cli-local-execution-stop-usage"></a>

```
$ sam local execution stop DURABLE_EXECUTION_ARN [OPTIONS]
```

## Arguments obligatoires
<a name="ref-sam-cli-local-execution-stop-arguments"></a>

`DURABLE_EXECUTION_ARN`  
L'Amazon Resource Name (ARN) de l'exécution de la fonction durable à arrêter.

## Options
<a name="ref-sam-cli-local-execution-stop-options"></a>

`--error-message TEXT`  
Message d'erreur à associer à l'arrêt de l'exécution.

`--error-type TEXT`  
Type d'erreur à associer à l'arrêt de l'exécution.

`--error-data TEXT`  
Données d'erreur à associer à l'arrêt de l'exécution.

`--stack-trace TEXT`  
Empilez les entrées de suivi. Cette option peut être spécifiée plusieurs fois.

`--region TEXT`  
Définissez la AWS région du service (par exemple,`us-east-1`).

`--profile TEXT`  
Sélectionnez un profil spécifique dans votre fichier d'informations d'identification pour obtenir des AWS informations d'identification.

`--config-env TEXT`  
Nom de l'environnement spécifiant les valeurs des paramètres par défaut dans le fichier de configuration. Valeur par défaut : `default`

`--config-file TEXT`  
Fichier de configuration contenant les valeurs des paramètres par défaut. Valeur par défaut : `samconfig.toml`

`--save-params`  
Enregistrez les paramètres fournis via la ligne de commande dans le fichier de configuration.

`--beta-features / --no-beta-features`  
Activer/désactiver les fonctionnalités bêta.

`--debug`  
Activez la journalisation du débogage pour imprimer les messages de débogage générés par la AWS SAM CLI et afficher les horodatages.

`-h, --help`  
Affiche ce message, puis se ferme.

## Exemples
<a name="ref-sam-cli-local-execution-stop-examples"></a>

Arrêtez l'exécution sans informations détaillées sur l'erreur :

```
$ sam local execution stop arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id
```

Arrêtez l'exécution avec un message d'erreur et tapez :

```
$ sam local execution stop arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id --error-message "Execution cancelled" --error-type "UserCancellation"
```

Arrêtez l'exécution en indiquant tous les détails de l'erreur et en enregistrant la trace :

```
$ sam local execution stop arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id --error-message "Task failed" --error-type "TaskFailure" --error-data '{"reason":"timeout"}' --stack-trace "at function1()" --stack-trace "at function2()"
```

# sam local generate-event
<a name="sam-cli-command-reference-sam-local-generate-event"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model `sam local generate-event` sous-commande Command Line Interface (AWS SAMCLI).
+ Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)
+ Pour obtenir de la documentation sur l'utilisation de la AWS SAMCLI `sam local generate-event` commande, consultez[Présentation des tests avec sam local generate-event](using-sam-cli-local-generate-event.md).

La sous-commande `sam local generate-event` génère des échantillons d’évènement de charge utile pour Services AWS prise en charge.

## Usage
<a name="ref-sam-cli-local-generate-event-usage"></a>

```
$ sam local generate-event <options> <service> <event> <event-options>
```

## Options
<a name="ref-sam-cli-local-generate-event-options"></a>

`--config-env TEXT`  <a name="ref-sam-cli-local-generate-event-options-config-env"></a>
Le nom d’environnement spécifiant les valeurs de paramètre par défaut dans le fichier de configuration à utiliser. La valeur par défaut est « par défaut ». Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-local-generate-event-options-config-file"></a>
Le chemin d'accès et le nom du fichier de configuration contenant les valeurs de paramètres par défaut à utiliser. La valeur par défaut est `samconfig.toml` à la racine du répertoire du projet. Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--help`  <a name="ref-sam-cli-local-generate-event-options-help"></a>
Affiche ce message, puis se ferme.

## Service
<a name="ref-sam-cli-local-generate-event-service"></a>

Pour obtenir la liste des services pris en charge, exécutez la procédure suivante :

```
$ sam local generate-event
```

## Événement
<a name="ref-sam-cli-local-generate-event-event"></a>

Pour obtenir la liste des événements pris en charge pouvant être générés pour chaque service, exécutez la procédure suivante :

```
$ sam local generate-event <service>
```

## Options d'événement
<a name="ref-sam-cli-local-generate-event-event-options"></a>

Pour obtenir une liste des options d'événement prises en charge que vous pouvez modifier, exécutez la procédure suivante :

```
$ sam local generate-event <service> <event> --help
```

## Exemples
<a name="sam-cli-command-reference-sam-local-generate-event-examples"></a>

Pour des exemples d'utilisation de la `sam local generate-event` sous-commande, reportez-vous à[Générer des exemples d'événements](using-sam-cli-local-generate-event.md#using-sam-cli-local-generate-event-generate).

# sam local invoke
<a name="sam-cli-command-reference-sam-local-invoke"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model `sam local invoke` sous-commande Command Line Interface (AWS SAMCLI).
+ Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)
+ Pour obtenir de la documentation sur l'utilisation de la AWS SAMCLI `sam local invoke` sous-commande, consultez[Présentation des tests avec sam local invoke](using-sam-cli-local-invoke.md).

La `sam local invoke` sous-commande lance un appel unique d'une fonction localement. AWS Lambda 

**Note**  
Il n'est pas recommandé d'utiliser les fonctionnalités d'appel local de la SAM CLI dans du code non fiable. Pour vous isoler complètement de votre environnement local, exécutez le code directement dans le service Lambda.

**Note**  
Pour des fonctions durables, `sam local invoke` prend en charge l'exécution dynamique avec pointage automatique et rediffusion. Le conteneur continue de fonctionner pendant l'exécution d'une fonction durable afin de gérer la persistance et la reprise de l'état.

## Usage
<a name="ref-sam-cli-local-invoke-usage"></a>

```
$ sam local invoke <arguments> <options>
```

**Note**  
Si plusieurs fonctions sont définies dans votre AWS SAM modèle, indiquez l'ID logique de la fonction que vous souhaitez invoquer.

## Arguments
<a name="ref-sam-cli-local-invoke-args"></a>

**ID de ressource**  <a name="ref-sam-cli-local-invoke-args-resource-id"></a>
ID de la fonction Lambda à appeler.  
Cet argument est facultatif. Si votre application contient une seule fonction Lambda, la AWS SAM CLI l'invoquera. Si votre application contient plusieurs fonctions, indiquez l'ID de la fonction à invoquer.  
*Valeurs valides* : ID logique ou ARN de la ressource.

## Options
<a name="ref-sam-cli-local-invoke-options"></a>

`--add-host LIST`  <a name="ref-sam-cli-local-invoke-options-add-host"></a>
Transmet un mappage de nom d'hôte à adresse IP au fichier hôte du conteneur Docker. Ce paramètre peut être transmis plusieurs fois.  

**Example**  
Exemple : `--add-host example.com:127.0.0.1`

`--beta-features | --no-beta-features`  <a name="ref-sam-cli-local-invoke-options-beta-features"></a>
Autorisez ou refusez les fonctionnalités bêta.

`--config-env TEXT`  <a name="ref-sam-cli-local-invoke-options-config-env"></a>
Le nom d’environnement spécifiant les valeurs de paramètre par défaut dans le fichier de configuration à utiliser. La valeur par défaut est « par défaut ». Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-local-invoke-options-config-file"></a>
Le chemin d’accès et le nom du fichier de configuration contenant les valeurs de paramètres par défaut à utiliser. La valeur par défaut est « `samconfig.toml` » dans la racine du répertoire du projet. Pour plus d’informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--container-env-vars`  <a name="ref-sam-cli-local-invoke-options-container-env-vars"></a>
(Facultatif) Transmettez les variables d’environnement au conteneur d’images de la fonction Lambda lors du débogage local.

`--container-host TEXT`  <a name="ref-sam-cli-local-invoke-options-container-host"></a>
Hôte du conteneur Lambda émulé localement. La valeur par défaut est `localhost`. Si vous voulez exécuter la CLI  AWS SAM dans un conteneur Docker sous macOS, vous pouvez spécifier `host.docker.internal`. Si vous souhaitez exécuter le conteneur sur un autre hôte AWS SAMCLI, vous pouvez spécifier l'adresse IP de l'hôte distant.

`--container-host-interface TEXT`  <a name="ref-sam-cli-local-invoke-options-container-host-interface"></a>
L’adresse IP de l’interface de réseau hôte à laquelle les ports de conteneur doivent se relier. La valeur par défaut est `127.0.0.1`. Utiliser `0.0.0.0` pour se lier à toutes les interfaces.

`--debug`  <a name="ref-sam-cli-local-invoke-options-debug"></a>
Active la journalisation de débogage pour imprimer les messages de débogage générés par la CLI  AWS SAM et pour afficher les horodatages.

`--debug-args TEXT`  <a name="ref-sam-cli-local-invoke-options-debug-args"></a>
Arguments facultatifs à transmettre au débogueur.

`--debug-port, -d TEXT`  <a name="ref-sam-cli-local-invoke-options-debug-port"></a>
Si spécifié, cela démarre le conteneur de la fonction Lambda en mode débogage et expose ce port sur l’hôte local.

`--debugger-path TEXT`  <a name="ref-sam-cli-local-invoke-options-debugger-path"></a>
Chemin d’accès de l’hôte vers un débogueur monté dans le conteneur Lambda.

`--docker-network TEXT`  <a name="ref-sam-cli-local-invoke-options-docker-network"></a>
Le nom ou l’identifiant d’un réseau Docker existant auquel les conteneurs Docker Lambda doivent se connecter, avec le réseau de pont par défaut. Si cela n’est pas spécifié, les conteneurs Lambda se connectent uniquement au réseau Docker de pont par défaut.

`--docker-volume-basedir, -v TEXT`  <a name="ref-sam-cli-local-invoke-options-docker-volume-basedir"></a>
Emplacement du répertoire de base dans lequel se trouve le AWS SAM fichier. Si Docker est exécuté sur une machine distante, vous devez monter le chemin où se trouve le AWS SAM fichier sur la machine Docker et modifier cette valeur pour qu'elle corresponde à la machine distante.

`--durable-execution-name TEXT`  <a name="ref-sam-cli-local-invoke-options-durable-execution-name"></a>
Nom de l'exécution durable (pour les fonctions durables uniquement)

`--env-vars, -n PATH`  <a name="ref-sam-cli-local-invoke-options-env-vars"></a>
Le `.env` fichier JSON ou contenant les valeurs des variables d'environnement de la fonction Lambda. Le format de fichier est automatiquement détecté. Pour plus d’informations sur les fichiers de variables d’environnement, consultez [Fichier de variable d'environnement](serverless-sam-cli-using-invoke.md#serverless-sam-cli-using-invoke-environment-file).

`--event, -e PATH`  <a name="ref-sam-cli-local-invoke-options-event"></a>
Le fichier JSON qui contient les données d’événement transmises à la fonction Lambda lorsqu’elle est appelée. Si vous ne spécifiez pas cette option, aucun événement n’est assumé. Pour entrer JSON à partir de `stdin`, vous devez transmettre la valeur ’-’. Pour plus d'informations sur les formats de messages d'événements provenant de différents AWS services, consultez la section [Utilisation d'autres services](https://docs.aws.amazon.com/lambda/latest/dg/lambda-services.html) dans le *Guide du AWS Lambda développeur*.

`--force-image-build`  <a name="ref-sam-cli-local-invoke-options-force-image-build"></a>
Spécifie si la CLI  AWS SAM doit recréer l'image utilisée pour invoquer les fonctions Lambda avec des couches.

`--help`  <a name="ref-sam-cli-local-invoke-options-help"></a>
Affiche ce message, puis se ferme.

`--hook-name TEXT`  <a name="ref-sam-cli-local-invoke-options-hook-name"></a>
Nom du hook utilisé pour étendre la fonctionnalité de la CLI  AWS SAM.  
Valeurs acceptées : `terraform`.

`--invoke-image TEXT`  <a name="ref-sam-cli-local-invoke-options-invoke-image"></a>
L’URI de l’image de conteneur que vous souhaitez utiliser pour l’appel de la fonction locale. Par défaut, AWS SAM extrait l'image du conteneur d'Amazon ECR Public (répertoriée dans[Référentiels d'images pour AWS SAM](serverless-image-repositories.md)). Utilisez cette option pour extraire l’image à partir d’un autre emplacement.  
Par exemple, `sam local invoke MyFunction --invoke-image amazon/aws-sam-cli-emulation-image-python3.8`.

`--layer-cache-basedir DIRECTORY`  <a name="ref-sam-cli-local-invoke-options-layer-cache-basedir"></a>
Spécifie l’emplacement du répertoire de base dans lequel les couches utilisées par le modèle sont téléchargées.

`--log-file, -l TEXT`  <a name="ref-sam-cli-local-invoke-options-log-file"></a>
Le fichier journal vers lequel envoyer les journaux d’exécution.

`--mount-symlinks`  <a name="ref-sam-cli-local-invoke-options-mount-symlinks"></a>
Garantit le AWS SAMCLI montage permanent des liens symboliques présents dans les fichiers à créer ou à invoquer. Cela s'applique uniquement aux liens symboliques du répertoire de niveau supérieur (c'est-à-dire aux liens symboliques situés directement à la racine de la fonction). Par défaut, les liens symboliques ne sont pas montés, à l'exception de ceux nécessaires pour être utilisés `node_modules` dans `build-in-source` NodeJS.

`--no-event`  <a name="ref-sam-cli-local-invoke-options-no-event"></a>
Appelle la fonction avec un événement vide.

`--no-memory-limit`  <a name="ref-sam-cli-local-invoke-options-no-memory-limit"></a>
Supprime la limite de mémoire dans le conteneur lors de l'appel local, même lorsque la mémoire est configurée dans le AWS SAM modèle.

`--parameter-overrides`  <a name="ref-sam-cli-local-invoke-options-parameter-overrides"></a>
Chaîne contenant des remplacements de CloudFormation paramètres codés sous forme de paires clé-valeur. Utilisez le même format que le AWS Command Line Interface (AWS CLI). Le AWS SAMCLI format est basé sur des mots clés et valeurs explicites, chaque remplacement étant séparé par un espace. Voici deux exemples :  
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world`
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world ParameterKey=example1,ParameterValue=example2 ParameterKey=apple,ParameterValue=banana`

`--profile TEXT`  <a name="ref-sam-cli-local-invoke-options-profile"></a>
Le profil spécifique de votre fichier d'informations d'identification qui obtient les AWS informations d'identification.

`--region TEXT`  <a name="ref-sam-cli-local-invoke-options-region"></a>
La AWS région dans laquelle le déploiement doit être effectué. Par exemple, us-east-1.

`--runtime TEXT`  <a name="ref-sam-cli-local-invoke-options-runtime"></a>
Utilise le runtime spécifié pour appeler une fonction Lambda localement. Cela remplace le temps d'exécution défini dans le `template.yml` fichier. Cela permet également de tester les fonctions Lambda avec différents temps d'exécution sans modifier la configuration de la fonction d'origine.

`--save-params`  <a name="ref-sam-cli-local-invoke-options-save-params"></a>
Enregistrez les paramètres que vous fournissez sur la ligne de commande dans le fichier AWS SAM de configuration.

`--shutdown`  <a name="ref-sam-cli-local-invoke-options-shutdown"></a>
Imite un événement d’arrêt une fois l’appel terminé, afin de tester la gestion des extensions du comportement d’arrêt.

`--skip-prepare-infra`  <a name="ref-sam-cli-local-invoke-options-skip-prepare-infra"></a>
Ignore l'étape de préparation si aucune modification d'infrastructure n'a été apportée. À utiliser avec l'option `--hook-name`.

`--skip-pull-image`  <a name="ref-sam-cli-local-invoke-options-skip-pull-image"></a>
Par défaut, la CLI  AWS SAM vérifie le dernier environnement d'exécution à distance de Lambda et met automatiquement à jour votre image locale pour rester synchronisée.  
Spécifiez cette option pour ne pas extraire la dernière image Docker de votre environnement d'exécution Lambda.

`--template, -t PATH`  <a name="ref-sam-cli-local-invoke-options-template"></a>
Le fichier AWS SAM modèle.  
Cette option n'est pas compatible avec `--hook-name`.  
Si vous spécifiez cette option, AWS SAM charge uniquement le modèle et les ressources locales vers lesquels il pointe.

`--tenant-id TEXT`  <a name="ref-sam-cli-local-invoke-options-tenancyconfig"></a>
L'ID de locataire pour les fonctions Lambda à locataires multiples. Utilisé pour garantir l'isolation informatique entre les différents locataires. Obligatoire lors de l'appel de fonctions configurées avec le mode d'isolation des locataires.

`--terraform-plan-file`  <a name="ref-sam-cli-local-invoke-options-terraform-plan-file"></a>
Le chemin relatif ou absolu vers votre fichier de plan Terraform local lorsque vous utilisez la CLI  AWS SAM avec Terraform Cloud. Cette option nécessite que `--hook-name` soit défini sur `terraform`.

## Exemples
<a name="sam-cli-command-reference-sam-local-invoke-examples"></a>

L'exemple suivant utilise un événement généré à des fins de test local en utilisant un `s3.json` événement pour appeler une fonction Lambda localement.

```
$ sam local invoke --event events/s3.json S3JsonLoggerFunction
```

L'exemple suivant teste la fonction à l'` HelloWorldFunction`aide de l'environnement d'exécution Python 3.11

```
$ sam local invoke --runtime python3.11 HelloWorldFunction
```

L'exemple suivant teste la fonction ` HelloWorldFunction` avec un nom d'exécution durable

```
$ sam local invoke HelloWorldFunction --durable-execution-name my-execution
```

# sam local start-api
<a name="sam-cli-command-reference-sam-local-start-api"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model `sam local start-api` sous-commande Command Line Interface (AWS SAMCLI).
+ Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)
+ Pour obtenir de la documentation sur l'utilisation de la AWS SAMCLI `sam local start-api` sous-commande, consultez[Présentation des tests avec sam local start-api](using-sam-cli-local-start-api.md).

La `sam local start-api` sous-commande exécute vos AWS Lambda fonctions localement pour les tester via un hôte de serveur HTTP local.

## Usage
<a name="ref-sam-cli-local-start-api-usage"></a>

```
$ sam local start-api <options>
```

## Options
<a name="ref-sam-cli-local-start-api-options"></a>

`--add-host LIST`  <a name="ref-sam-cli-local-start-api-options-add-host"></a>
Transmet un mappage de nom d'hôte à adresse IP au fichier hôte du conteneur Docker. Ce paramètre peut être transmis plusieurs fois.  

**Example**  
Exemple : `--add-host example.com:127.0.0.1`

`--beta-features | --no-beta-features`  <a name="ref-sam-cli-local-start-api-options-beta-features"></a>
Autorisez ou refusez les fonctionnalités bêta.

`--config-env TEXT`  <a name="ref-sam-cli-local-start-api-options-config-env"></a>
Le nom d’environnement spécifiant les valeurs de paramètre par défaut dans le fichier de configuration à utiliser. La valeur par défaut est « par défaut ». Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-local-start-api-options-config-file"></a>
Le chemin d'accès et le nom du fichier de configuration contenant les valeurs de paramètres par défaut à utiliser. La valeur par défaut est « samconfig.toml » dans la racine du répertoire du projet. Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--container-env-vars`  <a name="ref-sam-cli-local-start-api-options-container-env-vars"></a>
Facultatif. Transmettez les variables d’environnement au conteneur d’images lors du débogage local.

`--container-host TEXT`  <a name="ref-sam-cli-local-start-api-options-container-host"></a>
Hôte du conteneur Lambda émulé localement. La valeur par défaut est `localhost`. Si vous voulez exécuter la CLI  AWS SAM dans un conteneur Docker sous macOS, vous pouvez spécifier `host.docker.internal`. Si vous souhaitez exécuter le conteneur sur un autre hôte AWS SAMCLI, vous pouvez spécifier l'adresse IP de l'hôte distant.

`--container-host-interface TEXT`  <a name="ref-sam-cli-local-start-api-options-container-host-interface"></a>
L’adresse IP de l’interface de réseau hôte à laquelle les ports de conteneur doivent se relier. La valeur par défaut est `127.0.0.1`. Utiliser `0.0.0.0` pour se lier à toutes les interfaces.

`--debug`  <a name="ref-sam-cli-local-start-api-options-debug"></a>
Active la journalisation de débogage pour imprimer le message de débogage généré par la CLI  AWS SAM et pour afficher les horodatages.

`--debug-args TEXT`  <a name="ref-sam-cli-local-start-api-options-debug-args"></a>
Arguments facultatifs à transmettre au débogueur.

`--debug-function`  <a name="ref-sam-cli-local-start-api-options-debug-function"></a>
Facultatif. Spécifie la fonction Lambda pour appliquer les options de débogage lorsque `--warm-containers`est spécifié. Ce paramètre s’applique à `--debug-port`, `--debugger-path` et `--debug-args`.

`--debug-port, -d TEXT`  <a name="ref-sam-cli-local-start-api-options-debug-port"></a>
Lorsque spécifié, démarre le conteneur de fonction Lambda en mode débogage et expose ce port sur l'hôte local.

`--debugger-path TEXT`  <a name="ref-sam-cli-local-start-api-options-debugger-path"></a>
Le chemin d’accès de l’hôte vers un débogueur qui sera monté dans le conteneur Lambda.

`--docker-network TEXT`  <a name="ref-sam-cli-local-start-api-options-docker-network"></a>
Nom ou identifiant d’un réseau Docker existant auquel les conteneurs Docker Lambda devraient se connecter, avec le réseau de pont par défaut. Si cela n’est pas spécifié, les conteneurs Lambda se connectent uniquement au réseau Docker de pont par défaut.

` --docker-volume-basedir, -v TEXT`  <a name="ref-sam-cli-local-start-api-options-docker-volume-basedir"></a>
Emplacement du répertoire de base où se trouve le AWS SAM fichier. Si Docker est exécuté sur une machine distante, vous devez monter le chemin où se trouve le AWS SAM fichier sur la machine Docker et modifier cette valeur pour qu'elle corresponde à la machine distante.

`--env-vars, -n PATH`  <a name="ref-sam-cli-local-start-api-options-env-vars"></a>
Le `.env` fichier JSON ou contenant les valeurs des variables d'environnement de la fonction Lambda. Le format de fichier est automatiquement détecté.

`--force-image-build`  <a name="ref-sam-cli-local-start-api-options-force-image-build"></a>
Spécifie s'il AWS SAM CLI faut reconstruire l'image utilisée pour appeler des fonctions avec des couches.

`--help`  <a name="ref-sam-cli-local-start-api-options-help"></a>
Affiche ce message, puis se ferme.

`--hook-name TEXT`  <a name="ref-sam-cli-local-start-api-options-hook-name"></a>
Nom du hook utilisé pour étendre la fonctionnalité de la CLI  AWS SAM.  
Valeurs acceptées : `terraform`.

`--host TEXT`  <a name="ref-sam-cli-local-start-api-options-host"></a>
Le nom d’hôte local ou adresse IP à relier (par défaut : '127.0.0.1').

`--invoke-image TEXT`  <a name="ref-sam-cli-local-start-api-options-invoke-image"></a>
L’URI de l’image de conteneur que vous souhaitez utiliser pour les fonctions Lambda. Par défaut, AWS SAM extrait l'image du conteneur depuis Amazon ECR Public. Utilisez cette option pour extraire l’image à partir d’un autre emplacement.  
Vous pouvez spécifier cette option plusieurs fois. Chaque instance de cette option peut prendre une chaîne ou une paire valeur clé. Si vous spécifiez une chaîne, il s’agit de l’URI de l’image de conteneur à utiliser pour toutes les fonctions de l’application. Par exemple, `sam local start-api --invoke-image public.ecr.aws/sam/emu-python3.8`. Si vous spécifiez une paire valeur clé, la clé est le nom de la ressource et la valeur est l’URI de l’image de conteneur à utiliser pour cette ressource. Par exemple `sam local start-api --invoke-image public.ecr.aws/sam/emu-python3.8 --invoke-image Function1=amazon/aws-sam-cli-emulation-image-python3.8 `. Avec les paires valeur clé, vous pouvez spécifier différentes images de conteneur pour différentes ressources.

`--layer-cache-basedir DIRECTORY`  <a name="ref-sam-cli-local-start-api-options-layer-cache-basedir"></a>
Spécifie l’emplacement basedir dans lequel les couches utilisées par le modèle sont téléchargées.

`--log-file, -l TEXT`  <a name="ref-sam-cli-local-start-api-options-log-file"></a>
Le fichier journal vers lequel envoyer les journaux d’exécution.

`--no-memory-limit`  <a name="ref-sam-cli-local-start-api-options-no-memory-limit"></a>
Supprime la limite de mémoire dans le conteneur lors de l'appel local, même lorsque la mémoire est configurée dans le AWS SAM modèle.

`--parameter-overrides`  <a name="ref-sam-cli-local-start-api-options-parameter-overrides"></a>
Chaîne contenant des remplacements de CloudFormation paramètres codés sous forme de paires clé-valeur. Utilisez le même format que le AWS Command Line Interface (AWS CLI). Le AWS SAMCLI format est constitué de mots clés et valeurs explicites, chaque remplacement étant séparé par un espace. Voici deux exemples :  
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world`
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world ParameterKey=example1,ParameterValue=example2 ParameterKey=apple,ParameterValue=banana`

`--port, -p INTEGER`  <a name="ref-sam-cli-local-start-api-options-port"></a>
Le numéro de port local à écouter (par défaut : '3000').

`--profile TEXT`  <a name="ref-sam-cli-local-start-api-options-profile"></a>
Le profil spécifique de votre fichier d'informations d'identification qui obtient les AWS informations d'identification.

`--region TEXT`  <a name="ref-sam-cli-local-start-api-options-region"></a>
 AWS Région dans laquelle déployer. Par exemple, us-east-1.

`--save-params`  <a name="ref-sam-cli-local-start-api-options-save-params"></a>
Enregistrez les paramètres que vous fournissez sur la ligne de commande dans le fichier AWS SAM de configuration.

`--shutdown`  <a name="ref-sam-cli-local-start-api-options-shutdown"></a>
Imite un événement d’arrêt une fois l’appel terminé, afin de tester la gestion des extensions du comportement d’arrêt.

`--skip-prepare-infra`  <a name="ref-sam-cli-local-start-api-options-skip-prepare-infra"></a>
Ignore l'étape de préparation si aucune modification d'infrastructure n'a été apportée. À utiliser avec l'option `--hook-name`.

`--skip-pull-image`  <a name="ref-sam-cli-local-start-api-options-skip-pull-image"></a>
Spécifie si l’interface de ligne de commande (CLI) doit ignorer la dernière image Docker pour l’exécution Lambda.

`--ssl-cert-file PATH`  <a name="ref-sam-cli-local-start-api-options-ssl-cert-file"></a>
Chemin d'accès au fichier de certificat SSL (par défaut : aucun). Lorsque vous utilisez cette option, elle doit également être utilisée. `--ssl-key-file`

`--ssl-key-file PATH`  <a name="ref-sam-cli-local-start-api-options-static-dir"></a>
Chemin d'accès au fichier clé SSL (par défaut : aucun). Lorsque vous utilisez cette option, elle doit également être utilisée. `--ssl-cert-file`

`--static-dir, -s TEXT`  <a name="ref-sam-cli-local-start-api-options-static-dir"></a>
Tous les fichiers d'actifs statiques (par exempleCSS/JavaScript/HTML) situés dans ce répertoire sont présentés à l'adresse`/`.

`--template, -t PATH`  <a name="ref-sam-cli-local-start-api-options-template"></a>
Le fichier AWS SAM modèle.  
Si vous spécifiez cette option, AWS SAM charge uniquement le modèle et les ressources locales vers lesquels il pointe.

`--terraform-plan-file`  <a name="ref-sam-cli-local-start-api-options-terraform-plan-file"></a>
Le chemin relatif ou absolu vers votre fichier de plan Terraform local lorsque vous utilisez la CLI  AWS SAM avec Terraform Cloud. Cette option nécessite que `--hook-name` soit défini sur `terraform`.

`--warm-containers [EAGER | LAZY]`  <a name="ref-sam-cli-local-start-api-options-warm-containers"></a>
Facultatif. Spécifie comment la CLI  AWS SAM gère les conteneurs pour chaque fonction.  
Deux options sont disponibles :  
   `EAGER` : Les conteneurs pour toutes les fonctions sont chargés au démarrage et persistent entre les appels.  
   `LAZY` : Les conteneurs ne sont chargés que lorsque chaque fonction est appelée pour la première fois. Ces conteneurs persistent pour des appels supplémentaires.

## Exemple
<a name="sam-cli-command-reference-sam-local-start-api-examples"></a>

L'exemple suivant démarre un serveur local, ce qui vous permet de tester votre application via une API. Pour que cette commande fonctionne, l'application doit être installée et Docker doit être en cours d'exécution.

```
$ sam local start-api --port 3000
```

# sam local start-lambda
<a name="sam-cli-command-reference-sam-local-start-lambda"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model `sam local start-lambda` sous-commande Command Line Interface (AWS SAMCLI).
+ Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)
+ Pour obtenir de la documentation sur l'utilisation de la AWS SAMCLI `sam local start-lambda` sous-commande, consultez[Présentation des tests avec sam local start-lambda](using-sam-cli-local-start-lambda.md).

La `sam local start-lambda` sous-commande démarre un point de terminaison local à AWS Lambdaémuler.

## Usage
<a name="ref-sam-cli-local-start-lambda-usage"></a>

```
$ sam local start-lambda <options>
```

## Options
<a name="ref-sam-cli-local-start-lambda-options"></a>

`--add-host LIST`  <a name="ref-sam-cli-local-start-lambda-options-add-host"></a>
Transmet un mappage de nom d'hôte à adresse IP au fichier hôte du conteneur Docker. Ce paramètre peut être transmis plusieurs fois.  

**Example**  
Exemple : `--add-host example.com:127.0.0.1`

`--beta-features | --no-beta-features`  <a name="ref-sam-cli-local-start-lambda-options-beta-features"></a>
Autorisez ou refusez les fonctionnalités bêta.

`--config-env TEXT`  <a name="ref-sam-cli-local-start-lambda-options-config-env"></a>
Le nom d’environnement spécifiant les valeurs de paramètre par défaut dans le fichier de configuration à utiliser. La valeur par défaut est « par défaut ». Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-local-start-lambda-options-config-file"></a>
Le chemin d'accès et le nom du fichier de configuration contenant les valeurs de paramètres par défaut à utiliser. La valeur par défaut est « samconfig.toml » dans la racine du répertoire du projet. Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--container-env-vars`  <a name="ref-sam-cli-local-start-lambda-options-container-env-vars"></a>
Facultatif. Transmettez les variables d’environnement au conteneur d’images lors du débogage local.

`--container-host TEXT`  <a name="ref-sam-cli-local-start-lambda-options-container-host"></a>
Hôte du conteneur Lambda émulé localement. La valeur par défaut est `localhost`. Si vous voulez exécuter la CLI  AWS SAM dans un conteneur Docker sous macOS, vous pouvez spécifier `host.docker.internal`. Si vous souhaitez exécuter le conteneur sur un autre hôte AWS SAMCLI, vous pouvez spécifier l'adresse IP de l'hôte distant.

`--container-host-interface TEXT`  <a name="ref-sam-cli-local-start-lambda-options-container-host-interface"></a>
L’adresse IP de l’interface de réseau hôte à laquelle les ports de conteneur doivent se relier. La valeur par défaut est `127.0.0.1`. Utiliser `0.0.0.0` pour se lier à toutes les interfaces.

`--debug`  <a name="ref-sam-cli-local-start-lambda-options-debug"></a>
Active la journalisation de débogage pour imprimer le message de débogage généré par la CLI  AWS SAM et pour afficher les horodatages.

`--debug-args TEXT`  <a name="ref-sam-cli-local-start-lambda-options-debug-args"></a>
Arguments facultatifs à transmettre au débogueur.

`--debug-function`  <a name="ref-sam-cli-local-start-lambda-options-debug-function"></a>
Facultatif. Spécifie la fonction Lambda pour appliquer les options de débogage lorsque `--warm-containers`est spécifié. Ce paramètre s’applique à `--debug-port`, `--debugger-path` et `--debug-args`.

`--debug-port, -d TEXT`  <a name="ref-sam-cli-local-start-lambda-options-debug-port"></a>
Si spécifié, il démarre le conteneur de fonction Lambda en mode débogage et expose ce port sur l’hôte local.

`--debugger-path TEXT`  <a name="ref-sam-cli-local-start-lambda-options-debugger-path"></a>
Le chemin d’accès de l’hôte vers un débogueur à monter dans le conteneur Lambda.

`--docker-network TEXT`  <a name="ref-sam-cli-local-start-lambda-options-docker-network"></a>
Le nom ou l’identifiant d’un réseau Docker existant auquel les conteneurs Docker Lambda doivent se connecter, avec le réseau de pont par défaut. Si ceci est spécifié, les conteneurs Lambda se connectent uniquement au réseau Docker de pont par défaut.

`--docker-volume-basedir, -v TEXT`  <a name="ref-sam-cli-local-start-lambda-options-docker-volume-basedir"></a>
Emplacement du répertoire de base où se trouve le AWS SAM fichier. Si Docker est exécuté sur une machine distante, vous devez monter le chemin où se trouve le AWS SAM fichier sur la machine Docker et modifier cette valeur pour qu'elle corresponde à la machine distante.

`--env-vars, -n PATH`  <a name="ref-sam-cli-local-start-lambda-options-env-vars"></a>
Le `.env` fichier JSON ou contenant les valeurs des variables d'environnement de la fonction Lambda. Le format de fichier est automatiquement détecté.

`--force-image-build`  <a name="ref-sam-cli-local-start-lambda-options-force-image-build"></a>
Spécifiez s'il CLI faut reconstruire l'image utilisée pour appeler des fonctions avec des couches.

`--help`  <a name="ref-sam-cli-local-start-lambda-options-help"></a>
Affiche ce message, puis se ferme.

`--hook-name TEXT`  <a name="ref-sam-cli-local-start-lambda-options-hook-name"></a>
Nom du hook utilisé pour étendre la fonctionnalité de la CLI  AWS SAM.  
Valeurs acceptées : `terraform`.

`--host TEXT`  <a name="ref-sam-cli-local-start-lambda-options-host"></a>
Le nom d’hôte local ou adresse IP à relier (par défaut : '127.0.0.1').

`--invoke-image TEXT`  <a name="ref-sam-cli-local-start-lambda-options-invoke-image"></a>
L’URI de l’image de conteneur que vous souhaitez utiliser pour l’appel de la fonction locale. Par défaut, AWS SAM extrait l'image du conteneur depuis Amazon ECR Public. Utilisez cette option pour extraire l’image à partir d’un autre emplacement.  
Par exemple, `sam local start-lambda MyFunction --invoke-image amazon/aws-sam-cli-emulation-image-python3.8`.

`--layer-cache-basedir DIRECTORY`  <a name="ref-sam-cli-local-start-lambda-options-layer-cache-basedir"></a>
Spécifie l’emplacement basedir dans lequel les couches utilisées par le modèle sont téléchargées.

`--log-file, -l TEXT`  <a name="ref-sam-cli-local-start-lambda-options-log-file"></a>
Le fichier journal vers lequel envoyer les journaux d’exécution.

`--no-memory-limit`  <a name="ref-sam-cli-local-start-lambda-options-no-memory-limit"></a>
Supprime la limite de mémoire dans le conteneur lors de l'appel local, même lorsque la mémoire est configurée dans le AWS SAM modèle.

`--parameter-overrides`  <a name="ref-sam-cli-local-start-lambda-options-parameter-overrides"></a>
Chaîne contenant des remplacements de CloudFormation paramètres codés sous forme de paires clé-valeur. Utilisez le même format que le AWS Command Line Interface (AWS CLI). Le AWS SAMCLI format est basé sur des mots clés et valeurs explicites, chaque remplacement étant séparé par un espace. Voici deux exemples :  
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world`
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world ParameterKey=example1,ParameterValue=example2 ParameterKey=apple,ParameterValue=banana`

`--port, -p INTEGER`  <a name="ref-sam-cli-local-start-lambda-options-port"></a>
Numéro de port local à écouter (par défaut : '3001').

`--profile TEXT`  <a name="ref-sam-cli-local-start-lambda-options-profile"></a>
Le profil spécifique de votre fichier d'informations d'identification qui obtient les AWS informations d'identification.

`--region TEXT`  <a name="ref-sam-cli-local-start-lambda-options-region"></a>
 AWS Région dans laquelle le déploiement doit être effectué. Par exemple, us-east-1.

`--save-params`  <a name="ref-sam-cli-local-start-lambda-options-save-params"></a>
Enregistrez les paramètres que vous fournissez sur la ligne de commande dans le fichier AWS SAM de configuration.

`--shutdown`  <a name="ref-sam-cli-local-start-lambda-options-shutdown"></a>
Imite un événement d’arrêt une fois l’appel terminé, afin de tester la gestion des extensions du comportement d’arrêt.

`--skip-prepare-infra`  <a name="ref-sam-cli-local-start-lambda-options-skip-prepare-infra"></a>
Ignore l'étape de préparation si aucune modification d'infrastructure n'a été apportée. À utiliser avec l'option `--hook-name`.

`--skip-pull-image`  <a name="ref-sam-cli-local-start-lambda-options-skip-pull-image"></a>
Spécifie s'il CLI faut ignorer l'extraction de la dernière image Docker vers le bas pour le runtime Lambda.

`--template, -t PATH`  <a name="ref-sam-cli-local-start-lambda-options-template"></a>
Le fichier AWS SAM modèle.  
Si vous spécifiez cette option, AWS SAM charge uniquement le modèle et les ressources locales vers lesquels il pointe. Cette option n'est pas compatible avec `--hook-name`.

`--terraform-plan-file`  <a name="ref-sam-cli-local-start-lambda-options-terraform-plan-file"></a>
Le chemin relatif ou absolu vers votre fichier de plan Terraform local lorsque vous utilisez la CLI  AWS SAM avec Terraform Cloud. Cette option nécessite que `--hook-name` soit défini sur `terraform`.

`--warm-containers [EAGER | LAZY]`  <a name="ref-sam-cli-local-start-lambda-options-warm-containers"></a>
Facultatif. Spécifie comment la CLI  AWS SAM gère les conteneurs pour chaque fonction.  
Deux options sont disponibles :  
+ `EAGER` : Les conteneurs pour toutes les fonctions sont chargés au démarrage et persistent entre les appels.
+ `LAZY` : Les conteneurs ne sont chargés que lorsque chaque fonction est appelée pour la première fois. Ces conteneurs persistent pour des appels supplémentaires.

## Exemple
<a name="sam-cli-command-reference-sam-local-start-lambda-examples"></a>

Pour un exemple détaillé et une présentation détaillée de l'utilisation de la `sam local start-lambda` sous-commande, reportez-vous à. [Présentation des tests avec sam local start-lambda](using-sam-cli-local-start-lambda.md)

# sam logs
<a name="sam-cli-command-reference-sam-logs"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model commande Command Line Interface (AWS SAMCLI)`sam logs`.

Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)

La `sam logs` commande récupère les journaux générés par vos AWS Lambda fonctions.

## Usage
<a name="sam-cli-command-reference-sam-logs-usage"></a>

```
$ sam logs <options>
```

## Options
<a name="sam-cli-command-reference-sam-logs-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-logs-options-config-env"></a>
Le nom d’environnement spécifiant les valeurs de paramètre par défaut dans le fichier de configuration à utiliser. La valeur par défaut est « par défaut ». Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-logs-options-config-file"></a>
Le chemin d'accès et le nom du fichier de configuration contenant les valeurs de paramètres par défaut à utiliser. La valeur par défaut est « samconfig.toml » dans la racine du répertoire du projet. Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--cw-log-group LIST`  <a name="sam-cli-command-reference-sam-logs-options-cw-log-group"></a>
Inclut les CloudWatch journaux des groupes de journaux que vous spécifiez. Si vous spécifiez cette option avec`name`, AWS SAM inclut les journaux des groupes de journaux spécifiés en plus des journaux des ressources nommées.

`--debug`  <a name="sam-cli-command-reference-sam-logs-options-debug"></a>
Active la journalisation de débogage pour imprimer le message de débogage généré par la CLI  AWS SAM et pour afficher les horodatages.

`---end-time, e TEXT`  <a name="sam-cli-command-reference-sam-logs-options-end-time"></a>
Récupère les journaux jusqu’à ce moment. L'heure peut être des valeurs relatives comme « il y a 5 minutes », « hier », ou un horodatage formaté comme « 2018-01-01 10:10:10 ».

`--filter TEXT`  <a name="sam-cli-command-reference-sam-logs-options-filter"></a>
Vous permet de spécifier une expression pour rechercher rapidement des journaux qui correspondent à des termes, des phrases ou des valeurs dans les journaux d’événements. Il peut s'agir d'un simple mot clé (par exemple, « erreur ») ou d'un modèle pris en charge par Amazon CloudWatch Logs. Pour connaître la syntaxe, consultez la [documentation Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html).

`--help`  <a name="sam-cli-command-reference-sam-logs-options-help"></a>
Affiche ce message, puis se ferme.

`--include-traces`  <a name="sam-cli-command-reference-sam-logs-options-include-traces"></a>
Inclut des traces X-Ray dans la sortie du journal.

`--name, -n TEXT`  <a name="sam-cli-command-reference-sam-logs-options-name"></a>
Le nom de la ressource pour laquelle vous souhaitez récupérer des journaux. Si cette ressource fait partie d'une CloudFormation pile, il peut s'agir de l'ID logique de la ressource fonctionnelle dans le AWS SAM modèle CloudFormation/. Plusieurs noms peuvent être fournis en répétant à nouveau le paramètre. Si la ressource se trouve dans une pile imbriquée, le nom peut être précédé du nom de la pile imbriquée pour extraire les journaux de cette ressource (/). NestedStackLogicalId ResourceLogicalId Si le nom de la ressource n'est pas fourni, la pile donnée sera analysée et les informations de journal seront extraites pour toutes les ressources prises en charge. Si vous ne spécifiez pas cette option, AWS SAM extrait les journaux de toutes les ressources de la pile que vous spécifiez. Les types de ressources suivants sont pris en charge :  
+ `AWS::Serverless::Function`
+ `AWS::Lambda::Function`
+ `AWS::Serverless::Api`
+ `AWS::ApiGateway::RestApi`
+ `AWS::Serverless::HttpApi`
+ `AWS::ApiGatewayV2::Api`
+ `AWS::Serverless::StateMachine`
+ `AWS::StepFunctions::StateMachine`

`--output TEXT`  <a name="sam-cli-command-reference-sam-logs-options-output"></a>
Spécifie le format de sortie pour les journaux. Pour imprimer des journaux formatés, spécifiez `text`. Pour imprimer les journaux au format JSON, spécifiez `json`.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-logs-options-profile"></a>
Le profil spécifique de votre fichier d'informations d'identification qui obtient les AWS informations d'identification.

`--region TEXT`  <a name="sam-cli-command-reference-sam-logs-options-region"></a>
 AWS Région dans laquelle le déploiement doit être effectué. Par exemple, us-east-1.

`--save-params`  <a name="sam-cli-command-reference-sam-logs-options-save-params"></a>
Enregistrez les paramètres que vous fournissez sur la ligne de commande dans le fichier AWS SAM de configuration.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-logs-options-stack-name"></a>
Nom de la CloudFormation pile dont fait partie la ressource.

`--start-time, -s TEXT`  <a name="sam-cli-command-reference-sam-logs-options-start-time"></a>
Récupère les journaux à partir de ce moment. L'heure peut être des valeurs relatives comme « il y a 5 minutes », « hier », ou un horodatage formaté comme « 2018-01-01 10:10:10 ». La valeur par défaut est « il y a 10 minutes ».

` --tail, -t`  <a name="sam-cli-command-reference-sam-logs-options-tail"></a>
Suit la sortie du journal. Cela ignore l’argument de fin d’heure et continue de récupérer les journaux à mesure qu’ils deviennent disponibles.

## Exemples
<a name="sam-cli-command-reference-sam-logs-examples"></a>

Lorsque vos fonctions font partie d'une CloudFormation pile, vous pouvez récupérer les journaux en utilisant l'identifiant logique de la fonction lorsque vous spécifiez le nom de la pile.

```
$ sam logs -n HelloWorldFunction --stack-name myStack
```

Consultez les journaux pour une plage de temps spécifique à l'aide des options -s (--start-time) et -e (--end-time).

```
$ sam logs -n HelloWorldFunction --stack-name myStack -s '10min ago' -e '2min ago'
```

Vous pouvez également ajouter la `--tail` possibilité d'attendre les nouveaux journaux et de les voir à leur arrivée.

```
$ sam logs -n HelloWorldFunction --stack-name myStack --tail
```

Utilisez `--filter` cette option pour trouver rapidement les journaux correspondant aux termes, expressions ou valeurs de vos événements de journal.

```
$ sam logs -n HelloWorldFunction --stack-name myStack --filter "error"
```

Consultez les journaux d'une ressource dans une pile enfant.

```
$ sam logs --stack-name myStack -n childStack/HelloWorldFunction
```

Journaux de suivi de toutes les ressources prises en charge dans votre application.

```
$ sam logs --stack-name sam-app --tail
```

Récupérez les journaux d'une fonction Lambda et d'une API API Gateway spécifiques dans votre application.

```
$ sam logs --stack-name sam-app --name HelloWorldFunction --name HelloWorldRestApi
```

Récupérez les journaux de toutes les ressources prises en charge dans votre application, ainsi que des groupes de journaux spécifiés.

```
$ sam logs --cw-log-group /aws/lambda/myfunction-123 --cw-log-group /aws/lambda/myfunction-456
```

# sam package
<a name="sam-cli-command-reference-sam-package"></a>

L'interface de ligne de AWS Serverless Application Model commande (AWS SAM CLI) empaquette une AWS SAM application.

Cette commande crée un `.zip` fichier contenant votre code et vos dépendances, et télécharge le fichier sur Amazon Simple Storage Service (Amazon S3). AWS SAM active le chiffrement de tous les fichiers stockés dans Amazon S3. Il renvoie ensuite une copie de votre AWS SAM modèle, en remplaçant les références aux artefacts locaux par l'emplacement Amazon S3 où la commande a chargé les artefacts.

Par défaut, lorsque vous utilisez cette commande, la CLI  AWS SAM suppose que le répertoire de travail actuel est le répertoire racine du projet. Le AWS SAMCLI premier essaie de localiser un fichier modèle créé à l'aide de la [sam build](sam-cli-command-reference-sam-build.md) commande, situé dans le `.aws-sam` sous-dossier et nommé`template.yaml`. Ensuite, la CLI  AWS SAM tente de localiser un fichier modèle nommé `template.yaml` ou `template.yml` dans le répertoire de travail actuel. Si vous spécifiez l'`--template`option, AWS SAMCLI le comportement par défaut est remplacé et empaquetera uniquement ce AWS SAM modèle et les ressources locales vers lesquelles il pointe.

**Note**  
[sam deploy](sam-cli-command-reference-sam-deploy.md) exécute maintenant implicitement la fonctionnalité de `sam package`. Vous pouvez utiliser la commande [sam deploy](sam-cli-command-reference-sam-deploy.md) directement pour empaqueter et déployer l’application.

## Usage
<a name="sam-cli-command-reference-sam-package-usage"></a>

```
$ sam package <arguments> <options>
```

## Arguments
<a name="sam-cli-command-reference-sam-package-args"></a>

**ID de ressource**  <a name="sam-cli-command-reference-sam-package-args-resource-id"></a>
ID de la fonction Lambda à empaqueter.  
Cet argument est facultatif. Si votre application contient une seule fonction Lambda, la AWS SAM CLI l'empaquetera. Si votre application contient plusieurs fonctions, indiquez l'ID de la fonction pour empaqueter une seule fonction.  
*Valeurs valides* : ID logique ou ARN de la ressource.

## Options
<a name="sam-cli-command-reference-sam-package-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-package-options-config-env"></a>
Le nom d’environnement spécifiant les valeurs de paramètre par défaut dans le fichier de configuration à utiliser. La valeur par défaut est « par défaut ». Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-package-options-config-file"></a>
Le chemin d'accès et le nom du fichier de configuration contenant les valeurs de paramètres par défaut à utiliser. La valeur par défaut est « samconfig.toml » dans la racine du répertoire du projet. Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-package-options-debug"></a>
Active la journalisation de débogage pour imprimer le message de débogage généré par la CLI  AWS SAM et pour afficher les horodatages.

`--force-upload`  <a name="sam-cli-command-reference-sam-package-options-force-upload"></a>
Remplacer les fichiers existants dans le compartiment Amazon S3. Spécifiez cet indicateur pour télécharger des artefacts, même s’ils correspondent à des artefacts existants dans le compartiment Amazon S3.

`--help`  <a name="sam-cli-command-reference-sam-package-options-help"></a>
Affiche ce message, puis se ferme.

`--image-repository TEXT`  <a name="sam-cli-command-reference-sam-package-options-image-repository"></a>
L’URI du référentiel Amazon Elastic Container Registry (Amazon ECR) vers lequel cette commande télécharge l’image de la fonction. Requis pour les fonctions déclarées avec le type de package `Image`.

`--kms-key-id TEXT`  <a name="sam-cli-command-reference-sam-package-options-kms-key-id"></a>
L'ID d'une clé AWS Key Management Service (AWS KMS) utilisée pour chiffrer les artefacts inactifs dans le compartiment Amazon S3. Si cette option n'est pas spécifiée, AWS SAM utilise les clés de chiffrement gérées par Amazon S3.

`--metadata`  <a name="sam-cli-command-reference-sam-package-options-metadata"></a>
(Facultatif) Une carte de métadonnées à attacher à tous les artefacts référencés dans le modèle.

`--no-progressbar`  <a name="sam-cli-command-reference-sam-package-options-no-progressbar"></a>
N’affichez pas de barre de progression lors du téléchargement d’artefacts sur Amazon S3.

`--output-template-file PATH`  <a name="sam-cli-command-reference-sam-package-options-output-template-file"></a>
Chemin d’accès au fichier dans lequel la commande écrit le modèle empaqueté. Si vous ne spécifiez pas de chemin d’accès, la commande écrit le modèle dans la sortie standard.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-package-options-profile"></a>
Le profil spécifique de votre fichier d'informations d'identification qui obtient les AWS informations d'identification.

`--region TEXT`  <a name="sam-cli-command-reference-sam-package-options-region"></a>
La AWS région dans laquelle le déploiement doit être effectué. Par exemple, us-east-1.

`--resolve-s3`  <a name="sam-cli-command-reference-sam-package-options-resolve-s3"></a>
Créez automatiquement un compartiment Amazon S3 à utiliser pour l’empaquetage. Si vous précisez les deux options `--s3-bucket` et `--resolve-s3`, alors une erreur se produira.

`--s3-bucket TEXT`  <a name="sam-cli-command-reference-sam-package-options-s3-bucket"></a>
Le nom du compartiment Amazon S3 dans lequel cette commande télécharge votre artefact. Si votre artefact est supérieur à 51 200 octets, l'option `--s3-bucket` ou l'`--resolve-s3`option est requise. Si vous précisez les deux options `--s3-bucket` et `--resolve-s3`, alors une erreur se produira.

`--s3-prefix TEXT`  <a name="sam-cli-command-reference-sam-package-options-s3-prefix"></a>
Le préfixe ajouté aux noms des artefacts téléchargés vers le compartiment Amazon S3. Le nom du préfixe est un nom de chemin d’accès (nom de dossier) pour le compartiment Amazon S3. Cela s’applique uniquement aux fonctions déclarées avec le type de package `Zip`.

`--save-params`  <a name="sam-cli-command-reference-sam-package-options-save-params"></a>
Enregistrez les paramètres que vous fournissez sur la ligne de commande dans le fichier AWS SAM de configuration.

`--signing-profiles LIST`  <a name="sam-cli-command-reference-sam-package-options-signing-profiles"></a>
(Facultatif) La liste des profils de signature pour signer les packages de déploiement. Ce paramètre prend une liste de paires valeur clé, où la clé est le nom de la fonction ou de la couche à signer et la valeur est le profil de signature, avec un propriétaire de profil facultatif délimité par `:`. Par exemple, `FunctionNameToSign=SigningProfileName1 LayerNameToSign=SigningProfileName2:SigningProfileOwner`.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-package-options-template-file"></a>
Le chemin et le nom du fichier où se trouve votre AWS SAM modèle.  
Si vous spécifiez cette option, AWS SAM empaquette uniquement le modèle et les ressources locales vers lesquels il pointe.

`--use-json`  <a name="sam-cli-command-reference-sam-package-options-use-json"></a>
Sortie JSON pour le CloudFormation modèle. Par défaut, YAML est utilisé.

## Exemple
<a name="sam-cli-command-reference-sam-package-examples"></a>

L'exemple suivant crée et empaquette des artefacts pour une fonction Lambda et des CodeDeploy applications. Les artefacts sont chargés dans un compartiment Amazon S3. La sortie de la commande est un nouveau fichier nommé `package.yml`.

```
$ sam package \
  --template-file template.yml \
  --output-template-file package.yml \
  --s3-bucket amzn-s3-demo-bucket
```

# sam pipeline bootstrap
<a name="sam-cli-command-reference-sam-pipeline-bootstrap"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model `sam local pipeline bootstrap` sous-commande Command Line Interface (AWS SAMCLI).

Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)

La `sam pipeline bootstrap` sous-commande génère les ressources AWS d'infrastructure requises pour se connecter à votre système CI/CD. Cette étape doit être exécutée pour chaque étape de déploiement du pipeline, avant d'exécuter la commande **sam pipeline init**.

Cette sous-commande configure les ressources AWS d'infrastructure suivantes :
+ Option de configuration des autorisations du pipeline via :
  + Un utilisateur IAM du pipeline avec un identifiant de clé d'accès et des informations d'identification d'accès par clé secrète à partager avec le CI/CD système.
**Note**  
Nous vous recommandons d'effectuer une rotation régulière des clés d'accès. Pour plus d'informations, consultez [Rotation régulière des clés d'accès pour les cas d'utilisation nécessitant des informations d'identification](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#rotate-credentials) dans le *Guide de l'utilisateur IAM*.
  +  CI/CD Plateformes prises en charge via OIDC. Pour obtenir une présentation de l'utilisation d'OIDC avec un pipeline AWS SAM , consultez [Comment utiliser l'authentification OIDC avec les pipelines AWS SAM](deploying-with-oidc.md).
+ Rôle IAM d' CloudFormation exécution assumé par CloudFormation pour déployer l' AWS SAM application.
+ Un compartiment Amazon S3 pour contenir les AWS SAM artefacts.
+ Le cas échéant, un référentiel d’images Amazon ECR pour contenir des packages de déploiement Lambda de conteneur d’images (si vous disposez d’une ressource avec le type de package `Image`).

## Usage
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-usage"></a>

```
$ sam pipeline bootstrap <options>
```

## Options
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-options"></a>

`--bitbucket-repo-uuid TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-bitbucket-repo-uuid"></a>
 L'UUID du référentiel Bitbucket. Cette option est spécifique à l'utilisation d'OIDC avec Bitbucket pour les autorisations.  
Cette valeur se trouve à l'adresse https://bitbucket.org/*workspace*/*repository*/admin/addon/admin/pipelines/openid-connect 

`--bucket TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-bucket"></a>
L'ARN du compartiment Amazon S3 qui contient les AWS SAM artefacts.

`--cicd-provider TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-cicd-provider"></a>
La CI/CD plate-forme pour le AWS SAM pipeline.

`--cloudformation-execution-role TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-cloudformation-execution-role"></a>
L'ARN du rôle IAM à assumer CloudFormation lors du déploiement de la pile de l'application. Fournissez-le uniquement si vous voulez utiliser votre propre rôle. Sinon, la commande crée un nouveau rôle.

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-config-env"></a>
Le nom d'environnement spécifiant les valeurs de paramètre par défaut dans le fichier de configuration à utiliser. La valeur par défaut est **default**. Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-config-file"></a>
Le chemin d'accès et le nom du fichier de configuration contenant les valeurs de paramètres par défaut à utiliser. La valeur par défaut est `samconfig.toml` à la racine du répertoire du projet. Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--confirm-changeset | --no-confirm-changeset`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-confirm-changeset"></a>
Invitation à confirmer le déploiement de vos ressources.

`--create-image-repository | --no-create-image-repository`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-create-image-repository"></a>
Indiquez si vous souhaitez créer un référentiel d’images Amazon ECR si aucun n’est fourni. Le référentiel Amazon ECR contient les images de conteneur des fonctions Lambda ou des couches présentant un type de package `Image`. La valeur par défaut est `--no-create-image-repository`.

`--debug`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-debug"></a>
Active la journalisation de débogage, imprime les messages de débogage générés par la CLI  AWS SAM et affiche les horodatages.

`--deployment-branch TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-deployment-branch"></a>
Nom de la branche à partir de laquelle les déploiements seront effectués. Cette option est spécifique à l'utilisation d' GitHub Actions OIDC pour les autorisations.

`--github-org TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-github-org"></a>
L' GitHub organisation à laquelle appartient le référentiel. Si aucune organisation n'existe, saisissez le nom d'utilisateur du propriétaire du référentiel. Cette option est spécifique à l'utilisation d' GitHubActions OIDC pour les autorisations.

`--github-repo TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-github-repo"></a>
Nom du GitHub référentiel à partir duquel les déploiements seront effectués. Cette option est spécifique à l'utilisation d' GitHub Actions OIDC pour les autorisations.

`--gitlab-group TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-gitlab-group"></a>
Le GitLab groupe auquel appartient le référentiel. Cette option est spécifique à l'utilisation de l' GitLab OIDC pour les autorisations.

`--gitlab-project TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-gitlab-project"></a>
Le nom GitLab du projet. Cette option est spécifique à l'utilisation de l' GitLab OIDC pour les autorisations.

`--help, -h`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-help"></a>
Affiche ce message, puis se ferme.

`--image-repository TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-image-repository"></a>
L'ARN d'un référentiel d'images Amazon ECR contenant les images de conteneur des fonctions Lambda ou des couches avec un type de package `Image`. S’il est fourni, l’option `--create-image-repository` est ignorée. S'il n'est pas fourni et que `--create-image-repository` est spécifié, la commande en crée un.

`--interactive | --no-interactive`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-interactive"></a>
Désactivez l'invite interactive pour les paramètres d'amorçage et attendez si des paramètres requis sont manquants. La valeur par défaut est `--interactive`. Avec cette commande, `--stage` est le seul paramètre obligatoire.  
S'il `--no-interactive` est spécifié en même temps que`--use-oidc-provider`, tous les paramètres requis pour votre fournisseur OIDC doivent être inclus.

`--oidc-client-id TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-client-id"></a>
L'ID client configuré pour être utilisé avec votre fournisseur OIDC.

`--oidc-provider [github-actions | gitlab | bitbucket-pipelines]`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-provider"></a>
Nom du CI/CD fournisseur qui sera utilisé pour les autorisations OIDC. GitLab, GitHub, et Bitbucket sont pris en charge.

`--oidc-provider-url TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-provider-url"></a>
URL du fournisseur OIDC. La valeur doit commencer par **https://**.

`--permissions-provider [oidc | iam]`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-permissions-provider"></a>
Choisissez un fournisseur d'autorisations pour assumer le rôle d'exécution du pipeline. La valeur par défaut est **iam**.

`--pipeline-execution-role TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-pipeline-execution-role"></a>
L’ARN du rôle IAM devant être assumé par l’utilisateur de pipeline pour fonctionner sur cette étape. Fournissez-le uniquement si vous voulez utiliser votre propre rôle. S'il n'est pas fourni, cette commande crée un nouveau rôle.

`--pipeline-user TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-pipeline-user"></a>
Nom de ressource Amazon (ARN) de l'utilisateur IAM dont l'ID de clé d'accès et la clé d'accès secrète sont partagés avec le CI/CD système. Il est utilisé pour accorder à cet utilisateur IAM l'autorisation d'accéder au AWS compte correspondant. S'il n'est pas fourni, la commande crée un utilisateur IAM avec l'identifiant de la clé d'accès et les informations d'identification de clé d'accès secrète.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-profile"></a>
Le profil spécifique de votre fichier d'informations d'identification qui obtient les AWS informations d'identification.

`--region TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-region"></a>
La AWS région dans laquelle le déploiement doit être effectué. Par exemple, `us-east-1`.

`--save-params`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-save-params"></a>
Enregistrez les paramètres que vous fournissez sur la ligne de commande dans le fichier AWS SAM de configuration.

`--stage TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-stage"></a>
Le nom de l’étape de déploiement correspondante. Il est utilisé comme suffixe pour les ressources AWS d'infrastructure créées.

## Résolution des problèmes
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-troubleshooting"></a>

### Error: Missing required parameter (Erreur : paramètre requis manquant)
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-troubleshooting-example1"></a>

Quand `--no-interactive` est spécifié avec `--use-oidc-provider` et qu'aucun des paramètres requis n'est fourni, ce message d'erreur s'affiche avec une description des paramètres manquants.

## Exemple
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-examples"></a>

L'exemple suivant crée les AWS ressources nécessaires à la création de votre CI/CD système, active la journalisation du débogage et imprime les messages de débogage générés par AWS SAMCLI : utilise un événement généré pour les tests locaux en utilisant un `s3.json` événement pour appeler une fonction Lambda localement

```
$ sam pipeline bootstrap --debug
```

# sam pipeline init
<a name="sam-cli-command-reference-sam-pipeline-init"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model `sam pipeline init` sous-commande Command Line Interface (AWS SAMCLI).

Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)

La `sam pipeline init` sous-commande génère un fichier de configuration de pipeline que votre CI/CD système peut utiliser pour déployer des applications sans serveur à l'aide de. AWS SAM

Avant d’utiliser **sam pipeline init**, vous devez amorcer les ressources nécessaires pour chaque étape du pipeline. Pour ce faire, exécutez **sam pipeline init --bootstrap** pour être guidé tout au long du processus de génération de fichiers d’installation et de configuration ou référez-vous aux ressources que vous avez précédemment créées à l’aide de la commande **sam pipeline bootstrap**.

## Usage
<a name="sam-cli-command-reference-sam-pipeline-init-usage"></a>

```
$ sam pipeline init <options>
```

## Options
<a name="sam-cli-command-reference-sam-pipeline-init-options"></a>

`--bootstrap`  <a name="sam-cli-command-reference-sam-pipeline-init-options-bootstrap"></a>
Activez le mode interactif qui guide l'utilisateur tout au long de la création des ressources AWS d'infrastructure nécessaires.

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-pipeline-init-options-config-env"></a>
Le nom d'environnement spécifiant les valeurs de paramètre par défaut dans le fichier de configuration à utiliser. La valeur par défaut est `default`. Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--config-file TEXT`  <a name="sam-cli-command-reference-sam-pipeline-init-options-config-file"></a>
Le chemin d'accès et le nom du fichier de configuration contenant les valeurs de paramètres par défaut à utiliser. La valeur par défaut est `samconfig.toml` dans le répertoire racine du projet. Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-pipeline-init-options-debug"></a>
Active la journalisation de débogage pour imprimer les messages de débogage générés par la CLI  AWS SAM et pour afficher les horodatages.

`--help, -h`  <a name="sam-cli-command-reference-sam-pipeline-init-options-help"></a>
Affiche ce message, puis se ferme.

`--save-params`  <a name="sam-cli-command-reference-sam-pipeline-init-options-save-params"></a>
Enregistrez les paramètres que vous fournissez sur la ligne de commande dans le fichier AWS SAM de configuration.

## Exemple
<a name="sam-cli-command-reference-sam-pipeline-init-examples"></a>

L'exemple suivant vous montre comment utiliser l'`--bootstrap`option qui vous permet de passer par un mode interactif qui vous guide tout au long de la création des ressources d' AWS infrastructure nécessaires :

```
$ sam pipeline init --bootstrap
```

# sam publish
<a name="sam-cli-command-reference-sam-publish"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model commande Command Line Interface (AWS SAMCLI)`sam publish`.

Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)

La `sam publish` commande publie une AWS SAM application dans le AWS Serverless Application Repository. Cette commande prend un AWS SAM modèle empaqueté et publie l'application dans la AWS région spécifiée.

La `sam publish` commande s'attend à ce que le AWS SAM modèle inclue une `Metadata` section contenant les métadonnées d'application requises pour la publication. Dans la section `Metadata`, les propriétés `LicenseUrl` et `ReadmeUrl` doivent faire référence aux compartiments Amazon Simple Storage Service (Amazon S3) et non pas aux fichiers locaux. Pour plus d'informations sur la `Metadata` section du AWS SAM modèle, consultez[Publier votre candidature à l'aide du AWS SAMCLI](serverless-sam-template-publishing-applications.md).

Par défaut, `sam publish` crée l’application comme privée. Avant que d’autres comptes AWS soient autorisés à visualiser et à déployer l’application, vous devez la partager. Pour plus d’informations sur le partage de l’application, consultez [Exemples de stratégies basées sur les ressources AWS Serverless Application Repository](https://docs.aws.amazon.com/serverlessrepo/latest/devguide/security_iam_resource-based-policy-examples.html) dans le *Guide du développeur AWS Serverless Application Repository *.

**Note**  
Actuellement `sam publish` ne prend pas en charge la publication d’applications imbriquées qui sont spécifiées localement. Si votre application contient des applications imbriquées, vous devez les publier séparément dans l'application parent AWS Serverless Application Repository avant de publier.

## Usage
<a name="sam-cli-command-reference-sam-publish-usage"></a>

```
$ sam publish <options>
```

## Options
<a name="sam-cli-command-reference-sam-publish-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-publish-options-config-env"></a>
Le nom d’environnement spécifiant les valeurs de paramètre par défaut dans le fichier de configuration à utiliser. La valeur par défaut est « par défaut ». Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-publish-options-config-file"></a>
Le chemin d’accès et le nom du fichier de configuration contenant les valeurs de paramètres par défaut à utiliser. La valeur par défaut est « `samconfig.toml` » dans la racine du répertoire du projet. Pour plus d’informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-publish-options-debug"></a>
Active la journalisation de débogage pour imprimer les messages de débogage générés par la CLI  AWS SAM et pour afficher les horodatages.

`--help`  <a name="sam-cli-command-reference-sam-publish-options-help"></a>
Affiche ce message, puis se ferme.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-publish-options-profile"></a>
Le profil spécifique de votre fichier d'informations d'identification qui obtient les AWS informations d'identification.

`--region TEXT`  <a name="sam-cli-command-reference-sam-publish-options-region"></a>
La AWS région dans laquelle le déploiement doit être effectué. Par exemple, us-east-1.

`--save-params`  <a name="sam-cli-command-reference-sam-publish-options-save-params"></a>
Enregistrez les paramètres que vous fournissez sur la ligne de commande dans le fichier AWS SAM de configuration.

`--semantic-version TEXT`  <a name="sam-cli-command-reference-sam-publish-options-semantic-version"></a>
(Facultatif) Utilisez cette option pour fournir une version sémantique de l’application qui remplace la propriété `SemanticVersion` dans la section `Metadata` du fichier modèle. Pour obtenir la spécification de gestion sémantique des versions, veuillez consulter le site web de la [Gestion sémantique des versions](https://semver.org/).

`--template, -t PATH`  <a name="sam-cli-command-reference-sam-publish-options-template"></a>
Le chemin du fichier AWS SAM modèle`[default: template.[yaml|yml]]`.

## Exemples
<a name="sam-cli-command-reference-sam-publish-examples"></a>

Pour publier une application, procédez comme suit :

```
$ sam publish --template packaged.yaml --region us-east-1
```

# sam remote callback
<a name="sam-cli-command-reference-sam-remote-callback"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model commande Command Line Interface (AWS SAMCLI)`sam remote callback`.

Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)

La `sam remote callback` commande vous permet d'envoyer des rappels à des exécutions de fonctions durables à distance exécutées dans AWS Lambda.

**Note**  
Ces commandes nécessitent l'accès aux AWS informations d'identification.

## Usage
<a name="sam-cli-command-reference-sam-remote-callback-usage"></a>

```
$ sam remote callback <subcommand> <options>
```

## Options
<a name="sam-cli-command-reference-sam-remote-callback-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-sam-remote-callback-options-help"></a>
Affichez ce message et quittez.

## Sous-commandes
<a name="sam-cli-command-reference-sam-remote-callback-subcommands"></a>

`succeed`  <a name="sam-cli-command-reference-sam-remote-callback-subcommands-succeed"></a>
Envoyez un rappel réussi à une exécution de fonction durable à distance. Pour de plus amples informations, veuillez consulter [sam remote callback succeed](sam-cli-command-reference-sam-remote-callback-succeed.md).

`fail`  <a name="sam-cli-command-reference-sam-remote-callback-subcommands-fail"></a>
Envoie un échec de rappel à l'exécution d'une fonction durable à distance. Pour de plus amples informations, veuillez consulter [sam remote callback fail](sam-cli-command-reference-sam-remote-callback-fail.md).

`heartbeat`  <a name="sam-cli-command-reference-sam-remote-callback-subcommands-heartbeat"></a>
Envoie un rythme cardiaque de rappel à une exécution de fonction durable à distance. Pour de plus amples informations, veuillez consulter [sam remote callback heartbeat](sam-cli-command-reference-sam-remote-callback-heartbeat.md).

# sam remote callback succeed
<a name="sam-cli-command-reference-sam-remote-callback-succeed"></a>

Envoyez un rappel réussi à une exécution de fonction durable à distance.

**Note**  
Cette commande nécessite l'accès aux AWS informations d'identification.

## Usage
<a name="ref-sam-cli-remote-callback-succeed-usage"></a>

```
$ sam remote callback succeed CALLBACK_ID [OPTIONS]
```

## Arguments obligatoires
<a name="ref-sam-cli-remote-callback-succeed-arguments"></a>

`CALLBACK_ID`  
Identifiant unique du rappel auquel envoyer une réponse positive.

## Options
<a name="ref-sam-cli-remote-callback-succeed-options"></a>

`-r, --result TEXT`  
Charge utile du résultat de réussite sous forme de chaîne.

`--region TEXT`  
Définissez la AWS région du service (par exemple,`us-east-1`).

`--profile TEXT`  
Sélectionnez un profil spécifique dans votre fichier d'informations d'identification pour obtenir des AWS informations d'identification.

`--config-env TEXT`  
Nom de l'environnement spécifiant les valeurs des paramètres par défaut dans le fichier de configuration. Valeur par défaut : `default`

`--config-file TEXT`  
Fichier de configuration contenant les valeurs des paramètres par défaut. Valeur par défaut : `samconfig.toml`

`--save-params`  
Enregistrez les paramètres fournis via la ligne de commande dans le fichier de configuration.

`--beta-features / --no-beta-features`  
Activer/désactiver les fonctionnalités bêta.

`--debug`  
Activez la journalisation du débogage pour imprimer les messages de débogage générés par la AWS SAM CLI et afficher les horodatages.

`-h, --help`  
Affiche ce message, puis se ferme.

## Exemples
<a name="ref-sam-cli-remote-callback-succeed-examples"></a>

Envoyer un rappel de réussite sans résultat :

```
$ sam remote callback succeed my-callback-id
```

Envoyer un rappel de réussite avec le résultat :

```
$ sam remote callback succeed my-callback-id --result 'Task completed successfully'
```

# sam remote callback fail
<a name="sam-cli-command-reference-sam-remote-callback-fail"></a>

Envoie un échec de rappel à l'exécution d'une fonction durable à distance.

**Note**  
Cette commande nécessite l'accès aux AWS informations d'identification.

## Usage
<a name="ref-sam-cli-remote-callback-fail-usage"></a>

```
$ sam remote callback fail CALLBACK_ID [OPTIONS]
```

## Arguments obligatoires
<a name="ref-sam-cli-remote-callback-fail-arguments"></a>

`CALLBACK_ID`  
Identifiant unique du rappel auquel envoyer une réponse d'échec.

## Options
<a name="ref-sam-cli-remote-callback-fail-options"></a>

`--error-data TEXT`  
Données d'erreur supplémentaires.

`--stack-trace TEXT`  
Empilez les entrées de suivi. Cette option peut être spécifiée plusieurs fois.

`--error-type TEXT`  
Type d'erreur.

`--error-message TEXT`  
Message d'erreur détaillé.

`--region TEXT`  
Définissez la AWS région du service (par exemple,`us-east-1`).

`--profile TEXT`  
Sélectionnez un profil spécifique dans votre fichier d'informations d'identification pour obtenir des AWS informations d'identification.

`--config-env TEXT`  
Nom de l'environnement spécifiant les valeurs des paramètres par défaut dans le fichier de configuration. Valeur par défaut : `default`

`--config-file TEXT`  
Fichier de configuration contenant les valeurs des paramètres par défaut. Valeur par défaut : `samconfig.toml`

`--save-params`  
Enregistrez les paramètres fournis via la ligne de commande dans le fichier de configuration.

`--beta-features / --no-beta-features`  
Activer/désactiver les fonctionnalités bêta.

`--debug`  
Activez la journalisation du débogage pour imprimer les messages de débogage générés par la AWS SAM CLI et afficher les horodatages.

`-h, --help`  
Affiche ce message, puis se ferme.

## Exemples
<a name="ref-sam-cli-remote-callback-fail-examples"></a>

Envoyer un rappel en cas d'échec sans paramètres :

```
$ sam remote callback fail my-callback-id
```

Envoyer un rappel d'échec avec un message d'erreur :

```
$ sam remote callback fail my-callback-id --error-message 'Task failed'
```

Envoyer un rappel en cas d'échec avec tous les paramètres :

```
$ sam remote callback fail my-callback-id --error-message 'Task failed' --error-type 'ValidationError' --stack-trace 'at line 42' --error-data '{"code": 500}'
```

# sam remote callback heartbeat
<a name="sam-cli-command-reference-sam-remote-callback-heartbeat"></a>

Envoie un rythme cardiaque de rappel à une exécution de fonction durable à distance.

**Note**  
Cette commande nécessite l'accès aux AWS informations d'identification.

## Usage
<a name="ref-sam-cli-remote-callback-heartbeat-usage"></a>

```
$ sam remote callback heartbeat CALLBACK_ID [OPTIONS]
```

## Arguments obligatoires
<a name="ref-sam-cli-remote-callback-heartbeat-arguments"></a>

`CALLBACK_ID`  
Identifiant unique du rappel auquel envoyer un battement de cœur.

## Options
<a name="ref-sam-cli-remote-callback-heartbeat-options"></a>

`--region TEXT`  
Définissez la AWS région du service (par exemple,`us-east-1`).

`--profile TEXT`  
Sélectionnez un profil spécifique dans votre fichier d'informations d'identification pour obtenir des AWS informations d'identification.

`--config-env TEXT`  
Nom de l'environnement spécifiant les valeurs des paramètres par défaut dans le fichier de configuration. Valeur par défaut : `default`

`--config-file TEXT`  
Fichier de configuration contenant les valeurs des paramètres par défaut. Valeur par défaut : `samconfig.toml`

`--save-params`  
Enregistrez les paramètres fournis via la ligne de commande dans le fichier de configuration.

`--beta-features / --no-beta-features`  
Activer/désactiver les fonctionnalités bêta.

`--debug`  
Activez la journalisation du débogage pour imprimer les messages de débogage générés par la AWS SAM CLI et afficher les horodatages.

`-h, --help`  
Affiche ce message, puis se ferme.

## Exemples
<a name="ref-sam-cli-remote-callback-heartbeat-examples"></a>

Envoyer un rappel du rythme cardiaque :

```
$ sam remote callback heartbeat my-callback-id
```

# sam remote execution
<a name="sam-cli-command-reference-sam-remote-execution"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model commande Command Line Interface (AWS SAMCLI)`sam remote execution`.

Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)

La `sam remote execution` commande vous permet de gérer et d'inspecter les exécutions de fonctions durables à distance exécutées dans AWS Lambda.

**Note**  
Ces commandes nécessitent l'accès aux AWS informations d'identification.

## Usage
<a name="sam-cli-command-reference-sam-remote-execution-usage"></a>

```
$ sam remote execution <subcommand> <options>
```

## Options
<a name="sam-cli-command-reference-sam-remote-execution-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-sam-remote-execution-options-help"></a>
Affichez ce message et quittez.

## Sous-commandes
<a name="sam-cli-command-reference-sam-remote-execution-subcommands"></a>

`get`  <a name="sam-cli-command-reference-sam-remote-execution-subcommands-get"></a>
Découvrez les détails d'une exécution durable. Pour de plus amples informations, veuillez consulter [sam remote execution get](sam-cli-command-reference-sam-remote-execution-get.md).

`history`  <a name="sam-cli-command-reference-sam-remote-execution-subcommands-history"></a>
Obtenez l'historique d'exécution d'une fonction durable. Pour de plus amples informations, veuillez consulter [sam remote execution history](sam-cli-command-reference-sam-remote-execution-history.md).

`stop`  <a name="sam-cli-command-reference-sam-remote-execution-subcommands-stop"></a>
Arrêtez l'exécution d'une fonction durable. Pour de plus amples informations, veuillez consulter [sam remote execution stop](sam-cli-command-reference-sam-remote-execution-stop.md).

# sam remote execution get
<a name="sam-cli-command-reference-sam-remote-execution-get"></a>

Récupérez les détails de l'exécution d'une fonction durable spécifique à partir de AWS Lambda.

L'ARN d'exécution doit être au format renvoyé par Invoke ou se trouver dans les journaux d'exécution.

**Note**  
Cette commande nécessite l'accès aux AWS informations d'identification.

## Usage
<a name="ref-sam-cli-remote-execution-get-usage"></a>

```
$ sam remote execution get DURABLE_EXECUTION_ARN [OPTIONS]
```

## Arguments obligatoires
<a name="ref-sam-cli-remote-execution-get-arguments"></a>

`DURABLE_EXECUTION_ARN`  
Le nom de ressource Amazon (ARN) de la fonction durable à exécuter pour laquelle vous souhaitez obtenir des informations.

## Options
<a name="ref-sam-cli-remote-execution-get-options"></a>

`--format [summary|json]`  
Format de la sortie. Valeur par défaut : `summary`

`--region TEXT`  
Définissez la AWS région du service (par exemple,`us-east-1`).

`--profile TEXT`  
Sélectionnez un profil spécifique dans votre fichier d'informations d'identification pour obtenir des AWS informations d'identification.

`--config-env TEXT`  
Nom de l'environnement spécifiant les valeurs des paramètres par défaut dans le fichier de configuration. Valeur par défaut : `default`

`--config-file TEXT`  
Fichier de configuration contenant les valeurs des paramètres par défaut. Valeur par défaut : `samconfig.toml`

`--save-params`  
Enregistrez les paramètres fournis via la ligne de commande dans le fichier de configuration.

`--beta-features / --no-beta-features`  
Activer/désactiver les fonctionnalités bêta.

`--debug`  
Activez la journalisation du débogage pour imprimer les messages de débogage générés par la AWS SAM CLI et afficher les horodatages.

`-h, --help`  
Affiche ce message, puis se ferme.

## Exemples
<a name="ref-sam-cli-remote-execution-get-examples"></a>

Obtenez les détails de l'exécution avec le format de résumé par défaut :

```
$ sam remote execution get 'arn:aws:lambda:us-east-1:123456789012:function:my-function:$LATEST/durable-execution/c63eec67-3415-4eb4-a495-116aa3a86278/1d454231-a3ad-3694-aa03-c917c175db55'
```

Obtenez les détails de l'exécution au format JSON :

```
$ sam remote execution get 'arn:aws:lambda:us-east-1:123456789012:function:my-function:$LATEST/durable-execution/c63eec67-3415-4eb4-a495-116aa3a86278/1d454231-a3ad-3694-aa03-c917c175db55' --format json
```

**Note**  
Vous devez vous assurer que les caractères de contrôle de l'ARN d'exécution `$` sont correctement échappés lorsque vous utilisez des commandes shell.

# sam remote execution history
<a name="sam-cli-command-reference-sam-remote-execution-history"></a>

Récupérez l'historique d'exécution d'une fonction durable spécifique à partir de AWS Lambda.

L'ARN d'exécution doit être au format renvoyé par StartDurableExecution ou trouvé dans les journaux d'exécution.

**Note**  
Cette commande nécessite l'accès aux AWS informations d'identification.

## Usage
<a name="ref-sam-cli-remote-execution-history-usage"></a>

```
$ sam remote execution history DURABLE_EXECUTION_ARN [OPTIONS]
```

## Arguments obligatoires
<a name="ref-sam-cli-remote-execution-history-arguments"></a>

`DURABLE_EXECUTION_ARN`  
Le nom de ressource Amazon (ARN) de la fonction durable dont vous souhaitez récupérer l'historique.

## Options
<a name="ref-sam-cli-remote-execution-history-options"></a>

`--format [table|json]`  
Format de la sortie. Valeur par défaut : `table`

`--region TEXT`  
Définissez la AWS région du service (par exemple,`us-east-1`).

`--profile TEXT`  
Sélectionnez un profil spécifique dans votre fichier d'informations d'identification pour obtenir des AWS informations d'identification.

`--config-env TEXT`  
Nom de l'environnement spécifiant les valeurs des paramètres par défaut dans le fichier de configuration. Valeur par défaut : `default`

`--config-file TEXT`  
Fichier de configuration contenant les valeurs des paramètres par défaut. Valeur par défaut : `samconfig.toml`

`--save-params`  
Enregistrez les paramètres fournis via la ligne de commande dans le fichier de configuration.

`--beta-features / --no-beta-features`  
Activer/désactiver les fonctionnalités bêta.

`--debug`  
Activez la journalisation du débogage pour imprimer les messages de débogage générés par la AWS SAM CLI et afficher les horodatages.

`-h, --help`  
Affiche ce message, puis se ferme.

## Exemples
<a name="ref-sam-cli-remote-execution-history-examples"></a>

Obtenez l'historique des exécutions avec le format de tableau par défaut :

```
$ sam remote execution history arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id
```

Obtenez l'historique des exécutions au format JSON :

```
$ sam remote execution history arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id --format json
```

# sam remote execution stop
<a name="sam-cli-command-reference-sam-remote-execution-stop"></a>

Arrêtez l'exécution d'une fonction durable en cours d'exécution dans AWS Lambda.

L'ARN d'exécution doit être au format renvoyé StartDurableExecution ou trouvé dans les journaux d'exécution.

**Note**  
Cette commande nécessite l'accès aux AWS informations d'identification.

## Usage
<a name="ref-sam-cli-remote-execution-stop-usage"></a>

```
$ sam remote execution stop DURABLE_EXECUTION_ARN [OPTIONS]
```

## Arguments obligatoires
<a name="ref-sam-cli-remote-execution-stop-arguments"></a>

`DURABLE_EXECUTION_ARN`  
L'Amazon Resource Name (ARN) de l'exécution de la fonction durable à arrêter.

## Options
<a name="ref-sam-cli-remote-execution-stop-options"></a>

`--error-message TEXT`  
Message d'erreur à associer à l'arrêt de l'exécution.

`--error-type TEXT`  
Type d'erreur à associer à l'arrêt de l'exécution.

`--error-data TEXT`  
Données d'erreur à associer à l'exécution arrêtée.

`--stack-trace TEXT`  
Empilez les entrées de suivi. Cette option peut être spécifiée plusieurs fois.

`--region TEXT`  
Définissez la AWS région du service (par exemple,`us-east-1`).

`--profile TEXT`  
Sélectionnez un profil spécifique dans votre fichier d'informations d'identification pour obtenir des AWS informations d'identification.

`--config-env TEXT`  
Nom de l'environnement spécifiant les valeurs des paramètres par défaut dans le fichier de configuration. Valeur par défaut : `default`

`--config-file TEXT`  
Fichier de configuration contenant les valeurs des paramètres par défaut. Valeur par défaut : `samconfig.toml`

`--save-params`  
Enregistrez les paramètres fournis via la ligne de commande dans le fichier de configuration.

`--beta-features / --no-beta-features`  
Activer/désactiver les fonctionnalités bêta.

`--debug`  
Activez la journalisation du débogage pour imprimer les messages de débogage générés par la AWS SAM CLI et afficher les horodatages.

`-h, --help`  
Affiche ce message, puis se ferme.

## Exemples
<a name="ref-sam-cli-remote-execution-stop-examples"></a>

Arrêtez l'exécution sans détails sur l'erreur :

```
$ sam remote execution stop arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id
```

Arrêtez l'exécution avec un message d'erreur et tapez :

```
$ sam remote execution stop arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id --error-message "Execution cancelled" --error-type "UserCancellation"
```

Arrêtez l'exécution en indiquant tous les détails de l'erreur et en enregistrant la trace :

```
$ sam remote execution stop arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id --error-message "Task failed" --error-type "TaskFailure" --error-data '{"reason":"timeout"}' --stack-trace "at function1()" --stack-trace "at function2()"
```

# sam remote invoke
<a name="sam-cli-command-reference-remote-invoke"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model commande Command Line Interface (AWS SAMCLI)`sam remote invoke`.
+ Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)
+ Pour obtenir de la documentation sur l'utilisation de la AWS SAMCLI `sam remote invoke` commande, consultez[Présentation des tests dans le cloud avec sam remote invoke](using-sam-cli-remote-invoke.md).

La `sam remote invoke` commande invoque les ressources prises en charge dans le AWS Cloud.

## Usage
<a name="sam-cli-command-reference-remote-invoke-usage"></a>

```
$ sam remote invoke <arguments> <options>
```

## Arguments
<a name="sam-cli-command-reference-remote-invoke-args"></a>

**ID de ressource**  <a name="sam-cli-command-reference-remote-invoke-args-resource-id"></a>
L'ID de la ressource prise en charge à invoquer.  
Cet argument accepte les valeurs suivantes :  
+ **Amazon Resource Name (ARN)** — L'ARN de la ressource.
**Astuce**  
`sam list stack-outputs --stack-name <stack-name>`À utiliser pour obtenir l'ARN de vos ressources.
+ **ID logique** — Identifiant logique de la ressource. Vous devez également fournir le nom de la AWS CloudFormation pile à l'aide de l'`--stack-name`option.
+ **Identifiant physique** — Identifiant physique de la ressource. Cet ID est créé lorsque vous déployez une ressource à l'aide de CloudFormation.
**Astuce**  
`sam list resources --stack-name <stack-name>`À utiliser pour obtenir l'identifiant physique de vos ressources.  
**Lorsque vous fournissez un ARN ou un identifiant physique :**  
Si vous fournissez un ARN ou un identifiant physique, ne fournissez pas de nom de pile. Lorsque le nom de la pile est fourni à l'aide de l'`--stack-name`option, ou lorsque le nom de la pile est défini dans votre fichier de configuration, votre identifiant de ressource AWS SAM CLI sera automatiquement traité comme une valeur d'identifiant logique issue de la CloudFormation pile.  
**Lorsque vous ne fournissez pas d'ID de ressource :**  
Si vous ne fournissez pas d'ID de ressource, mais que vous fournissez un nom de pile avec l'`--stack-name`option, la AWS SAM CLI essaiera d'invoquer automatiquement une ressource dans votre CloudFormation pile en utilisant la logique suivante :  

1. Ils AWS SAM CLI identifieront les types de ressources dans l'ordre suivant et passeront à l'étape suivante une fois que le type de ressource aura été trouvé dans votre pile :

   1. Lambda

   1. Step Functions

   1. Amazon SQS

   1. Kinesis Data Streams

1. Si le type de ressource ne contient qu'une seule ressource dans votre pile, il l' AWS SAM CLIinvoquera. Si plusieurs ressources du type de ressource existent dans votre pile, une erreur AWS SAM CLI sera renvoyée.
Voici des exemples de ce qu'ils AWS SAM CLI feront :  
+ **Pile contenant deux fonctions Lambda et une file d'attente Amazon SQS : elle localisera AWS SAM CLI le type de ressource Lambda et renverra une erreur puisque la pile** contient plusieurs fonctions Lambda.
+ **Pile contenant une fonction Lambda et deux applications Amazon Kinesis Data Streams** : elle AWS SAM CLI localisera la fonction Lambda et l'invoquera, car la pile contient une seule ressource Lambda.
+ **Pile contenant une seule file d'attente Amazon SQS et deux applications Kinesis Data Streams. Elle AWS SAM CLI localisera la file d'attente Amazon SQS et l'invoquera, car la pile** contient une seule file d'attente Amazon SQS.

## Options
<a name="sam-cli-command-reference-remote-invoke-options"></a>

`--beta-features | --no-beta-features`  <a name="sam-cli-command-reference-remote-invoke-options-beta-features"></a>
Autorisez ou refusez les fonctionnalités bêta.

`--config-env TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-config-env"></a>
Spécifiez l'environnement à utiliser à partir de votre fichier de configuration CLI  AWS SAM.  
*Par défaut* : `default`

`--config-file FILENAME`  <a name="sam-cli-command-reference-remote-invoke-options-config-file"></a>
Spécifiez le nom de votre compartiment et le nom du fichier de configuration.  
Pour plus d'informations sur les fichiers de configuration, consultez [Configuration de la CLI  AWS SAM](using-sam-cli-configure.md).  
*Par défaut* : `samconfig.toml` à la racine du répertoire de votre projet. 

`--debug`  <a name="sam-cli-command-reference-remote-invoke-options-debug"></a>
Activez la journalisation des débogues. Cela imprime les messages de débogage et les horodatages générés par la CLI  AWS SAM.

`--event, -e TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-event"></a>
L'événement à envoyer à la ressource cible.

`--event-file FILENAME`  <a name="sam-cli-command-reference-remote-invoke-options-event-file"></a>
Le chemin d'accès à un fichier contenant l'événement à envoyer à la ressource cible.

`--help, -h`  <a name="sam-cli-command-reference-remote-invoke-options-help"></a>
Affichez le message d'aide, puis fermez.

`--output [ text | json ]`  <a name="sam-cli-command-reference-remote-invoke-options-output"></a>
Exportez les résultats de votre invocation dans un format de sortie spécifique.  
`json`— Les métadonnées de la demande et la réponse aux ressources sont renvoyées dans la structure JSON. La réponse contient la sortie complète du SDK.  
`text`— Les métadonnées de la demande sont renvoyées sous forme de texte. La réponse à la ressource est renvoyée dans le format de sortie de la ressource invoquée.

`--parameter`  <a name="sam-cli-command-reference-remote-invoke-options-parameter"></a>
Paramètres supplémentaires [https://boto3.amazonaws.com/v1/documentation/api/latest/index.html](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html) que vous pouvez transmettre à la ressource invoquée.    
**Amazon Kinesis Data Streams**  <a name="sam-cli-command-reference-remote-invoke-options-parameter-kinesis"></a>
Les paramètres supplémentaires suivants peuvent être utilisés pour placer un enregistrement dans le flux de données Kinesis :  
+ `ExplicitHashKey='string'`
+ `PartitionKey='string'`
+ `SequenceNumberForOrdering='string'`
+ `StreamARN='string'`
Pour une description de chaque paramètre, consultez [Kinesis.client.PUT\$1RECORD](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/kinesis/client/put_record.html).  
**AWS Lambda**  <a name="sam-cli-command-reference-remote-invoke-options-parameter-lambda"></a>
Les paramètres supplémentaires suivants peuvent être utilisés pour appeler une ressource Lambda et recevoir une réponse mise en mémoire tampon :  
+ `ClientContext='base64-encoded string'`
+ `InvocationType='[ DryRun | Event | RequestResponse ]'`
+ `LogType='[ None | Tail ]'`
+ `Qualifier='string'`
Les paramètres supplémentaires suivants peuvent être utilisés pour appeler une ressource Lambda avec diffusion des réponses :  
+ `ClientContext='base64-encoded string'`
+ `InvocationType='[ DryRun | RequestResponse ]'`
+ `LogType='[ None | Tail ]'`
+ `Qualifier='string'`
Pour obtenir une description de chaque paramètre, consultez les rubriques suivantes :  
+ Lambda avec réponse mise en mémoire tampon — [Lambda.Client.Invoke](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/lambda/client/invoke.html)
+ Lambda avec diffusion de réponses — [Lambda.Client.Invoke\$1With\$1Response\$1Stream](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/lambda/client/invoke_with_response_stream.html)  
**Amazon Simple Queue Service (Amazon SQS)**  <a name="sam-cli-command-reference-remote-invoke-options-parameter-sqs"></a>
Les paramètres supplémentaires suivants peuvent être utilisés pour envoyer un message à une file d'attente Amazon SQS :  
+ `DelaySeconds=integer`
+ `MessageAttributes='json string'`
+ `MessageDeduplicationId='string'`
+ `MessageGroupId='string'`
+ `MessageSystemAttributes='json string'`
Pour une description de chaque paramètre, consultez [SQS.Client.Send\$1Message](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sqs/client/send_message.html).  
**AWS Step Functions**  <a name="sam-cli-command-reference-remote-invoke-options-parameter-sf"></a>
Les paramètres supplémentaires suivants peuvent être utilisés pour démarrer l'exécution d'une machine à états :  
+ `name='string'`
+ `traceHeader='string'`
Pour une description de chaque paramètre, consultez [SFN.Client.Start\$1Execution](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/stepfunctions/client/start_execution.html).

`--profile TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-profile"></a>
Le profil spécifique de votre fichier d'informations d'identification pour obtenir des AWS informations d'identification.

`--region TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-region"></a>
Le Région AWS de la ressource. Par exemple, `us-east-1`.

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-stack-name"></a>
Nom de la CloudFormation pile à laquelle appartient la ressource.

`--tenant-id TEXT`  <a name="ref-sam-cli-local-invoke-options-tenancyconfig"></a>
L'ID de locataire pour les fonctions Lambda à locataires multiples. Utilisé pour garantir l'isolation informatique entre les différents locataires. Obligatoire lors de l'appel de fonctions configurées avec le mode d'isolation des locataires.

`--test-event-name NAME`  <a name="sam-cli-command-reference-remote-invoke-options-test-event-name"></a>
Nom de l'événement de test partageable à transmettre à votre fonction Lambda.  
Cette option ne prend en charge que les fonctions Lambda.

## Exemple
<a name="sam-cli-command-reference-remote-invoke-examples"></a>

L'exemple suivant invoque les ressources prises en charge dans le AWS Cloud et active la journalisation du débogage, qui imprime les messages de débogage et les horodatages générés par : AWS SAMCLI

```
$ sam remote invoke--debug
```

# sam remote test-event
<a name="sam-cli-command-reference-remote-test-event"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model commande Command Line Interface (AWS SAMCLI)`sam remote test-event`.
+ Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)
+ Pour obtenir de la documentation sur l'utilisation de la AWS SAMCLI `sam remote test-event` commande, consultez[Présentation des tests dans le cloud avec sam remote test-event](using-sam-cli-remote-test-event.md).

La `sam remote test-event` commande interagit avec les événements de test partageables dans le registre des EventBridge schémas Amazon.

## Usage
<a name="sam-cli-command-reference-remote-test-event-usage"></a>

```
$ sam remote test-event <options> <subcommand>
```

## Options
<a name="sam-cli-command-reference-remote-test-event-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-remote-invoke-options-help"></a>
Affichez le message d'aide, puis fermez.

## Sous-commandes
<a name="sam-cli-command-reference-remote-test-event-subcommands"></a>

`delete`  
Supprimez un événement de test partageable du registre des EventBridge schémas. Pour plus d'informations de référence, consultez [sam remote test-event delete](sam-cli-command-reference-remote-test-event-delete.md).

`get`  
Obtenez un événement de test partageable à partir du registre des EventBridge schémas. Pour plus d'informations de référence, consultez [sam remote test-event get](sam-cli-command-reference-remote-test-event-get.md).

`list`  
Répertoriez les événements de test partageables existants pour une AWS Lambda fonction. Pour plus d'informations de référence, consultez [sam remote test-event list](sam-cli-command-reference-remote-test-event-list.md).

`put`  
Enregistrez un événement depuis un fichier local dans le registre des EventBridge schémas. Pour plus d'informations de référence, consultez [sam remote test-event put](sam-cli-command-reference-remote-test-event-put.md).

# sam remote test-event delete
<a name="sam-cli-command-reference-remote-test-event-delete"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model `sam remote test-event delete` sous-commande Command Line Interface (AWS SAMCLI).
+ Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)
+ Pour obtenir de la documentation sur l'utilisation de la AWS SAMCLI `sam remote test-event` commande, consultez[Présentation des tests dans le cloud avec sam remote test-event](using-sam-cli-remote-test-event.md).

La `sam remote test-event delete` sous-commande supprime un événement de test partageable du registre des schémas Amazon EventBridge .

## Usage
<a name="sam-cli-command-reference-remote-test-event-delete-usage"></a>

```
$ sam remote test-event delete <arguments> <options>
```

## Arguments
<a name="sam-cli-command-reference-remote-test-event-delete-args"></a>

**ID de ressource**  <a name="sam-cli-command-reference-remote-test-event-delete-args-resource-id"></a>
ID de la AWS Lambda fonction associée à l'événement de test partageable.  
Si vous fournissez un identifiant logique, vous devez également fournir une valeur pour la AWS CloudFormation pile associée à la fonction Lambda à l'aide de l'`--stack-name`option.  
*Valeurs valides* : ID logique ou ARN de la ressource.

## Options
<a name="sam-cli-command-reference-remote-test-event-delete-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-remote-test-event-delete-options-config-env"></a>
Le nom d’environnement spécifiant les valeurs de paramètre par défaut dans le fichier de configuration à utiliser. La valeur par défaut est « par défaut ». Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-remote-test-event-delete-options-config-file"></a>
Le chemin d’accès et le nom du fichier de configuration contenant les valeurs de paramètres par défaut à utiliser. La valeur par défaut est « `samconfig.toml` » dans la racine du répertoire du projet. Pour plus d’informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--help, -h`  <a name="sam-cli-command-reference-remote-test-event-delete-options-help"></a>
Affichez le message d'aide, puis fermez.

`--name TEXT`  <a name="sam-cli-command-reference-remote-test-event-delete-options-name"></a>
Nom de l'événement de test partageable à supprimer.

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-test-event-delete-options-stack-name"></a>
Nom de la CloudFormation pile associée à la fonction Lambda.  
Cette option est obligatoire si vous fournissez l'ID logique de la fonction Lambda en tant qu'argument.

# sam remote test-event get
<a name="sam-cli-command-reference-remote-test-event-get"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model `sam remote test-event get` sous-commande Command Line Interface (AWS SAMCLI).
+ Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)
+ Pour obtenir de la documentation sur l'utilisation de la AWS SAMCLI `sam remote test-event` commande, consultez[Présentation des tests dans le cloud avec sam remote test-event](using-sam-cli-remote-test-event.md).

La `sam remote test-event get` sous-commande obtient un événement de test partageable depuis le registre des EventBridge schémas Amazon.

## Usage
<a name="sam-cli-command-reference-remote-test-event-get-usage"></a>

```
$ sam remote test-event get <arguments> <options>
```

## Arguments
<a name="sam-cli-command-reference-remote-test-event-get-args"></a>

**ID de ressource**  <a name="sam-cli-command-reference-remote-test-event-get-args-resource-id"></a>
L'ID de la AWS Lambda fonction associée à l'événement de test partageable à obtenir.  
Si vous fournissez un identifiant logique, vous devez également fournir une valeur pour la AWS CloudFormation pile associée à la fonction Lambda à l'aide de l'`--stack-name`option.  
*Valeurs valides* : ID logique ou ARN de la ressource.

## Options
<a name="sam-cli-command-reference-remote-test-event-get-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-remote-test-event-get-options-config-env"></a>
Le nom d’environnement spécifiant les valeurs de paramètre par défaut dans le fichier de configuration à utiliser. La valeur par défaut est « par défaut ». Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-remote-test-event-get-options-config-file"></a>
Le chemin d’accès et le nom du fichier de configuration contenant les valeurs de paramètres par défaut à utiliser. La valeur par défaut est « `samconfig.toml` » dans la racine du répertoire du projet. Pour plus d’informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--help, -h`  <a name="sam-cli-command-reference-remote-test-event-get-options-help"></a>
Affichez le message d'aide, puis fermez.

`--name TEXT`  <a name="sam-cli-command-reference-remote-test-event-get-options-name"></a>
Nom de l'événement de test partageable à obtenir.

`--output-file FILENAME`  <a name="sam-cli-command-reference-remote-test-event-get-options-output-file"></a>
Chemin et nom du fichier dans lesquels enregistrer l'événement sur votre ordinateur local.  
Si vous ne fournissez pas cette option, le contenu de l'événement de test partageable AWS SAM CLI sera affiché sur votre console.

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-test-event-get-options-stack-name"></a>
Nom de la CloudFormation pile associée à la fonction Lambda.  
Cette option est obligatoire si vous fournissez l'ID logique de la fonction Lambda en tant qu'argument.

# sam remote test-event list
<a name="sam-cli-command-reference-remote-test-event-list"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model `sam remote test-event list` sous-commande Command Line Interface (AWS SAMCLI).
+ Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)
+ Pour obtenir de la documentation sur l'utilisation de la AWS SAMCLI `sam remote test-event` commande, consultez[Présentation des tests dans le cloud avec sam remote test-event](using-sam-cli-remote-test-event.md).

La `sam remote test-event list` sous-commande répertorie les événements de test partageables existants pour une AWS Lambda fonction spécifique à partir du registre des EventBridge schémas Amazon.

## Usage
<a name="sam-cli-command-reference-remote-test-event-list-usage"></a>

```
$ sam remote test-event list <arguments> <options>
```

## Arguments
<a name="sam-cli-command-reference-remote-test-event-list-args"></a>

**ID de ressource**  <a name="sam-cli-command-reference-remote-test-event-list-args-resource-id"></a>
ID de la fonction Lambda associée aux événements de test partageables.  
Si vous fournissez un identifiant logique, vous devez également fournir une valeur pour la AWS CloudFormation pile associée à la fonction Lambda à l'aide de l'`--stack-name`option.  
*Valeurs valides* : ID logique ou ARN de la ressource.

## Options
<a name="sam-cli-command-reference-remote-test-event-list-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-remote-test-event-list-options-config-env"></a>
Le nom d’environnement spécifiant les valeurs de paramètre par défaut dans le fichier de configuration à utiliser. La valeur par défaut est « par défaut ». Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-remote-test-event-list-options-config-file"></a>
Le chemin d’accès et le nom du fichier de configuration contenant les valeurs de paramètres par défaut à utiliser. La valeur par défaut est « `samconfig.toml` » dans la racine du répertoire du projet. Pour plus d’informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--help, -h`  <a name="sam-cli-command-reference-remote-test-event-list-options-help"></a>
Affichez le message d'aide, puis fermez.

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-test-event-list-options-stack-name"></a>
Nom de la CloudFormation pile associée à la fonction Lambda.  
Cette option est obligatoire si vous fournissez l'ID logique de la fonction Lambda en tant qu'argument.

## Exemples
<a name="sam-cli-command-reference-remote-test-event-list-examples"></a>

Pour des exemples d'utilisation de cette commande, reportez-vous à[Liste d'événements de test partageables](using-sam-cli-remote-test-event.md#using-sam-cli-remote-test-event-use-list).

# sam remote test-event put
<a name="sam-cli-command-reference-remote-test-event-put"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model `sam remote test-event put` sous-commande Command Line Interface (AWS SAMCLI).
+ Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)
+ Pour obtenir de la documentation sur l'utilisation de la AWS SAMCLI `sam remote test-event` commande, consultez[Présentation des tests dans le cloud avec sam remote test-event](using-sam-cli-remote-test-event.md).

La `sam remote test-event put` sous-commande enregistre un événement de test partageable depuis votre machine locale dans le registre des EventBridge schémas Amazon.

## Usage
<a name="sam-cli-command-reference-remote-test-event-put-usage"></a>

```
$ sam remote test-event put <arguments> <options>
```

## Arguments
<a name="sam-cli-command-reference-remote-test-event-put-args"></a>

**ID de ressource**  <a name="sam-cli-command-reference-remote-test-event-put-args-resource-id"></a>
ID de la AWS Lambda fonction associée à l'événement de test partageable.  
Si vous fournissez un identifiant logique, vous devez également fournir une valeur pour la AWS CloudFormation pile associée à la fonction Lambda à l'aide de l'`--stack-name`option.  
*Valeurs valides* : ID logique ou ARN de la ressource.

## Options
<a name="sam-cli-command-reference-remote-test-event-put-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-remote-test-event-put-options-config-env"></a>
Le nom d’environnement spécifiant les valeurs de paramètre par défaut dans le fichier de configuration à utiliser. La valeur par défaut est « par défaut ». Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-remote-test-event-put-options-config-file"></a>
Le chemin d’accès et le nom du fichier de configuration contenant les valeurs de paramètres par défaut à utiliser. La valeur par défaut est « `samconfig.toml` » dans la racine du répertoire du projet. Pour plus d’informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--file FILENAME`  <a name="sam-cli-command-reference-remote-test-event-put-options-file"></a>
Chemin et nom du fichier de l'événement sur votre ordinateur local.  
Indiquez `-` comme valeur de nom de fichier à lire à partir de `stdin`.  
Cette option est obligatoire.

`--force`, `-f`  <a name="sam-cli-command-reference-remote-test-event-put-options-force"></a>
Remplacez un événement de test partageable portant le même nom.

`--help, -h`  <a name="sam-cli-command-reference-remote-test-event-put-options-help"></a>
Affichez le message d'aide, puis fermez.

`--name TEXT`  <a name="sam-cli-command-reference-remote-test-event-put-options-name"></a>
Nom sous lequel enregistrer l'événement de test partageable.  
Si un événement de test partageable portant le même nom existe dans le registre du EventBridge schéma, il ne le AWS SAM CLI remplacera pas. Pour le remplacer, ajoutez l'option `--force`.

`--output-file FILENAME`  <a name="sam-cli-command-reference-remote-test-event-put-options-output-file"></a>
Chemin et nom du fichier dans lesquels enregistrer l'événement sur votre ordinateur local.  
Si vous ne fournissez pas cette option, le contenu de l'événement de test partageable AWS SAM CLI sera affiché sur votre console.

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-test-event-put-options-stack-name"></a>
Nom de la CloudFormation pile associée à la fonction Lambda.  
Cette option est obligatoire si vous fournissez l'ID logique de la fonction Lambda en tant qu'argument.

## Exemple
<a name="sam-cli-command-reference-remote-test-event-put-examples"></a>

Pour un exemple d'utilisation de cette commande, reportez-vous à[Enregistrement d'événements de test partageables](using-sam-cli-remote-test-event.md#using-sam-cli-remote-test-event-use-put).

# sam sync
<a name="sam-cli-command-reference-sam-sync"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model commande Command Line Interface (AWS SAMCLI)`sam sync`.
+ Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)
+ Pour obtenir de la documentation sur l'utilisation du AWS SAMCLI, voir[AWS SAM CLI](using-sam-cli.md).

La commande `sam sync` synchronise les modifications apportées de l’application locale à AWS Cloud.

## Usage
<a name="sam-cli-command-reference-sam-sync-usage"></a>

```
$ sam sync <options>
```

## Options
<a name="sam-cli-command-reference-sam-sync-options"></a>

`--base-dir, -s DIRECTORY`  <a name="sam-cli-command-reference-sam-sync-options-base-dir"></a>
Résout les chemins relatifs au code source de la fonction ou de la couche par rapport à ce répertoire. Utilisez cette option pour modifier la façon dont les chemins d'accès relatifs aux dossiers de code source sont résolus. Par défaut, les chemins relatifs sont résolus en fonction de l'emplacement du AWS SAM modèle.  
Outre les ressources de l'application ou de la pile racine que vous créez, cette option s'applique également aux applications ou piles imbriquées. En outre, cette option s'applique aux types de ressources et propriétés suivants :  
+ Type de ressource : propriété `AWS::Serverless::Function` : `CodeUri`
+ Type de ressource : attribut de ressource `AWS::Serverless::Function` : entrée `Metadata` : `DockerContext`
+ Type de ressource : propriété `AWS::Serverless::LayerVersion` : `ContentUri`
+ Type de ressource : propriété `AWS::Lambda::Function` : `Code`
+ Type de ressource : propriété `AWS::Lambda::LayerVersion` : `Content`

`--build-image TEXT`  <a name="sam-cli-command-reference-sam-sync-options-build-image"></a>
L'URI de l'[image de conteneur](serverless-image-repositories.md#serverless-image-repository-uris) que vous souhaitez utiliser lors de la création de votre application. AWS SAM Utilise par défaut l'URI du référentiel d'images de conteneurs provenant d'[Amazon Elastic Container Registry (Amazon ECR) Public](https://docs.aws.amazon.com/AmazonECR/latest/public/what-is-ecr.html). Spécifiez cette option pour utiliser une autre image.  
Vous pouvez utiliser cette option plusieurs fois au sein d'une même commande. Chaque option accepte une chaîne de caractères ou une paire clé-valeur.  
+ **Chaîne de caractères** : si vous spécifiez une chaîne de caractères, il s'agit de l'URI de l'image de conteneur qui sera utilisée par toutes les ressources de l'application. En voici un exemple :

  ```
  $ sam sync --build-image amazon/aws-sam-cli-build-image-python3.8
  ```
+ **Paire clé-valeur** : spécifiez le nom de la ressource comme clé et l'URI de l'image du conteneur à utiliser avec cette ressource comme valeur. Utilisez ce format pour spécifier un URI d'image de conteneur différent pour chaque ressource de votre application. Voici un exemple :

  ```
  $ sam sync --build-image Function1=amazon/aws-sam-cli-build-image-python3.8
  ```
Cette option ne s’applique que si l’option `--use-container` est spécifiée, dans le cas contraire, une erreur se produit.

`--build-in-source | --no-build-in-source`  <a name="sam-cli-command-reference-sam-sync-options-build-in-source"></a>
Fournit `--build-in-source` pour créer votre projet directement dans le dossier source.  
L'option `--build-in-source` prend en charge les systèmes d’exécution ainsi que les méthodes de création suivantes :  
+ **exécutions** : toute méthode d’exécution Node.js prise en charge par l'option `sam init --runtime`.
+ **Méthodes de construction** : `Makefile`, `esbuild`.
L'option `--build-in-source` n'est pas compatible avec celles suivantes :  
+ `--use-container `
*Par défaut* : `--no-build-in-source`

`--capabilities LIST`  <a name="sam-cli-command-reference-sam-sync-options-capabilities"></a>
Liste des fonctionnalités que vous spécifiez pour CloudFormation autoriser la création de certaines piles. Certains modèles de pile peuvent inclure des ressources susceptibles d'affecter les autorisations de votre Compte AWS. Par exemple, en créant de nouveaux utilisateurs Gestion des identités et des accès AWS (IAM). Spécifiez cette option pour remplacer les valeurs par défaut. Les valeurs valides sont les suivantes :  
+ CAPABILITY\$1IAM
+ CAPABILITY\$1NAMED\$1IAM
+ CAPABILITY\$1RESOURCE\$1POLICY
+ CAPABILITY\$1AUTO\$1EXPAND
*Par défaut* : `CAPABILITY_NAMED_IAM` et `CAPABILITY_AUTO_EXPAND`

`--code`  <a name="sam-cli-command-reference-sam-sync-options-code"></a>
Par défaut, AWS SAM synchronise toutes les ressources de votre application. Spécifiez cette option pour synchroniser uniquement les ressources de code, qui comprennent les éléments suivants :  
+ `AWS::Serverless::Function`
+ `AWS::Lambda::Function`
+ `AWS::Serverless::LayerVersion`
+ `AWS::Lambda::LayerVersion`
+ `AWS::Serverless::Api`
+ `AWS::ApiGateway::RestApi`
+ `AWS::Serverless::HttpApi`
+ `AWS::ApiGatewayV2::Api`
+ `AWS::Serverless::StateMachine`
+ `AWS::StepFunctions::StateMachine`
Pour synchroniser les ressources de code, AWS SAM utilise APIs directement le AWS service, au lieu de le déployer via AWS CloudFormation. Pour mettre à jour votre CloudFormation stack, exécutez **sam sync --watch** ou**sam deploy**.

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-sync-options-config-env"></a>
Le nom d’environnement spécifiant les valeurs de paramètre par défaut dans le fichier de configuration à utiliser. La valeur par défaut est « par défaut ». Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-sync-options-config-file"></a>
Le chemin d’accès et le nom du fichier de configuration contenant les valeurs de paramètres par défaut à utiliser. La valeur par défaut est « `samconfig.toml` » dans la racine du répertoire du projet. Pour plus d’informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--dependency-layer | --no-dependency-layer`  <a name="sam-cli-command-reference-sam-sync-options-dependency-layer"></a>
Spécifie s'il faut séparer les dépendances des fonctions individuelles dans une autre couche pour accélérer le processus de synchronisation.  
*Par défaut* : `--dependency-layer`

`--image-repository TEXT`  <a name="sam-cli-command-reference-sam-sync-options-image-repository"></a>
Le nom du référentiel Amazon Elastic Container Registry (Amazon ECR) vers lequel cette commande télécharge l’image de la fonction. Requis pour les fonctions déclarées avec le type de package `Image`.

`--image-repositories TEXT`  <a name="sam-cli-command-reference-sam-sync-options-image-repositories"></a>
Un mappage des fonctions vers l'URI de leur référentiel Amazon ECR. Référencez les fonctions par leur identifiant logique. Voici un exemple :  

```
$ sam sync --image-repositories Function1=123456789012.dkr.ecr.us-east-1.amazonaws.com/my-repo
```
Vous pouvez spécifier cette option plusieurs fois au sein d'une même commande.

`--kms-key-id TEXT`  <a name="sam-cli-command-reference-sam-sync-options-kms-key-id"></a>
L'ID d'une clé AWS Key Management Service (AWS KMS) utilisée pour chiffrer les artefacts inactifs dans le compartiment Amazon S3. Si vous ne spécifiez pas cette option, AWS SAM utilise les clés de chiffrement gérées par Amazon S3.

`--metadata`  <a name="sam-cli-command-reference-sam-sync-options-metadata"></a>
Un mappage de métadonnées à attacher à tous les artefacts que vous référencez dans votre modèle.

`--notification-arns LIST`  <a name="sam-cli-command-reference-sam-sync-options-notification-arns"></a>
Liste des rubriques Amazon Simple Notification Service (Amazon SNS) ARNs associées à la CloudFormation pile.

`--no-use-container`  <a name="ref-sam-cli-sync-options-no-use-container"></a>
Option qui vous permet d'utiliser le kit d'outils IDE pour définir le comportement par défaut.

`--parameter-overrides`  <a name="sam-cli-command-reference-sam-sync-options-parameter-overrides"></a>
Chaîne contenant des remplacements de CloudFormation paramètres codés sous forme de paires clé-valeur. Utilisez le même format que le AWS Command Line Interface (AWS CLI). Le AWS SAMCLI format est basé sur des mots clés et valeurs explicites, chaque remplacement étant séparé par un espace. Voici deux exemples :  
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world`
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world ParameterKey=example1,ParameterValue=example2 ParameterKey=apple,ParameterValue=banana`

`--resource TEXT`  <a name="sam-cli-command-reference-sam-sync-options-resource"></a>
Spécifie le type de ressource à synchroniser. Pour synchroniser plusieurs ressources, vous pouvez spécifier cette option plusieurs fois. Cette option est prise en charge avec l'option `--code`. La valeur doit correspondre à l'une des ressources répertoriées sous `--code`. Par exemple, `--resource AWS::Serverless::Function --resource AWS::Serverless::LayerVersion`.

`--resource-id TEXT`  <a name="sam-cli-command-reference-sam-sync-options-resource-id"></a>
Spécifie l’identifiant de la ressource à synchroniser. Pour synchroniser plusieurs ressources, vous pouvez spécifier cette option plusieurs fois. Cette option est prise en charge avec l'option `--code`. Par exemple, `--resource-id Function1 --resource-id Function2`.

`--role-arn TEXT`  <a name="sam-cli-command-reference-sam-sync-options-role-arn"></a>
Nom de ressource Amazon (ARN) d'un rôle IAM CloudFormation assumé lors de l'application de l'ensemble de modifications.

`--s3-bucket TEXT`  <a name="sam-cli-command-reference-sam-sync-options-s3-bucket"></a>
Nom du compartiment Amazon Simple Storage Service (Amazon S3) dans lequel cette commande télécharge CloudFormation votre modèle. Si le modèle est supérieur à 51 200 octets, le `--s3-bucket` ou l’option `--resolve-s3` sont obligatoires. Si vous spécifiez les deux options `--s3-bucket` et `--resolve-s3`, une erreur se produit.

`--s3-prefix TEXT`  <a name="sam-cli-command-reference-sam-sync-options-s3-prefix"></a>
Le préfixe ajouté aux noms des artefacts que vous chargez dans le compartiment Amazon S3. Le nom du préfixe est un nom de chemin d’accès (nom de dossier) pour le compartiment Amazon S3. Cela s'applique uniquement aux fonctions déclarées avec le type de package `Zip`.

`--save-params`  <a name="sam-cli-command-reference-sam-sync-options-save-params"></a>
Enregistre les paramètres que vous fournissez sur la ligne de commande dans le fichier AWS SAM de configuration.

`--skip-deploy-sync | --no-skip-deploy-sync`  <a name="sam-cli-command-reference-sam-sync-options-skip-deploy-sync"></a>
Spécifie `--skip-deploy-sync` pour ignorer la synchronisation initiale de l'infrastructure si elle n'est pas requise. Le AWS SAMCLI comparera votre AWS SAM modèle local avec le CloudFormation modèle déployé et n'effectuera un déploiement que si une modification est détectée.  
Spécifie `--no-skip-deploy-sync` d'effectuer un CloudFormation déploiement à `sam sync` chaque exécution.  
Pour en savoir plus, veuillez consulter la section [Ignorer le CloudFormation déploiement initial](using-sam-cli-sync.md#using-sam-cli-sync-options-skip-deploy-sync).  
*Par défaut* : `--skip-deploy-sync`

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-sync-options-stack-name"></a>
Le nom de la CloudFormation pile de votre application.  
Cette option est obligatoire.

`--tags LIST`  <a name="sam-cli-command-reference-sam-sync-options-tags"></a>
Liste de balises à associer à la pile créée ou mise à jour. CloudFormation propage également ces balises aux ressources de la pile qui les supportent.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-sync-options-template-file"></a>
Le chemin et le nom du fichier où se trouve votre AWS SAM modèle.  
Si vous spécifiez cette option, AWS SAM déploie uniquement le modèle et les ressources locales vers lesquels il pointe.

`--use-container, -u`  <a name="sam-cli-command-reference-sam-sync-options-use-container"></a>
Si vos fonctions dépendent de packages dont les dépendances sont compilées de manière native, utilisez cette option pour créer votre fonction dans un Docker conteneur AWS Lambda similaire.  
Actuellement, cette option n'est pas compatible avec `--dependency-layer`. Si vous utilisez `--use-container` avec `--dependency-layer`, la CLI  AWS SAM vous en informe et continue avec `--no-dependency-layer`.

`--watch`  <a name="sam-cli-command-reference-sam-sync-options-watch"></a>
Lance un processus qui surveille les modifications apportées par votre application locale et les synchronise automatiquement avec le AWS Cloud. Par défaut, lorsque vous spécifiez cette option, toutes les ressources de votre application sont AWS SAM synchronisées au fur et à mesure que vous les mettez à jour. Avec cette option, AWS SAM effectue un CloudFormation déploiement initial. AWS SAM Utilise ensuite le AWS service APIs pour mettre à jour les ressources du code. AWS SAM utilise CloudFormation pour mettre à jour les ressources de l'infrastructure lorsque vous mettez à jour votre AWS SAM modèle.

`--watch-exclude TEXT`  <a name="sam-cli-command-reference-sam-sync-options-watch-exclude"></a>
Empêche un fichier ou un dossier d’être observé en cas de modification de fichier. Pour utiliser cette option, `--watch` doit également être fournie.  
Cette option reçoit une paire clé-valeur :  
+ **clé** : ID logique d'une fonction Lambda dans votre application.
+ **valeur** : nom du fichier ou du dossier associé à exclure.
Lorsque vous mettez à jour des fichiers ou des dossiers spécifiés avec l'`--watch-exclude`option, aucune synchronisation ne AWS SAM CLI sera lancée. Toutefois, lorsqu'une mise à jour d'autres fichiers ou dossiers initie une synchronisation, ceux-ci ou sont inclus dans cette synchronisation.  
Vous pouvez fournir cette option plusieurs fois dans une seule commande.

## Exemples
<a name="sam-cli-command-reference-sam-sync-examples"></a>

Pour des exemples d'utilisation de cette commande, reportez-vous à[Options pour la commande sam sync](using-sam-cli-sync.md#using-sam-cli-sync-options).

# sam traces
<a name="sam-cli-command-reference-sam-traces"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model commande Command Line Interface (AWS SAMCLI)`sam traces`.

Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)

La `sam traces` commande récupère les AWS X-Ray traces Compte AWS dans votre fichier. Région AWS

## Usage
<a name="sam-cli-command-reference-sam-traces-usage"></a>

```
$ sam traces <options>
```

## Options
<a name="sam-cli-command-reference-sam-traces-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-traces-options-config-env"></a>
Le nom d’environnement spécifiant les valeurs de paramètre par défaut dans le fichier de configuration à utiliser. La valeur par défaut est « par défaut ». Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-traces-options-config-file"></a>
Le chemin d’accès et le nom du fichier de configuration contenant les valeurs de paramètres par défaut à utiliser. La valeur par défaut est « `samconfig.toml` » dans la racine du répertoire du projet. Pour plus d’informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--end-time TEXT`  <a name="sam-cli-command-reference-sam-traces-options-end-time"></a>
Récupère les traces jusqu'à ce moment. L'heure peut être une valeur relative comme « il y a 5 minutes », « demain » ou un horodatage formaté comme « 2018-01-01 10:10:10 ».

`--output TEXT`  <a name="sam-cli-command-reference-sam-traces-options-output"></a>
Spécifie le format de sortie pour les journaux. Pour imprimer des journaux formatés, spécifiez `text`. Pour imprimer les journaux au format JSON, spécifiez `json`.

`--save-params`  <a name="sam-cli-command-reference-sam-traces-options-save-params"></a>
Enregistrez les paramètres que vous fournissez sur la ligne de commande dans le fichier AWS SAM de configuration.

`--start-time TEXT`  <a name="sam-cli-command-reference-sam-traces-options-start-time"></a>
Récupère les traces en ce moment. L'heure peut être une valeur relative comme « il y a 5 minutes », « hier » ou un horodatage formaté comme « 2018-01-01 10:10:10 ». La valeur par défaut est « il y a 10 minutes ».

`--tail`  <a name="sam-cli-command-reference-sam-traces-options-tail"></a>
Suit la sortie de la trace. Cette méthode ignore l'argument des heures de fin de fin et continue d'afficher les traces au fur et à mesure qu'elles deviennent disponibles.

`--trace-id TEXT`  <a name="sam-cli-command-reference-sam-traces-options-trace-id"></a>
Identifiant unique pour une trace X-Ray.

## Exemples
<a name="sam-cli-command-reference-sam-traces-examples"></a>

Exécutez la commande suivante pour récupérer les traces de X-Ray par identifiant.

```
$ sam traces --trace-id tracing-id-1 --trace-id tracing-id-2
```

Exécutez la commande suivante pour suivre les traces X-Ray au fur et à mesure qu'elles deviennent disponibles.

```
$ sam traces --tail
```

# sam validate
<a name="sam-cli-command-reference-sam-validate"></a>

Cette page fournit des informations de référence pour la AWS Serverless Application Model commande Command Line Interface (AWS SAMCLI)`sam validate`.

Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)

La `sam validate` commande vérifie si un fichier AWS SAM modèle est valide.

## Usage
<a name="sam-cli-command-reference-sam-validate-usage"></a>

```
$ sam validate <options>
```

## Options
<a name="sam-cli-command-reference-sam-validate-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-validate-options-config-env"></a>
Le nom d’environnement spécifiant les valeurs de paramètre par défaut dans le fichier de configuration à utiliser. La valeur par défaut est « par défaut ». Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-validate-options-config-file"></a>
Le chemin d'accès et le nom du fichier de configuration contenant les valeurs de paramètres par défaut à utiliser. La valeur par défaut est « samconfig.toml » dans la racine du répertoire du projet. Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-validate-options-debug"></a>
Active la journalisation de débogage pour imprimer le message de débogage généré par la CLI  AWS SAM et pour afficher les horodatages.

`--lint`  <a name="sam-cli-command-reference-sam-validate-options-lint"></a>
 Exécutez la validation linting sur le modèle via **cfn-lint**. Créez un fichier de configuration `cfnlintrc` pour spécifier des paramètres supplémentaires. *Pour plus d'informations, consultez [cfn-lint dans le référentiel.](https://github.com/aws-cloudformation/cfn-lint)CloudFormation GitHub * 

`--profile TEXT`  <a name="sam-cli-command-reference-sam-validate-options-profile"></a>
Le profil spécifique de votre fichier d'informations d'identification qui obtient les AWS informations d'identification.

`--region TEXT`  <a name="sam-cli-command-reference-sam-validate-options-region"></a>
 AWS Région dans laquelle le déploiement doit être effectué. Par exemple, us-east-1.

`--save-params`  <a name="sam-cli-command-reference-sam-validate-options-save-params"></a>
Enregistrez les paramètres que vous fournissez sur la ligne de commande dans le fichier AWS SAM de configuration.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-validate-options-template-file"></a>
 Le fichier AWS SAM modèle. La valeur par défaut est `template.[yaml|yml]`.   
 Si votre modèle se trouve dans votre répertoire de travail actuel et qu'il est nommé `template.[yaml|yml|json]`, cette option n'est pas obligatoire.   
 Si vous venez d'exécuter **sam build**, cette option n'est pas obligatoire. 

## Exemple
<a name="sam-cli-command-reference-sam-validate-examples"></a>

Pour un exemple d'utilisation de cette commande pour valider un modèle, reportez-vous à[Valider les fichiers AWS SAM modèles](serverless-sam-cli-using-validate.md).

Pour un exemple d'utilisation de cette commande avec cfn-lint, reportez-vous à. [Validez vos AWS SAM applications avec CloudFormation Linter](validate-cfn-lint.md)

# AWS SAMCLIgestion
<a name="reference-sam-cli"></a>

Cette section contient des informations sur les moyens de gérer et de personnaliser votre version du AWS SAMCLI. Cela inclut des informations sur la manière dont vous pouvez configurer les valeurs des paramètres de AWS SAMCLI commande à l'aide d'un fichier de configuration au niveau du projet. Il inclut également des informations sur la gestion des différentes versions de votre compte AWS SAMCLI, la définition des AWS informations d'identification AWS SAM permettant de passer des appels aux AWS services en votre nom et les différentes méthodes de personnalisation AWS SAM. Cette section se termine par une section sur le AWS SAM dépannage général.

**Topics**
+ [

# Fichier de configuration CLI AWS SAM
](serverless-sam-cli-config.md)
+ [

# Gestion des versions CLI  AWS SAM
](manage-sam-cli-versions.md)
+ [

# Configuration des AWS informations d'identification
](serverless-getting-started-set-up-credentials.md)
+ [

# Télémétrie dans la CLI  AWS SAM
](serverless-sam-telemetry.md)
+ [

# Résolution des problèmes de la CLI AWS SAM
](sam-cli-troubleshooting.md)

# Fichier de configuration CLI AWS SAM
<a name="serverless-sam-cli-config"></a>

L'interface de ligne de AWS Serverless Application Model commande (AWS SAMCLI) prend en charge un fichier de configuration au niveau du projet que vous pouvez utiliser pour configurer les valeurs des paramètres de AWS SAMCLI commande.

Pour obtenir de la documentation sur la création et l'utilisation de fichiers de configuration, veuillez consulter la section [Configuration de la CLI  AWS SAM](using-sam-cli-configure.md).

**Topics**
+ [

## Paramètres du fichier de configuration par défaut
](#serverless-sam-cli-config-default)
+ [

## Formats de fichiers de configuration pris en charge
](#serverless-sam-cli-config-formats)
+ [

## Spécifier un fichier de configuration
](#serverless-sam-cli-config-specify)
+ [

## Principes de base relatifs au fichier de configuration
](#serverless-sam-cli-config-basics)
+ [

## Règles de valeur des paramètres
](#serverless-sam-cli-config-rules)
+ [

## Ordre de priorité de configuration
](#serverless-sam-cli-config-precedence)
+ [

## Création et modification de fichiers de configuration
](#serverless-sam-cli-config-using)

## Paramètres du fichier de configuration par défaut
<a name="serverless-sam-cli-config-default"></a>

AWS SAM utilise les paramètres de fichier de configuration par défaut suivants :
+ **Nom** : `samconfig`.
+ **Emplacement** : à la racine de votre projet. Il s'agit du même emplacement que celui de votre fichier `template.yaml`.
+ **Format** : `TOML`. Pour en savoir plus, veuillez consulter la section [TOML](https://toml.io/en/) dans la *documentation TOML*.

Voici un exemple de structure de projet qui inclut le nom et l'emplacement du fichier de configuration par défaut :

```
sam-app
├── README.md
├── __init__.py
├── events
├── hello_world
├── samconfig.toml
├── template.yaml
└── tests
```

Voici un exemple de fichier de `samconfig.toml` :

```
...
version = 0.1

[default]
[default.global]
[default.global.parameters]
stack_name = "sam-app"

[default.build.parameters]
cached = true
parallel = true

[default.deploy.parameters]
capabilities = "CAPABILITY_IAM"
confirm_changeset = true
resolve_s3 = true

[default.sync.parameters]
watch = true

[default.local_start_api.parameters]
warm_containers = "EAGER"

[prod]
[prod.sync]
[prod.sync.parameters]
watch = false
```

## Formats de fichiers de configuration pris en charge
<a name="serverless-sam-cli-config-formats"></a>

Les formats `TOML` et `[YAML|YML]` sont pris en charge. Consultez la syntaxe de base suivante :

### TOML
<a name="serverless-sam-cli-config-formats-toml"></a>

```
version = 0.1
[environment]
[environment.command]
[environment.command.parameters]
option = parameter value
```

### YAML
<a name="serverless-sam-cli-config-formats-yaml"></a>

```
version: 0.1
environment:
  command:
    parameters:
      option: parameter value
```

## Spécifier un fichier de configuration
<a name="serverless-sam-cli-config-specify"></a>

Par défaut, la CLI  AWS SAM recherche un fichier de configuration dans l'ordre suivant :

1. **Fichier de configuration personnalisé** : si vous utilisez l'option `--config-file` pour spécifier un nom et un emplacement de fichier, la CLI  AWS SAM recherche d'abord ce fichier.

1. **Fichier `samconfig.toml` par défaut** : il s'agit du nom et du format du fichier de configuration par défaut, situé à la racine de votre projet. Si vous ne spécifiez pas de fichier de configuration personnalisé, la CLI  AWS SAM recherche ensuite ce fichier.

1. **Fichier `samconfig.[yaml|yml]`** : si le fichier `samconfig.toml` n'existe pas à la racine de votre projet, la CLI  AWS SAM recherche ce fichier.

Voici un exemple de spécification d'un fichier de configuration personnalisé à l'aide de l'option `--config-file` :

```
$ sam deploy --config-file myconfig.yaml
```

**Note**  
Le `--config-file` paramètre doit être relatif à l'emplacement du fichier AWS SAM modèle, car il AWS SAMCLI doit déterminer le contexte dans lequel la configuration est appliquée. Le `samconfig.toml` fichier gère les paramètres de configuration de votre version de AWS SAMCLI, et la CLI recherche le `samconfig.toml` fichier (ou le paramètre du fichier de configuration remplacé) dans le dossier relatif du `template.yaml` fichier.

## Principes de base relatifs au fichier de configuration
<a name="serverless-sam-cli-config-basics"></a>

### Environnement
<a name="serverless-sam-cli-config-basics-environment"></a>

Un **environnement** est un identifiant nommé qui contient un ensemble unique de paramètres de configuration. Vous pouvez avoir plusieurs environnements dans une seule AWS SAM application.

Le nom de l'environnement par défaut est `default`.

Utilisez l' AWS SAMCLI`--config-env`option pour spécifier l'environnement à utiliser.

### Commande
<a name="serverless-sam-cli-config-basics-command"></a>

La **commande** est la commande CLI  AWS SAM pour laquelle les valeurs des paramètres sont spécifiées.

Pour spécifier les valeurs des paramètres pour toutes les commandes, utilisez l'identificateur `global`.

Lorsque vous faites référence à une commande CLI  AWS SAM, remplacez les espaces (`–`) et les traits d'union (` `) par des traits de soulignement (`_`). Voir les exemples suivants :
+ `build`
+ `local_invoke`
+ `local_start_api`

### Parameters
<a name="serverless-sam-cli-config-basics-parameters"></a>

Les **paramètres** sont spécifiés sous forme de paires clé-valeur.
+ La **clé** est le nom de l'option de commande CLI  AWS SAM.
+ La **valeur** est celle à spécifier.

Lorsque vous spécifiez des clés, utilisez le nom complet de l'option de commande et remplacez les traits d'union (`–`) par des traits de soulignement (`_`). Voici quelques exemples :
+ `region`
+ `stack_name`
+ `template_file`

## Règles de valeur des paramètres
<a name="serverless-sam-cli-config-rules"></a>

### TOML
<a name="serverless-sam-cli-config-rules-toml"></a>
+ Les valeurs booléennes peuvent être `true` ou `false`. Par exemple, `confirm_changeset = true`.
+ Pour les valeurs de chaîne de caractères, utilisez des guillemets (`""`). Par exemple, `region = "us-west-2"`.
+ Pour les valeurs de liste, utilisez des guillemets (`""`) et séparez chaque valeur par une espace (` `). Par exemple : `capabilities = "CAPABILITY_IAM CAPABILITY_NAMED_IAM"`.
+ Pour la valeur contenant une liste de paires clé-valeur, les paires sont délimitées par des espaces (` `), et la valeur de chaque paire est entourée de guillemets (`\" \"`) encodés. Par exemple, `tags = "project=\"my-application\" stage=\"production\""`.
+ Pour les valeurs de paramètres qui peuvent être spécifiés plusieurs fois, la valeur est un tableau d'arguments. Par exemple : `image_repositories = ["my-function-1=image-repo-1", "my-function-2=image-repo-2"]`.

### YAML
<a name="serverless-sam-cli-config-rules-yaml"></a>
+ Les valeurs booléennes peuvent être `true` ou `false`. Par exemple, `confirm_changeset: true`.
+ Pour les entrées contenant une seule valeur de chaîne de caractères, les guillemets (`""`) sont facultatifs. Par exemple, `region: us-west-2`. Cela inclut les entrées qui contiennent plusieurs paires clé-valeur fournies sous la forme d'une seule chaîne de caractères. Voici un exemple :

  ```
  $ sam deploy --tags "foo=bar hello=world"
  ```

  ```
  default:
    deploy:
      parameters:
        tags: foo=bar hello=world
  ```
+ Pour les entrées qui contiennent une liste de valeurs ou pour les entrées qui peuvent être utilisées plusieurs fois au sein d'une même commande, spécifiez-les sous forme de liste de chaînes de caractères.

  Voici un exemple :

  ```
  $ sam remote invoke --parameter "InvocationType=Event" --parameter "LogType=None"
  ```

  ```
  default:
    remote_invoke:
      parameters:
          parameter:
          - InvocationType=Event
          - LogType=None
  ```

## Ordre de priorité de configuration
<a name="serverless-sam-cli-config-precedence"></a>

Lors de la configuration des valeurs, l'ordre de priorité est le suivant :
+ Les valeurs des paramètres que vous fournissez à la ligne de commande ont la priorité sur les valeurs correspondantes dans le fichier de configuration et la section `Parameters` du fichier modèle.
+ Si l'option `--parameter-overrides` est utilisée sur la ligne de commande ou dans votre fichier de configuration avec la clé `parameter_overrides`, ses valeurs ont la priorité sur les valeurs de la section `Parameters` du fichier modèle.
+ Dans votre fichier de configuration, les entrées fournies pour une commande spécifique sont prioritaires sur les entrées globales. Dans l'exemple suivant, la commande `sam deploy` utilisera le nom de pile `my-app-stack`.

------
#### [ TOML ]

  ```
  [default.global.parameters]
  stack_name = "common-stack"
  
  [default.deploy.parameters]
  stack_name = "my-app-stack"
  ```

------
#### [ YAML ]

  ```
  default:
    global:
      parameters:
        stack_name: common-stack
    deploy:
      parameters:
        stack_name: my-app-stack
  ```

------

## Création et modification de fichiers de configuration
<a name="serverless-sam-cli-config-using"></a>

### Création de fichiers de configuration
<a name="serverless-sam-cli-config-using-create"></a>

Lorsque vous créez une application à l'aide de `sam init`, un fichier `samconfig.toml` par défaut est créé. Vous pouvez également créer manuellement votre fichier de configuration.

### Modification des fichiers de configuration
<a name="serverless-sam-cli-config-using-modify"></a>

Vous pouvez modifier manuellement vos fichiers de configuration. De plus, lors de tout flux interactif de la CLI  AWS SAM, les valeurs configurées seront affichées entre crochets (`[ ]`). Si vous modifiez ces valeurs, la CLI  AWS SAM mettra à jour votre fichier de configuration.

Vous trouverez ci-dessous un exemple du flux interactif utilisant la commande `sam deploy --guided` :

```
$ sam deploy --guided

Configuring SAM deploy
======================

    Looking for config file [samconfig.toml] :  Found
    Reading default arguments  :  Success

    Setting default arguments for 'sam deploy'
    =========================================
    Stack Name [sam-app]: ENTER
    AWS Region [us-west-2]: ENTER
    #Shows you resources changes to be deployed and require a 'Y' to initiate deploy
    Confirm changes before deploy [Y/n]: n
    #SAM needs permission to be able to create roles to connect to the resources in your template
    Allow SAM CLI IAM role creation [Y/n]: ENTER
    #Preserves the state of previously provisioned resources when an operation fails
    Disable rollback [y/N]: ENTER
    HelloWorldFunction may not have authorization defined, Is this okay? [y/N]: y
    Save arguments to configuration file [Y/n]: ENTER
    SAM configuration file [samconfig.toml]: ENTER
    SAM configuration environment [default]: ENTER
```

Lorsque vous modifiez votre fichier de configuration, la CLI  AWS SAM traite les valeurs globales de la manière suivante :
+ Si la valeur du paramètre existe dans la section `global` de votre fichier de configuration, la CLI  AWS SAM n'écrit pas la valeur dans la section de commande spécifique.
+ Si la valeur du paramètre existe à la fois dans les sections de commande `global` et dans des sections de commande spécifiques, la CLI  AWS SAM supprime l'entrée spécifique au profit de la valeur globale.

# Gestion des versions CLI  AWS SAM
<a name="manage-sam-cli-versions"></a>

Gérez les versions de votre interface de ligne de AWS Serverless Application Model commande (AWS SAMCLI) par le biais de la mise à niveau, de la rétrogradation et de la désinstallation. Vous pouvez également télécharger et installer la compilation nocturne de la CLI  AWS SAM.

**Topics**
+ [

## Mise à niveau de la CLI  AWS SAM en cours
](#manage-sam-cli-versions-upgrade)
+ [

## Désinstallation de la CLI  AWS SAM
](#manage-sam-cli-versions-uninstall)
+ [

## Passer de l'utilisation de Homebrew pour gérer la CLI  AWS SAM
](#manage-sam-cli-versions-switch)
+ [

## Gestion de la compilation nocturne de la CLI  AWS SAM
](#manage-sam-cli-versions-nightly-build)
+ [

## Installation de la CLI  AWS SAM dans un environnement virtuel à l'aide de pip
](#manage-sam-cli-versions-install-virtual)
+ [

## Gestion de la CLI  AWS SAM avec Homebrew
](#manage-sam-cli-versions-homebrew)
+ [

## Résolution des problèmes
](#manage-sam-cli-versions-troubleshoot)

## Mise à niveau de la CLI  AWS SAM en cours
<a name="manage-sam-cli-versions-upgrade"></a>

### Linux
<a name="manage-sam-cli-versions-upgrade-linux"></a>

Pour mettre à niveau la CLI  AWS SAM sous Linux, suivez les instructions d'installation de [Installation de la CLI  AWS SAM](install-sam-cli.md#install-sam-cli-instructions), mais ajoutez l'option `--update` à la commande d'installation, comme suit :

```
sudo ./sam-installation/install --update
```

### macOS
<a name="manage-sam-cli-versions-upgrade-macos"></a>

Le AWS SAMCLI doit être mis à niveau en utilisant la même méthode que celle utilisée pour l'installer. Nous vous recommandons d'utiliser le programme d'installation du package pour installer et mettre à niveau le AWS SAMCLI.

 Pour mettre à niveau la CLI  AWS SAMà l'aide du programme d'installation de packages, installez la dernière version du package. Pour obtenir des instructions, veuillez consulter [Installation de la CLI  AWS SAM](install-sam-cli.md#install-sam-cli-instructions). 

### Windows
<a name="manage-sam-cli-versions-upgrade-windows"></a>

Pour effectuer la mise à niveau AWS SAMCLI, répétez les étapes d'installation de [Installer la CLI  AWS SAM](install-sam-cli.md) Windows.

## Désinstallation de la CLI  AWS SAM
<a name="manage-sam-cli-versions-uninstall"></a>

### Linux
<a name="manage-sam-cli-versions-uninstall-linux"></a>

Pour désinstaller la CLI  AWS SAM sous Linux, vous devez supprimer le lien symbolique et le répertoire d'installation en exécutant les commandes suivantes :

1. Localisez le lien symbolique et les chemins d'installation.
   + Utilisez la commande **which** pour trouver le lien symbolique.

     ```
     which sam
     ```

     La sortie indique le chemin où se trouvent AWS SAM les fichiers binaires, par exemple :

     ```
      /usr/local/bin/sam
     ```
   + Utilisez la commande **ls** pour rechercher le répertoire vers lequel pointe le lien symbolique.

     ```
     ls -l /usr/local/bin/sam
     ```

     Dans l'exemple suivant, le répertoire d'installation est `/usr/local/aws-sam-cli`.

     ```
      lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/sam -> /usr/local/aws-sam-cli/current/bin/sam
     ```

1. Supprimez le lien symbolique.

   ```
   sudo rm /usr/local/bin/sam
   ```

1. Supprimez le répertoire d'installation.

   ```
   sudo rm -rf /usr/local/aws-sam-cli
   ```

### macOS
<a name="manage-sam-cli-versions-uninstall-macos"></a>

Désinstallez la CLI  AWS SAM par la même méthode que celle utilisée pour l'installer. Nous vous recommandons d'utiliser le programme d'installation du package pour installer le AWS SAMCLI.

Si vous avez installé la CLI  AWS SAMà l'aide du programme d'installation de packages, suivez ces étapes pour la désinstaller.

**Pour désinstaller la CLI  AWS SAM**

1.  Supprimez le programme CLI  AWS SAM en modifiant et en exécutant ce qui suit : 

   ```
   $ sudo rm -rf /path-to/aws-sam-cli
   ```

   1.  *sudo*— Si votre utilisateur dispose d'autorisations d'écriture sur l'endroit où le AWS SAMCLI programme est installé, cela n'**sudo**est pas obligatoire. Dans le cas contraire, la valeur **sudo** est obligatoire. 

   1.  */path-to*— Chemin d'accès à l'endroit où vous avez installé le AWS SAMCLI programme. L'emplacement par défaut est `/usr/local`. 

1.  AWS SAMCLI`$PATH`Supprimez-le en modifiant et en exécutant ce qui suit : 

   ```
   $ sudo rm -rf /path-to-symlink-directory/sam
   ```

   1.  *sudo*— Si votre utilisateur dispose d'autorisations d'écriture pour`$PATH`, ce n'**sudo**est pas obligatoire. Dans le cas contraire, la valeur **sudo** est obligatoire. 

   1.  *path-to-symlink-directory*— Votre variable d'`$PATH`environnement. L'emplacement par défaut est `/usr/local/bin`. 

1.  Procédez comme suit pour vérifier que la CLI  AWS SAM est bien désinstallée : 

   ```
   $ sam --version
   command not found: sam
   ```

### Windows
<a name="manage-sam-cli-versions-uninstall-windows"></a>

Pour désinstaller la CLI  AWS SAM en utilisant les paramètres Windows, procédez aux étapes suivantes :

1. Dans le menu Démarrer, recherchez « Ajouter ou supprimer des programmes ».

1. Sélectionnez le résultat nommé **Interface de ligne de commande AWS SAM ** et cliquez sur **Uninstall** (Désinstaller) pour lancer le programme de désinstallation.

1. Confirmez que vous souhaitez désinstaller le AWS SAMCLI.

## Passer de l'utilisation de Homebrew pour gérer la CLI  AWS SAM
<a name="manage-sam-cli-versions-switch"></a>

Si vous avez l'habitude Homebrew d'installer et de mettre à niveau le AWS SAMCLI, nous vous recommandons d'utiliser une méthode AWS compatible. Suivez ces instructions pour passer à une méthode prise en charge.

**Pour passer de l'utilisation de Homebrew**

1. Suivez les instructions décrites dans [Désinstaller une CLI Homebrew installée AWS SAM](#manage-sam-cli-versions-homebrew-uninstall) pour désinstaller la version gérée par Homebrew.

1. Suivez les instructions décrites dans [Installer la CLI  AWS SAM](install-sam-cli.md) pour installer la CLI AWS SAM  à l’aide d’une méthode prise en charge.

## Gestion de la compilation nocturne de la CLI  AWS SAM
<a name="manage-sam-cli-versions-nightly-build"></a>

Vous pouvez télécharger et installer la compilation nocturne de la CLI  AWS SAM. Celle-ci contient une version préliminaire du code de la CLI  AWS SAM qui peut être moins stable que la version de production. Une fois installée, vous pouvez utiliser la compilation nocturne à l'aide de la commande `sam-nightly`. Vous pouvez installer à la fois les versions de production et de compilation nocturne de la CLI  AWS SAM et les utiliser en même temps.

**Note**  
La compilation nocturne ne contient pas de version préliminaire de l'image de compilation. Ainsi, la création de votre application sans serveur à l'aide de l'option **--use-container** utilise la dernière version de production de l'image de compilation.

### Installation de la compilation nocturne de la CLI  AWS SAM
<a name="manage-sam-cli-versions-nightly-build-install"></a>

Pour installer la compilation nocturne de la CLI  AWS SAM, suivez ces instructions.

#### Linux
<a name="manage-sam-cli-versions-nightly-build-install-linux"></a>

Vous pouvez installer la version de compilation nocturne de la CLI  AWS SAM sur la plateforme Linux x86\$164à l'aide du programme d'installation de packages.

**Pour installer la compilation nocturne de la CLI  AWS SAM**

1. Téléchargez le programme d'installation du [sam-cli-nightly](https://github.com/aws/aws-sam-cli/releases/sam-cli-nightly/)package depuis le *aws-sam-cli GitHubréférentiel*.

1. Suivez les étapes d'[installation de la CLI  AWS SAM](install-sam-cli.md) pour installer le package de compilation nocturne.

#### macOS
<a name="manage-sam-cli-versions-nightly-build-install-macos"></a>

Vous pouvez installer la version de compilation nocturne de la CLI  AWS SAM sur macOS à l'aide du programme d'installation du package de compilation nocturne.

**Pour installer la compilation nocturne de la CLI  AWS SAM**

1. Téléchargez le programme d'installation du package pour votre plate-forme depuis [sam-cli-nightly](https://github.com/aws/aws-sam-cli/releases/sam-cli-nightly/)le *aws-sam-cli GitHubréférentiel*.

1. Suivez les étapes d'[installation de la CLI  AWS SAM](install-sam-cli.md) pour installer le package de compilation nocturne.

#### Windows
<a name="manage-sam-cli-versions-nightly-build-windows"></a>

La version de compilation nocturne de la CLI  AWS SAM est disponible via le lien de téléchargement suivant : [compilation nocturne de la CLI AWS SAM](https://github.com/aws/aws-sam-cli/releases/download/sam-cli-nightly/AWS_SAM_CLI_64_PY3.msi). Pour installer la compilation nocturne sur Windows, exécutez les mêmes étapes que celles décrites dans [Installer la CLI  AWS SAM](install-sam-cli.md), mais utilisez plutôt le lien de téléchargement de compilation nocturne à la place.

Pour vérifier que vous avez installé la version de compilation nocturne, exécutez la commande **sam-nightly --version**. La sortie de cette commande est sous la forme `1.X.Y.dev<YYYYMMDDHHmm>`, par exemple :

```
SAM CLI, version 1.20.0.dev202103151200
```

### Passer de Homebrew au package d'installation
<a name="manage-sam-cli-versions-nightly-build-switch"></a>

Si vous utilisez Homebrew pour installer et mettre à niveau la compilation nocturne de la CLI  AWS SAM et souhaitez opter pour l'utilisation du programme d'installation de package, procédez comme suit.

**Pour passer de Homebrew au package d'installation**

1. Désinstallez la compilation nocturne de la CLI  AWS SAM installée par Homebrew.

   ```
   $ brew uninstall aws-sam-cli-nightly
   ```

1. Procédez comme suit pour vérifier que la compilation nocturne de la CLI  AWS SAM est bien désinstallée :

   ```
   $ sam-nightly --version
   zsh: command not found: sam-nightly
   ```

1. Suivez les étapes décrites dans la section précédente pour installer la compilation nocturne de la CLI  AWS SAM.

## Installation de la CLI  AWS SAM dans un environnement virtuel à l'aide de pip
<a name="manage-sam-cli-versions-install-virtual"></a>

Nous vous recommandons d'utiliser le programme d'installation du package natif pour installer le AWS SAMCLI. Si vous devez utiliser pip, nous vous recommandons d'installer la CLI  AWS SAM dans un environnement virtuel. Cela garantit un environnement d'installation propre et un environnement isolé en cas d'erreurs.

**Note**  
À compter du 24 octobre 2023, AWS SAM CLI le support pourPython 3.7. Pour en savoir plus, veuillez consulter la section [Fin de la prise en charge de Python 3.7 par l'CLIAWS SAM](important-notes.md#important-notes-2023-10-python).

**Pour installer la CLI  AWS SAM dans un environnement virtuel**

1. À partir du répertoire de départ de votre choix, créez un environnement virtuel et nommez-le.

------
#### [ Linux / macOS ]

   ```
   $ mkdir project
   $ cd project
   $ python3 -m venv venv
   ```

------
#### [ Windows ]

   ```
   > mkdir project
   > cd project
   > py -3 -m venv venv
   ```

------

1. Activer l'environnement virtuel

------
#### [ Linux / macOS ]

   ```
   $ . venv/bin/activate
   ```

   L'invite change pour vous indiquer que votre environnement virtuel est actif.

   ```
   (venv) $ 
   ```

------
#### [ Windows ]

   ```
   > venv\Scripts\activate
   ```

   L'invite change pour vous indiquer que votre environnement virtuel est actif.

   ```
   (venv) > 
   ```

------

1. Installez la CLI  AWS SAM dans votre environnement virtuel.

   ```
   (venv) $ pip install --upgrade aws-sam-cli
   ```

1. Vérifiez que la CLI  AWS SAM est installée correctement.

   ```
   (venv) $ sam --version
   SAM CLI, version 1.94.0
   ```

1. La commande `deactivate` vous permet de quitter l’environnement virtuel. Réactivez l’environnement chaque fois que vous démarrez une nouvelle session.

## Gestion de la CLI  AWS SAM avec Homebrew
<a name="manage-sam-cli-versions-homebrew"></a>

**Note**  
À compter de septembre 2023, le programme d'Homebrewinstallation AWS géré pour le AWS SAMCLI (`aws/tap/aws-sam-cli`) ne AWS sera plus maintenu. Pour continuer à utiliser Homebrew, vous pouvez utiliser le programme d'installation géré par la communauté (`aws-sam-cli`). À partir de septembre 2023, toute commande Homebrew faisant référence à `aws/tap/aws-sam-cli` sera redirigée vers `aws-sam-cli`.  
Nous vous recommandons d'utiliser nos méthodes d'[installation](install-sam-cli.md) et de [mise à niveau](#manage-sam-cli-versions-upgrade).

### Installation de la CLI  AWS SAMà l'aide de Homebrew
<a name="manage-sam-cli-versions-homebrew-install"></a>

**Note**  
Ces instructions utilisent le programme d' AWS SAMCLIHomebrewinstallation géré par la communauté. Pour assistance complémentaire, consultez le référentiel *[homebrew-core](https://github.com/Homebrew/homebrew-core/issues)*.

**Pour installer la CLI  AWS SAM**

1. Exécutez les commandes suivantes :

   ```
   $ brew install aws-sam-cli
   ```

1. Vérifiez l’installation :

   ```
   $ sam --version
   ```

   Une fois l'installation réussie du AWS SAMCLI, vous devriez voir le résultat suivant :

   ```
   SAM CLI, version 1.94.0
   ```

### Mise à niveau de la CLI  AWS SAMà l'aide de Homebrew
<a name="manage-sam-cli-versions-homebrew-upgrade"></a>

Pour mettre à niveau la CLI  AWS SAMà l'aide de Homebrew, exécutez la commande suivante :

```
$ brew upgrade aws-sam-cli
```

### Désinstaller une CLI Homebrew installée AWS SAM
<a name="manage-sam-cli-versions-homebrew-uninstall"></a>

Si la CLI  AWS SAM a été installée à l'aide de Homebrew, procédez comme suit pour la désinstaller.

**Pour désinstaller la CLI  AWS SAM**

1. Exécutez les commandes suivantes :

   ```
   $ brew uninstall aws-sam-cli
   ```

1. Procédez comme suit pour vérifier que la CLI  AWS SAM est bien désinstallée :

   ```
   $ sam --version
   command not found: sam
   ```

### Passer au programme d'installation géré par la communauté Homebrew
<a name="manage-sam-cli-versions-homebrew-switch"></a>

Si vous utilisez le programme d'Homebrewinstallation AWS géré (`aws/tap/aws-sam-cli`) et que vous préférez continuer à l'utiliserHomebrew, nous vous recommandons de passer au programme d'Homebrewinstallation géré par la communauté (`aws-sam-cli`).

Pour passer dans une seule commande, exécutez la commande suivante :

```
$ brew uninstall aws-sam-cli && brew untap aws/tap && brew cleanup aws/tap && brew update && brew install aws-sam-cli
```

Suivez ces instructions pour exécuter chaque commande individuellement.

**Pour passer au programme d'installation géré par la communauté Homebrew**

1. Désinstallez la Homebrew version AWS gérée de AWS SAMCLI :

   ```
   $ brew uninstall aws-sam-cli
   ```

1. Vérifiez que la CLI  AWS SAM a été désinstallée :

   ```
   $ which sam
   sam not found
   ```

1. Supprimez le AWS SAMCLI robinet AWS géré :

   ```
   $ brew untap aws/tap
   ```

   Si vous recevez un message d'erreur comme celui-ci, ajoutez l'option `--force` et réessayez.

   ```
   Error: Refusing to untap aws/tap because it contains the following installed formulae or casks:
   aws-sam-cli-nightly
   ```

1. Supprimez les fichiers mis en cache pour le programme d'installation AWS géré :

   ```
   $ brew cleanup aws/tap
   ```

1. Mettre à jour Homebrew et toutes les formules :

   ```
   $ brew update
   ```

1. Installez la version gérée par la communauté de AWS SAMCLI :

   ```
   $ brew install aws-sam-cli
   ```

1. Vérifiez que la CLI  AWS SAM est correctement installée :

   ```
   $ sam --version
   SAM CLI, version 1.94.0
   ```

## Résolution des problèmes
<a name="manage-sam-cli-versions-troubleshoot"></a>

Si vous rencontrez des erreurs lors de l'installation ou de l'utilisation du AWS SAMCLI, consultez[Résolution des problèmes de la CLI AWS SAM](sam-cli-troubleshooting.md).

# Configuration des AWS informations d'identification
<a name="serverless-getting-started-set-up-credentials"></a>

L'interface de ligne de AWS SAM commande (CLI) vous oblige à définir des AWS informations d'identification afin qu'elle puisse effectuer des appels aux AWS services en votre nom. Par exemple, il AWS SAMCLI passe des appels à Amazon S3 et CloudFormation.

Vous avez peut-être déjà défini des AWS informations d'identification pour utiliser des AWS outils, tels que l'un des AWS SDKs ou des AWS CLI. Si ce n'est pas le cas, cette rubrique présente les approches recommandées pour définir les AWS informations d'identification.

Pour définir les AWS informations d'identification, vous devez disposer de l'*ID de clé d'accès* et de votre *clé d'accès secrète* pour l'utilisateur IAM que vous souhaitez configurer. Pour plus d'informations sur les clés d'accès IDs et les clés d'accès secrètes, consultez [la section Gestion des clés d'accès pour les utilisateurs IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) dans le guide de l'*utilisateur IAM*.

Ensuite, déterminez si vous l'avez AWS CLI installé. Puis suivez les instructions de configuration dans l'une des sections suivantes.

## À l'aide du AWS CLI
<a name="serverless-getting-started-set-up-credentials-cli"></a>

Si vous l'avez AWS CLI installé, utilisez la `aws configure` commande et suivez les instructions :

```
$ aws configure
AWS Access Key ID [None]: your_access_key_id
AWS Secret Access Key [None]: your_secret_access_key
Default region name [None]: 
Default output format [None]:
```

Pour obtenir des informations sur la commande `aws configure`, voir [Configuration rapide de la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html#cli-quick-configuration) dans le *Guide de l'utilisateur AWS Command Line Interface *.

## Ne pas utiliser le AWS CLI
<a name="serverless-getting-started-set-up-credentials-no-cli"></a>

Si vous ne l'avez pas AWS CLI installé, vous pouvez créer un fichier d'informations d'identification ou définir des variables d'environnement :
+ **Fichier d'informations d'identification** : vous pouvez définir les informations d'identification dans le fichier AWS d'informations d'identification de votre système local. Ce fichier doit être situé dans l'un des emplacements suivants :
  + `~/.aws/credentials` sous Linux ou macOS
  + `C:\Users\USERNAME\.aws\credentials` sous Windows

  Ce fichier doit contenir des lignes au format suivant :

  ```
  [default]
  aws_access_key_id = your_access_key_id
  aws_secret_access_key = your_secret_access_key
  ```

   
+ **Environment variables (Variables d'environnement)** – Vous pouvez définir les variables d'environnement de `AWS_ACCESS_KEY_ID` et `AWS_SECRET_ACCESS_KEY`.

  Pour définir ces variables sous Linux ou macOS, utilisez la commande **Exportation** :

  ```
  export AWS_ACCESS_KEY_ID=your_access_key_id
  export AWS_SECRET_ACCESS_KEY=your_secret_access_key
  ```

  Pour définir ces variables sous Windows, utilisez la commande **set (définir)** :

  ```
  set AWS_ACCESS_KEY_ID=your_access_key_id
  set AWS_SECRET_ACCESS_KEY=your_secret_access_key
  ```

# Télémétrie dans la CLI  AWS SAM
<a name="serverless-sam-telemetry"></a>

Chez AWS, nous développons et lançons des services en fonction de ce que nous apprenons des interactions avec les clients. Nous utilisons les commentaires des clients pour améliorer notre produit. La télémétrie est une information supplémentaire qui nous aide à mieux comprendre les besoins de nos clients, diagnostiquer les problèmes et fournir des fonctions permettant d'améliorer l'expérience client.

L'interface de ligne de AWS SAM commande (CLI) collecte des données télémétriques, telles que des mesures d'utilisation génériques, des informations sur le système et l'environnement, ainsi que des erreurs. Pour plus de détails sur les types de télémétrie collectés, consultez [Type d’informations à collecter](#serverless-sam-telemtry-data-collected).

La CLI  AWS SAM**ne** collecte pas les informations personnelles, telles que les noms d'utilisateur ou les adresses e-mail. Elle n’extrait pas non plus les informations sensibles au niveau du projet.

Les clients contrôlent si la télémétrie est activée et peuvent modifier leurs paramètres à tout moment. Si la télémétrie reste activée, la CLI  AWS SAM envoie des données de télémétrie en arrière-plan sans nécessiter d'interaction supplémentaire avec le client.

## Désactivation de la télémétrie pour une session
<a name="serverless-sam-telemtry-opt-out"></a>

Dans les systèmes d’exploitation macOS et Linux, vous pouvez désactiver la télémétrie pour une seule session. Pour désactiver la télémétrie de votre session en cours, exécutez la commande suivante pour définir la variable d’environnement `SAM_CLI_TELEMETRY` sur `false`. Répétez la commande pour chaque nouveau terminal ou chaque nouvelle session.

```
export SAM_CLI_TELEMETRY=0
```

## Désactivation de la télémétrie pour votre profil dans toutes les sessions
<a name="serverless-sam-telemtry-opt-out-profile"></a>

Exécutez les commandes suivantes pour désactiver la télémétrie pour toutes les sessions lorsque vous exécutez la CLI  AWS SAM sur votre système d'exploitation.

### Pour désactiver la télémétrie sous Linux
<a name="w2aac28c19c16c15b5"></a>

1. Exécuter :

   ```
   echo "export SAM_CLI_TELEMETRY=0" >>~/.profile
   ```

1. Exécuter :

   ```
   source ~/.profile
   ```

### Pour désactiver la télémétrie sous macOS
<a name="w2aac28c19c16c15b7"></a>

1. Exécuter :

   ```
   echo "export SAM_CLI_TELEMETRY=0" >>~/.profile
   ```

1. Exécuter :

   ```
   source ~/.profile
   ```

### Pour désactiver la télémétrie sous Windows
<a name="w2aac28c19c16c15b9"></a>

Vous pouvez définir temporairement la variable d'environnement pendant toute la durée de vie de la fenêtre du terminal à l'aide de la commande suivante :

Si vous utilisez l'invite de commande :

```
set SAM_CLI_TELEMETRY=0
```

Si vous utilisez PowerShell :

```
$env:SAM_CLI_TELEMETRY=0
```

Pour définir définitivement la variable d'environnement soit dans l'invite de commande PowerShell, soit à l'aide de la commande suivante :

```
setx SAM_CLI_TELEMETRY 0
```

**Note**  
Les modifications n'entreront en vigueur qu'après la fermeture et la réouverture du terminal.

## Type d’informations à collecter
<a name="serverless-sam-telemtry-data-collected"></a>
+ **Informations d'utilisation** : les commandes et sous-commandes génériques exécutées par les clients.
+ **Erreurs et informations de diagnostic** : le statut et la durée des commandes exécutées par les clients, y compris les codes de sortie, les noms d'exception internes et les échecs lors de la connexion à Docker.
+ **Informations sur le système et l'environnement** : version de Python, système d'exploitation (Windows, Linux ou macOS), environnement dans lequel il AWS SAMCLI s'exécute (par exemple AWS CodeBuild, un kit d'outils AWS IDE ou un terminal) et valeurs de hachage des attributs d'utilisation.

## En savoir plus
<a name="serverless-sam-telemtry-learn-more"></a>

Les données de télémétrie AWS SAMCLI collectées sont conformes aux politiques de confidentialité des AWS données. Pour plus d’informations, consultez les ressources suivantes :
+ [AWS Modalités du service](https://aws.amazon.com/service-terms/)
+ [Questions fréquentes (FAQ) relatives à la confidentialité des données](https://aws.amazon.com/compliance/data-privacy-faq/)

# Résolution des problèmes de la CLI AWS SAM
<a name="sam-cli-troubleshooting"></a>

Cette section explique comment résoudre les messages d'erreur lors de l'utilisation, de l'installation et de la gestion de l'interface de ligne de AWS Serverless Application Model commande (AWS SAMCLI).

**Topics**
+ [

## Résolution des problèmes
](#install-sam-cli-troubleshooting)
+ [

## Messages d’erreur
](#sam-cli-troubleshoot-messages)
+ [

## Messages d'avertissement
](#sam-cli-troubleshoot-warning)

## Résolution des problèmes
<a name="install-sam-cli-troubleshooting"></a>

Pour obtenir des conseils de résolution des problèmes liés à AWS SAMCLI, voir[Résolution des erreurs d'installation](install-sam-cli.md#sam-cli-troubleshoot-install).

## Messages d’erreur
<a name="sam-cli-troubleshoot-messages"></a>

### Erreur Curl : « curl : (6) Impossible de résoudre : … »
<a name="sam-cli-troubleshoot-messages-curl"></a>

Lorsque vous essayez d'appeler le point de terminaison API Gateway, vous voyez l'erreur suivante :

```
curl: (6) Could not resolve: endpointdomain (Domain name not found)
```

Cela signifie que vous avez tenté d'envoyer une demande à un domaine non valide. Cela peut se produire si votre application sans serveur n'a pas réussi à se déployer, ou si vous avez une faute de frappe dans votre commande **curl**. Vérifiez que l'application a été déployée avec succès à l'aide de la CloudFormation console ou du AWS CLI, et vérifiez que votre **curl** commande est correcte.

### Erreur : impossible de trouver les informations exactes sur la ressource avec le nom de pile donné
<a name="sam-cli-troubleshoot-messages-exact-resource"></a>

Lorsque vous exécutez la commande `sam remote invoke` sur une application qui contient une seule ressource de fonction Lambda, l'erreur suivante s'affiche :

```
Error: Can't find exact resource information with given <stack-name>. Please provide full resource ARN or --stack-name to resolve the ambiguity.
```

**Cause possible : vous n'avez pas fourni l'option `--stack-name`.**  
Si aucun ARN de fonction n'est fourni en tant qu'argument, la `sam remote invoke` commande nécessite que l'option `--stack-name` soit fournie.

**Solution : fournissez l'option`--stack-name`.**  
Voici un exemple :  

```
$ sam remote invoke --stack-name sam-app

Invoking Lambda Function HelloWorldFunction                                                                                                                                                                                                                     
START RequestId: 40593abb-e1ad-4d99-87bd-ac032e364e82 Version: $LATEST
END RequestId: 40593abb-e1ad-4d99-87bd-ac032e364e82
REPORT RequestId: 40593abb-e1ad-4d99-87bd-ac032e364e82  Duration: 11.31 ms      Billed Duration: 12 ms  Memory Size: 128 MB     Max Memory Used: 67 MB  Init Duration: 171.71 ms
{"statusCode":200,"body":"{\"message\":\"hello world\"}"}%
```

### Erreur : impossible de trouver les informations sur les ressources à partir du nom de la pile
<a name="sam-cli-troubleshoot-messages-stack-name"></a>

Lorsque vous exécutez la commande `sam remote invoke` et que vous transmettez un ARN de fonction Lambda en tant qu'argument, l'erreur suivante s'affiche :

```
Error: Can't find resource information from stack name (<stack-name>) and resource id (<function-id>)
```

**Cause possible : la valeur du nom de la pile est définie dans votre fichier `samconfig.toml`.**  
La CLI  AWS SAM vérifie d'abord si votre fichier `samconfig.toml` contient un nom de pile. S'il est spécifié, l'argument est transmis en tant que valeur d'identifiant logique.

**Solution : transmettez plutôt l'ID logique de la fonction.**  
Vous pouvez transmettre l'ID logique de la fonction en tant qu'argument au lieu de l'ARN de la fonction.

**Solution : supprimez la valeur du nom de la pile de votre fichier de configuration.**  
Vous pouvez supprimer la valeur du nom de la pile de votre fichier de configuration. Cela empêche la CLI  AWS SAM de transmettre l'ARN de votre fonction en tant que valeur d'identifiant logique.  
Exécutez `sam build` après avoir modifié votre fichier de configuration.

### Erreur : Impossible de créer les ressources gérées : impossible de localiser les informations d'identification
<a name="sam-cli-troubleshoot-messages-credentials"></a>

Lorsque vous exécutez la commande **sam deploy**, vous voyez l'erreur suivante :

```
Error: Failed to create managed resources: Unable to locate credentials
```

Cela signifie que vous n'avez pas configuré AWS d'informations d'identification permettant de AWS SAMCLI passer des appels AWS de service. Pour résoudre ce problème, vous devez configurer les AWS informations d'identification. Pour de plus amples informations, veuillez consulter [Configuration des AWS informations d'identification](serverless-getting-started-set-up-credentials.md).

### Erreur : FileNotFoundError sous Windows
<a name="sam-cli-troubleshoot-messages-filenotfound-win"></a>

Lorsque vous exécutez des commandes AWS SAMCLI sous Windows, le message d'erreur suivant peut s'afficher :

```
Error: FileNotFoundError
```

Cause possible : ils AWS SAMCLI peuvent interagir avec des chemins de fichiers qui dépassent la limite de chemin maximale de Windows.

Solution : pour résoudre ce problème, le nouveau comportement des longs chemins doit être activé. Pour ce faire, consultez la section [Activer les longs chemins dans Windows 10, version 1607 et versions ultérieures](https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation?tabs=powershell#enable-long-paths-in-windows-10-version-1607-and-later) dans la *documentation de développement d'applications Microsoft Windows*.

### Erreur : résolveur de dépendances de pip…
<a name="sam-cli-troubleshoot-messages-pip"></a>

*Exemple de texte d'erreur* :

```
ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts. 
aws-sam-cli 1.58.0 requires aws-sam-translator==1.51.0, but you have aws-sam-translator 1.58.0 which is incompatible. 
aws-sam-cli 1.58.0 requires typing-extensions==3.10.0.0, but you have typing-extensions 4.4.0 which is incompatible.
```

**Cause possible : si vous utilisez pip pour l'installation de packages, les dépendances entre les packages peuvent entrer en conflit.**  
Chaque version du package `aws-sam-cli` dépend d'une version du package `aws-sam-translator`. Par exemple, `aws-sam-cli` v1.58.0 peut dépendre de v1.51.0 `aws-sam-translator`.  
Si vous installez la CLI CLI  AWS SAMà l'aide de pip, puis installez un autre package dépendant d'une version plus récente de `aws-sam-translator`, les événements suivants se produiront :  
+ La version la plus récente de `aws-sam-translator` sera installée.
+ La version actuelle de `aws-sam-cli` et la version plus récente de `aws-sam-translator` peuvent ne pas être compatibles.
+ Lorsque vous utilisez le AWS SAMCLI, l'erreur du résolveur de dépendances se produit.

**Solutions :**

1. Utilisez le programme d'installation de packages natif de la CLI  AWS SAM.

   1. Désinstallez la CLI  AWS SAMà l'aide de pip. Pour obtenir des instructions, veuillez consulter [Désinstallation de la CLI  AWS SAM](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall).

   1. Installez la CLI  AWS SAMà l'aide du programme d'installation de packages natif. Pour obtenir des instructions, veuillez consulter [Installer la CLI  AWS SAM](install-sam-cli.md).

   1. Si nécessaire, mettez à niveau la CLI  AWS SAMà l'aide du programme d'installation de packages natif. Pour obtenir des instructions, veuillez consulter [Mise à niveau de la CLI  AWS SAM en cours](manage-sam-cli-versions.md#manage-sam-cli-versions-upgrade).

1. Si vous devez utiliser pip, nous vous recommandons d'installer la CLI AWS SAM dans un environnement virtuel. Cela garantit un environnement d'installation propre et un environnement isolé en cas d'erreurs. Pour obtenir des instructions, veuillez consulter [Installation de la CLI  AWS SAM dans un environnement virtuel à l'aide de pip](manage-sam-cli-versions.md#manage-sam-cli-versions-install-virtual).

### Erreur : aucune commande « télécommande » de ce type
<a name="sam-cli-troubleshoot-messages-command-remote"></a>

Lorsque vous exécutez la commande `sam remote invoke`, vous voyez l'erreur suivante :

```
$ sam remote invoke ...
2023-06-20 08:15:07 Command remote not available
Usage: sam [OPTIONS] COMMAND [ARGS]...
Try 'sam -h' for help.

Error: No such command 'remote'.
```

**Cause possible : votre version de la CLI  AWS SAM est obsolète.**  
La AWS SAMCLI `sam remote invoke` commande a été publiée avec AWS SAMCLI la version 1.88.0. Vous pouvez vérifier votre version en exécutant la commande `sam --version`.

**Solution : mettez à niveau votre CLI  AWS SAM vers la dernière version.**  
Pour obtenir des instructions, veuillez consulter [Mise à niveau de la CLI  AWS SAM en cours](manage-sam-cli-versions.md#manage-sam-cli-versions-upgrade).

### Erreur : l'exécution de projets AWS SAM en local nécessiteDocker. L'avez-vous installé ?
<a name="sam-cli-troubleshoot-messages-docker"></a>

Lorsque vous exécutez la commande **sam local start-api**, vous voyez l'erreur suivante :

```
Error: Running AWS SAM projects locally requires Docker. Have you got it installed?
```

Cela signifie que vous n'avez pas correctement installé Docker. Docker est requis pour tester votre application localement. Pour résoudre ce problème, suivez les instructions d'installation de Docker pour votre hôte de développement. Pour de plus amples informations, veuillez consulter [Installation de Docker](install-docker.md).

### Erreur : Contraintes de sécurité non satisfaites
<a name="sam-cli-troubleshoot-messages-security-constraints"></a>

Lors de l'exécution de **sam deploy --guided**, vous devrez répondre à la question `Function may not have authorization defined, Is this okay? [y/N]`. Si vous répondez à cette question par non **N** (réponse par défaut), vous voyez apparaître l'erreur suivante :

```
Error: Security Constraints Not Satisfied
```

L'invite vous informe que l'application que vous êtes sur le point de déployer peut comporter une API Amazon API Gateway accessible au public configurée sans autorisation. En répondant **N** à cette question, vous dites que ce n'est pas OK.

Pour résoudre le problème, vous disposez des options suivantes :
+ Configurez votre application avec l'autorisation. Pour plus d'informations sur la configuration de l'autorisation, consultez [Contrôlez l'accès aux API avec votre AWS SAM modèle](serverless-controlling-access-to-apis.md).
+ Si votre intention est de disposer d'un point de terminaison d'API accessible au public sans autorisation, redémarrez votre déploiement et répondez à cette question par **Y** pour indiquer que vous êtes d'accord avec le déploiement.

### message : jeton d'authentification manquant
<a name="sam-cli-troubleshoot-messages-auth-token"></a>

Lorsque vous essayez d'appeler le point de terminaison API Gateway, vous voyez l'erreur suivante :

```
{"message":"Missing Authentication Token"}
```

Cela signifie que vous avez tenté d'envoyer une demande au domaine correct, mais que l'URI n'est pas reconnaissable. Pour résoudre ce problème, vérifiez l'URL complète et mettez à jour la commande **curl** avec l'URL correcte.

## Messages d'avertissement
<a name="sam-cli-troubleshoot-warning"></a>

### Avertissement :... AWS ne maintiendra plus le Homebrew programme d'installation pendant AWS SAM ...
<a name="sam-cli-troubleshoot-warning-homebrew"></a>

Lors de l'installation de la CLI  AWS SAMà l'aide de Homebrew, le message d'avertissement suivant s'affiche :

```
Warning: ... AWS will no longer maintain the Homebrew installer for AWS SAM (aws/tap/aws-sam-cli). 
				For AWS supported installations, use the first party installers ...
```

**Cause potentielle : AWS ne plus maintenir le Homebrew support.**  
À compter de septembre 2023, l'Homebrewinstallateur ne AWS sera plus maintenu pour le AWS SAMCLI.  

**Solution : utilisez une méthode d'installation AWS prise en charge.**
+ Vous trouverez les méthodes d'installation AWS prises en charge à l'adresse[Installer la CLI  AWS SAM](install-sam-cli.md).

**Solution : pour continuer à utiliser Homebrew, utilisez le programme d'installation géré par la communauté.**
+ Vous pouvez utiliser le programme d'installation Homebrew géré par la communauté à votre discrétion. Pour obtenir des instructions, veuillez consulter [Gestion de la CLI  AWS SAM avec Homebrew](manage-sam-cli-versions.md#manage-sam-cli-versions-homebrew).

# AWS SAM référence du connecteur
<a name="reference-sam-connector"></a>

Cette section contient des informations de référence pour le type de ressource du connecteur AWS Serverless Application Model (AWS SAM). Pour obtenir une présentation des connecteurs, veuillez consulter [Gestion des autorisations relatives aux ressources à l'aide de AWS SAM connecteurs](managing-permissions-connectors.md).

## Types de ressources source et de destination pris en charge pour les connecteurs
<a name="supported-connector-resource-types"></a>

Le type de ressource `AWS::Serverless::Connector` prend en charge un certain nombre de connexions entre les ressources source et de destination. Lorsque vous configurez des connecteurs dans votre AWS SAM modèle, utilisez le tableau suivant pour référencer les connexions prises en charge et les propriétés qui doivent être définies pour chaque type de ressource source et de destination. Pour plus d'informations sur la configuration de connecteurs dans votre modèle, consultez [AWS::Serverless::Connector](sam-resource-connector.md).

Pour les ressources source et de destination, lorsqu'elles sont définies dans le même modèle, utilisez la propriété `Id`. Sinon, un élément `Qualifier` peut être ajouté pour réduire la portée de la ressource que vous avez définie. Quand les ressources ne se trouvent pas dans le même modèle, utilisez une combinaison d'autres propriétés.

 Pour demander de nouvelles connexions, [soumettez un nouveau problème](https://github.com/aws/serverless-application-model/issues/new?assignees=&labels=area%2Fconnectors,stage%2Fneeds-triage&template=other.md&title=%28New%20Connector%20Profile%29) dans le *serverless-application-model AWS GitHubréférentiel*.


| Source type (Type de source) | Type de destination | Permissions | Propriétés de source | Propriétés de destination | 
| --- | --- | --- | --- | --- | 
| `AWS::ApiGateway::RestApi` | `AWS::Lambda::Function` | `Write` | `Id` ou `Qualifier`, `ResourceId` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::ApiGateway::RestApi` | `AWS::Serverless::Function` | `Write` | `Id` ou `Qualifier`, `ResourceId` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::ApiGatewayV2::Api` | `AWS::Lambda::Function` | `Write` | `Id` ou `Qualifier`, `ResourceId` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::ApiGatewayV2::Api` | `AWS::Serverless::Function` | `Write` | `Id` ou `Qualifier`, `ResourceId` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::AppSync::DataSource` | `AWS::DynamoDB::Table` | `Read` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::AppSync::DataSource` | `AWS::DynamoDB::Table` | `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::AppSync::DataSource` | `AWS::Events::EventBus` | `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::AppSync::DataSource` | `AWS::Lambda::Function` | `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::AppSync::DataSource` | `AWS::Serverless::Function` | `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::AppSync::DataSource` | `AWS::Serverless::SimpleTable` | `Read` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::AppSync::DataSource` | `AWS::Serverless::SimpleTable` | `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::AppSync::GraphQLApi` | `AWS::Lambda::Function` | `Write` | `Id` ou `ResourceId` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::AppSync::GraphQLApi` | `AWS::Serverless::Function` | `Write` | `Id` ou `ResourceId` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::DynamoDB::Table` | `AWS::Lambda::Function` | `Read` | `Id` ou `Arn` et `Type` | `Id` ou `RoleName` et `Type` | 
| `AWS::DynamoDB::Table` | `AWS::Serverless::Function` | `Read` | `Id` ou `Arn` et `Type` | `Id` ou `RoleName` et `Type` | 
| `AWS::Events::Rule` | `AWS::Events::EventBus` | `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Events::Rule` | `AWS::Lambda::Function` | `Write` | `Id` ou `Arn` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Events::Rule` | `AWS::Serverless::Function` | `Write` | `Id` ou `Arn` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Events::Rule` | `AWS::Serverless::StateMachine` | `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Events::Rule` | `AWS::SNS::Topic` | `Write` | `Id` ou `Arn` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Events::Rule` | `AWS::SQS::Queue` | `Write` | `Id` ou `Arn` et `Type` | `Id` ou `Arn`, `QueueUrl` et `Type` | 
| `AWS::Events::Rule` | `AWS::StepFunctions::StateMachine` | `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Lambda::Function` | `AWS::DynamoDB::Table` | `Read`, `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Lambda::Function` | `AWS::Events::EventBus` | `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Lambda::Function` | `AWS::Lambda::Function` | `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Lambda::Function` | `AWS::Location::PlaceIndex` | `Read` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Lambda::Function` | `AWS::S3::Bucket` | `Read`, `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Lambda::Function` | `AWS::Serverless::Function` | `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Lambda::Function` | `AWS::Serverless::SimpleTable` | `Read`, `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Lambda::Function` | `AWS::Serverless::StateMachine` | `Read`, `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn`, `Name` et `Type` | 
| `AWS::Lambda::Function` | `AWS::SNS::Topic` | `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Lambda::Function` | `AWS::SQS::Queue` | `Read`, `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Lambda::Function` | `AWS::StepFunctions::StateMachine` | `Read`, `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn`, `Name` et `Type` | 
| `AWS::S3::Bucket` | `AWS::Lambda::Function` | `Write` | `Id` ou `Arn` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::S3::Bucket` | `AWS::Serverless::Function` | `Write` | `Id` ou `Arn` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Serverless::Api` | `AWS::Lambda::Function` | `Write` | `Id` ou `Qualifier`, `ResourceId` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Serverless::Api` | `AWS::Serverless::Function` | `Write` | `Id` ou `Qualifier`, `ResourceId` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Serverless::Function` | `AWS::DynamoDB::Table` | `Read`, `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Serverless::Function` | `AWS::Events::EventBus` | `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Serverless::Function` | `AWS::Lambda::Function` | `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Serverless::Function` | `AWS::S3::Bucket` | `Read`, `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Serverless::Function` | `AWS::Serverless::Function` | `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Serverless::Function` | `AWS::Serverless::SimpleTable` | `Read`, `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Serverless::Function` | `AWS::Serverless::StateMachine` | `Read`, `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn`, `Name` et `Type` | 
| `AWS::Serverless::Function` | `AWS::SNS::Topic` | `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Serverless::Function` | `AWS::SQS::Queue` | `Read`, `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Serverless::Function` | `AWS::StepFunctions::StateMachine` | `Read`, `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn`, `Name` et `Type` | 
| `AWS::Serverless::HttpApi` | `AWS::Lambda::Function` | `Write` | `Id` ou `Qualifier`, `ResourceId` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Serverless::HttpApi` | `AWS::Serverless::Function` | `Write` | `Id` ou `Qualifier`, `ResourceId` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Serverless::SimpleTable` | `AWS::Lambda::Function` | `Read` | `Id` ou `Arn` et `Type` | `Id` ou `RoleName` et `Type` | 
| `AWS::Serverless::SimpleTable` | `AWS::Serverless::Function` | `Read` | `Id` ou `Arn` et `Type` | `Id` ou `RoleName` et `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::DynamoDB::Table` | `Read`, `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::Events::EventBus` | `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::Lambda::Function` | `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::S3::Bucket` | `Read`, `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::Serverless::Function` | `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::Serverless::SimpleTable` | `Read`, `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::Serverless::StateMachine` | `Read`, `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn`, `Name` et `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::SNS::Topic` | `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::SQS::Queue` | `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::StepFunctions::StateMachine` | `Read`, `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn`, `Name` et `Type` | 
| `AWS::SNS::Topic` | `AWS::Lambda::Function` | `Write` | `Id` ou `Arn` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::SNS::Topic` | `AWS::Serverless::Function` | `Write` | `Id` ou `Arn` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::SNS::Topic` | `AWS::SQS::Queue` | `Write` | `Id` ou `Arn` et `Type` | `Id` ou `Arn`, `QueueUrl` et `Type` | 
| `AWS::SQS::Queue` | `AWS::Lambda::Function` | `Read`, `Write` | `Id` ou `Arn` et `Type` | `Id` ou `RoleName` et `Type` | 
| `AWS::SQS::Queue` | `AWS::Serverless::Function` | `Read`, `Write` | `Id` ou `Arn` et `Type` | `Id` ou `RoleName` et `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::DynamoDB::Table` | `Read`, `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::Events::EventBus` | `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::Lambda::Function` | `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::S3::Bucket` | `Read`, `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::Serverless::Function` | `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::Serverless::SimpleTable` | `Read`, `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::Serverless::StateMachine` | `Read`, `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn`, `Name` et `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::SNS::Topic` | `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::SQS::Queue` | `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn` et `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::StepFunctions::StateMachine` | `Read`, `Write` | `Id` ou `RoleName` et `Type` | `Id` ou `Arn`, `Name` et `Type` | 

## Politiques IAM créées par les connecteurs
<a name="reference-sam-connector-policies"></a>

Cette section décrit les politiques Gestion des identités et des accès AWS (IAM) créées AWS SAM lors de l'utilisation de connecteurs.

`AWS::DynamoDB::Table` sur `AWS::Lambda::Function`  
**Type de politique**  
[La politique gérée par le client](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) jointe au rôle de `AWS::Lambda::Function`.  
**Catégories d'accès**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "dynamodb:DescribeStream",
        "dynamodb:GetRecords",
        "dynamodb:GetShardIterator",
        "dynamodb:ListStreams"
      ],
      "Resource": [
        "%{Source.Arn}/stream/*"
      ]
    }
  ]
}
```

`AWS::Events::Rule` sur `AWS::SNS::Topic`  
**Type de politique**  
[https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-topicpolicy.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-topicpolicy.html) jointe à `AWS::SNS::Topic`.  
**Catégories d'accès**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "events.amazonaws.com"
      },
      "Resource": "%{Destination.Arn}",
      "Action": "sns:Publish",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "%{Source.Arn}"
        }
      }
    }
  ]
}
```

`AWS::Events::Rule` sur `AWS::Events::EventBus`  
**Type de politique**  
[La politique gérée par le client](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) jointe au rôle de `AWS::Events::Rule`.  
**Catégories d'accès**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "events:PutEvents"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::Events::Rule` sur `AWS::StepFunctions::StateMachine`  
**Type de politique**  
[La politique gérée par le client](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) jointe au rôle de `AWS::Events::Rule`.   
**Catégories d'accès**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "states:StartExecution"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::Events::Rule` sur `AWS::Lambda::Function`  
**Type de politique**  
`[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html)` jointe à `AWS::Lambda::Function`.  
**Catégories d'accès**  
`Write`  

```
{
  "Action": "lambda:InvokeFunction",
  "Principal": "events.amazonaws.com",
  "SourceArn": "%{Source.Arn}"
}
```

`AWS::Events::Rule` sur `AWS::SQS::Queue`  
**Type de politique**  
`[AWS::SQS::QueuePolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sqs-queuepolicy.html)` jointe à `AWS::SQS::Queue`.  
**Catégories d'accès**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "events.amazonaws.com"
      },
      "Resource": "%{Destination.Arn}",
      "Action": "sqs:SendMessage",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "%{Source.Arn}"
        }
      }
    }
  ]
}
```

`AWS::Lambda::Function` sur `AWS::Lambda::Function`  
**Type de politique**  
[La politique gérée par le client](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) jointe au rôle de `AWS::Lambda::Function`.  
**Catégories d'accès**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "lambda:InvokeAsync",
        "lambda:InvokeFunction"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::Lambda::Function` sur `AWS::S3::Bucket`  
**Type de politique**  
[La politique gérée par le client](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) jointe au rôle de `AWS::Lambda::Function`.  
**Catégories d'accès**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:GetObject",
        "s3:GetObjectAcl",
        "s3:GetObjectLegalHold",
        "s3:GetObjectRetention",
        "s3:GetObjectTorrent",
        "s3:GetObjectVersion",
        "s3:GetObjectVersionAcl",
        "s3:GetObjectVersionForReplication",
        "s3:GetObjectVersionTorrent",
        "s3:ListBucket",
        "s3:ListBucketMultipartUploads",
        "s3:ListBucketVersions",
        "s3:ListMultipartUploadParts"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/*"
      ]
    }
  ]
}
```
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:AbortMultipartUpload",
        "s3:DeleteObject",
        "s3:DeleteObjectVersion",
        "s3:PutObject",
        "s3:PutObjectLegalHold",
        "s3:PutObjectRetention",
        "s3:RestoreObject"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/*"
      ]
    }
  ]
}
```

`AWS::Lambda::Function` sur `AWS::DynamoDB::Table`  
**Type de politique**  
[La politique gérée par le client](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) jointe au rôle de `AWS::Lambda::Function`.  
**Catégories d'accès**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "dynamodb:GetItem",
        "dynamodb:Query",
        "dynamodb:Scan",
        "dynamodb:BatchGetItem",
        "dynamodb:ConditionCheckItem",
        "dynamodb:PartiQLSelect"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/index/*"
      ]
    }
  ]
}
```
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "dynamodb:PutItem",
        "dynamodb:UpdateItem",
        "dynamodb:DeleteItem",
        "dynamodb:BatchWriteItem",
        "dynamodb:PartiQLDelete",
        "dynamodb:PartiQLInsert",
        "dynamodb:PartiQLUpdate"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/index/*"
      ]
    }
  ]
}
```

`AWS::Lambda::Function` sur `AWS::SQS::Queue`  
**Type de politique**  
[La politique gérée par le client](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) jointe au rôle de `AWS::Lambda::Function`.  
**Catégories d'accès**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "sqs:ReceiveMessage",
        "sqs:GetQueueAttributes"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "sqs:DeleteMessage",
        "sqs:SendMessage",
        "sqs:ChangeMessageVisibility",
        "sqs:PurgeQueue"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::Lambda::Function` sur `AWS::SNS::Topic`  
**Type de politique**  
[La politique gérée par le client](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) jointe au rôle de `AWS::Lambda::Function`.  
**Catégories d'accès**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "sns:Publish"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::Lambda::Function` sur `AWS::StepFunctions::StateMachine`  
**Type de politique**  
[La politique gérée par le client](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) jointe au rôle de `AWS::Lambda::Function`.  
**Catégories d'accès**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "states:StartExecution",
        "states:StartSyncExecution"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "states:StopExecution"
      ],
      "Resource": [
        "arn:${AWS::Partition}:states:${AWS::Region}:${AWS::AccountId}:execution:%{Destination.Name}:*"
      ]
    }
  ]
}
```
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "states:DescribeStateMachine",
        "states:ListExecutions"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "states:DescribeExecution",
        "states:DescribeStateMachineForExecution",
        "states:GetExecutionHistory"
      ],
      "Resource": [
        "arn:${AWS::Partition}:states:${AWS::Region}:${AWS::AccountId}:execution:%{Destination.Name}:*"
      ]
    }
  ]
}
```

`AWS::Lambda::Function` sur `AWS::Events::EventBus`  
**Type de politique**  
[La politique gérée par le client](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) jointe au rôle de `AWS::Lambda::Function`.  
**Catégories d'accès**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "events:PutEvents"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::Lambda::Function` sur `AWS::Location::PlaceIndex`  
**Type de politique**  
[La politique gérée par le client](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) jointe au rôle de `AWS::Lambda::Function`.  
**Catégories d'accès**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "geo:DescribePlaceIndex",
        "geo:GetPlace",
        "geo:SearchPlaceIndexForPosition",
        "geo:SearchPlaceIndexForSuggestions",
        "geo:SearchPlaceIndexForText"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::ApiGatewayV2::Api` sur `AWS::Lambda::Function`  
**Type de politique**  
`[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html)` jointe à `AWS::Lambda::Function`.  
**Catégories d'accès**  
`Write`  

```
{
  "Action": "lambda:InvokeFunction",
  "Principal": "apigateway.amazonaws.com",
  "SourceArn": "arn:${AWS::Partition}:execute-api:${AWS::Region}:${AWS::AccountId}:%{Source.ResourceId}/%{Source.Qualifier}"
}
```

`AWS::ApiGateway::RestApi` sur `AWS::Lambda::Function`  
**Type de politique**  
`[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html)` jointe à `AWS::Lambda::Function`.  
**Catégories d'accès**  
`Write`  

```
{
  "Action": "lambda:InvokeFunction",
  "Principal": "apigateway.amazonaws.com",
  "SourceArn": "arn:${AWS::Partition}:execute-api:${AWS::Region}:${AWS::AccountId}:%{Source.ResourceId}/%{Source.Qualifier}"
}
```

`AWS::SNS::Topic` sur `AWS::SQS::Queue`  
**Type de politique**  
`[AWS::SQS::QueuePolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sqs-queuepolicy.html)` jointe à `AWS::SQS::Queue`.  
**Catégories d'accès**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "sns.amazonaws.com"
      },
      "Resource": "%{Destination.Arn}",
      "Action": "sqs:SendMessage",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "%{Source.Arn}"
        }
      }
    }
  ]
}
```

`AWS::SNS::Topic` sur `AWS::Lambda::Function`  
**Type de politique**  
`[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html)` jointe à `AWS::Lambda::Function`.  
**Catégories d'accès**  
`Write`  

```
{
  "Action": "lambda:InvokeFunction",
  "Principal": "sns.amazonaws.com",
  "SourceArn": "%{Source.Arn}"
}
```

`AWS::SQS::Queue` sur `AWS::Lambda::Function`  
**Type de politique**  
[La politique gérée par le client](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) jointe au rôle de `AWS::Lambda::Function`.  
**Catégories d'accès**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "sqs:DeleteMessage"
      ],
      "Resource": [
        "%{Source.Arn}"
      ]
    }
  ]
}
```
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "sqs:ReceiveMessage",
        "sqs:GetQueueAttributes"
      ],
      "Resource": [
        "%{Source.Arn}"
      ]
    }
  ]
}
```

`AWS::S3::Bucket` sur `AWS::Lambda::Function`  
**Type de politique**  
`[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html)` jointe à `AWS::Lambda::Function`.  
**Catégories d'accès**  
`Write`  

```
{
  "Action": "lambda:InvokeFunction",
  "Principal": "s3.amazonaws.com",
  "SourceArn": "%{Source.Arn}",
  "SourceAccount": "${AWS::AccountId}"
}
```

`AWS::StepFunctions::StateMachine` sur `AWS::Lambda::Function`  
**Type de politique**  
[La politique gérée par le client](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) jointe au rôle de `AWS::StepFunctions::StateMachine`.  
**Catégories d'accès**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "lambda:InvokeAsync",
        "lambda:InvokeFunction"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::StepFunctions::StateMachine` sur `AWS::SNS::Topic`  
**Type de politique**  
[La politique gérée par le client](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) jointe au rôle de `AWS::StepFunctions::StateMachine`.  
**Catégories d'accès**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "sns:Publish"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::StepFunctions::StateMachine` sur `AWS::SQS::Queue`  
**Type de politique**  
[La politique gérée par le client](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) jointe au rôle de `AWS::StepFunctions::StateMachine`.  
**Catégories d'accès**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "sqs:SendMessage"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::StepFunctions::StateMachine` sur `AWS::S3::Bucket`  
**Type de politique**  
[La politique gérée par le client](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) jointe au rôle de `AWS::StepFunctions::StateMachine`.  
**Catégories d'accès**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:GetObject",
        "s3:GetObjectAcl",
        "s3:GetObjectLegalHold",
        "s3:GetObjectRetention",
        "s3:GetObjectTorrent",
        "s3:GetObjectVersion",
        "s3:GetObjectVersionAcl",
        "s3:GetObjectVersionForReplication",
        "s3:GetObjectVersionTorrent",
        "s3:ListBucket",
        "s3:ListBucketMultipartUploads",
        "s3:ListBucketVersions",
        "s3:ListMultipartUploadParts"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/*"
      ]
    }
  ]
}
```
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:AbortMultipartUpload",
        "s3:DeleteObject",
        "s3:DeleteObjectVersion",
        "s3:PutObject",
        "s3:PutObjectLegalHold",
        "s3:PutObjectRetention",
        "s3:RestoreObject"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/*"
      ]
    }
  ]
}
```

`AWS::StepFunctions::StateMachine` sur `AWS::DynamoDB::Table`  
**Type de politique**  
[La politique gérée par le client](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) jointe au rôle de `AWS::StepFunctions::StateMachine`.  
**Catégories d'accès**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "dynamodb:GetItem",
        "dynamodb:Query",
        "dynamodb:Scan",
        "dynamodb:BatchGetItem",
        "dynamodb:ConditionCheckItem",
        "dynamodb:PartiQLSelect"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/index/*"
      ]
    }
  ]
}
```
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "dynamodb:PutItem",
        "dynamodb:UpdateItem",
        "dynamodb:DeleteItem",
        "dynamodb:BatchWriteItem",
        "dynamodb:PartiQLDelete",
        "dynamodb:PartiQLInsert",
        "dynamodb:PartiQLUpdate"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/index/*"
      ]
    }
  ]
}
```

`AWS::StepFunctions::StateMachine` sur `AWS::StepFunctions::StateMachine`  
**Type de politique**  
[La politique gérée par le client](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) jointe au rôle de `AWS::StepFunctions::StateMachine`.  
**Catégories d'accès**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "states:DescribeExecution"
      ],
      "Resource": [
        "arn:${AWS::Partition}:states:${AWS::Region}:${AWS::AccountId}:execution:%{Destination.Name}:*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "events:DescribeRule"
      ],
      "Resource": [
        "arn:${AWS::Partition}:events:${AWS::Region}:${AWS::AccountId}:rule/StepFunctionsGetEventsForStepFunctionsExecutionRule"
      ]
    }
  ]
}
```
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "states:StartExecution"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "states:StopExecution"
      ],
      "Resource": [
        "arn:${AWS::Partition}:states:${AWS::Region}:${AWS::AccountId}:execution:%{Destination.Name}:*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "events:PutTargets",
        "events:PutRule"
      ],
      "Resource": [
        "arn:${AWS::Partition}:events:${AWS::Region}:${AWS::AccountId}:rule/StepFunctionsGetEventsForStepFunctionsExecutionRule"
      ]
    }
  ]
}
```

`AWS::StepFunctions::StateMachine` sur `AWS::Events::EventBus`  
**Type de politique**  
[La politique gérée par le client](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) jointe au rôle de `AWS::StepFunctions::StateMachine`.  
**Catégories d'accès**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "events:PutEvents"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::AppSync::DataSource` sur `AWS::DynamoDB::Table`  
**Type de politique**  
[La politique gérée par le client](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) jointe au rôle de `AWS::AppSync::DataSource`.  
**Catégories d'accès**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "dynamodb:GetItem",
        "dynamodb:Query",
        "dynamodb:Scan",
        "dynamodb:BatchGetItem",
        "dynamodb:ConditionCheckItem",
        "dynamodb:PartiQLSelect"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/index/*"
      ]
    }
  ]
}
```
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "dynamodb:PutItem",
        "dynamodb:UpdateItem",
        "dynamodb:DeleteItem",
        "dynamodb:BatchWriteItem",
        "dynamodb:PartiQLDelete",
        "dynamodb:PartiQLInsert",
        "dynamodb:PartiQLUpdate"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/index/*"
      ]
    }
  ]
}
```

`AWS::AppSync::DataSource` sur `AWS::Lambda::Function`  
**Type de politique**  
[La politique gérée par le client](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) jointe au rôle de `AWS::AppSync::DataSource`.  
**Catégories d'accès**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "lambda:InvokeAsync",
        "lambda:InvokeFunction"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}:*"
      ]
    }
  ]
}
```

`AWS::AppSync::DataSource` sur `AWS::Events::EventBus`  
**Type de politique**  
[La politique gérée par le client](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) jointe au rôle de `AWS::AppSync::DataSource`.  
**Catégories d'accès**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "events:PutEvents"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::AppSync::GraphQLApi` sur `AWS::Lambda::Function`  
**Type de politique**  
`[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html)` jointe à `AWS::Lambda::Function`.  
**Catégories d'accès**  
`Write`  

```
{
  "Action": "lambda:InvokeFunction",
  "Principal": "appsync.amazonaws.com",
  "SourceArn": "arn:${AWS::Partition}:appsync:${AWS::Region}:${AWS::AccountId}:apis/%{Source.ResourceId}"
}
```

# Installation de Docker pour une utilisation avec la CLI  AWS SAM
<a name="install-docker"></a>

Docker est une application qui exécute des conteneurs sur votre machine. AvecDocker, AWS SAM peut fournir un environnement local similaire à AWS Lambda un conteneur pour créer, tester et déboguer vos applications sans serveur.

**Note**  
Docker n'est requis que pour tester vos applications localement et pour créer des packages de déploiement à l'aide de l'option `--use-container`.

**Topics**
+ [

## Installation deDocker
](#install-docker-instructions)
+ [

## Étapes suivantes
](#install-docker-next-steps)

## Installation deDocker
<a name="install-docker-instructions"></a>

Pour installer Docker sur votre système d'exploitation, suivez ces instructions.

### Linux
<a name="install-docker-instructions-linux"></a>

Docker est disponible sur de nombreux systèmes d'exploitation différents, y compris les distributions Linux les plus modernes, telles que CentOS, Debian et Ubuntu. Pour plus d'informations sur l'installation de Docker sur votre système d'exploitation particulier, veuillez consulter la section [Obtenir Docker](https://docs.docker.com/get-docker/) sur le site web Docker Docs (langue française non garantie).

**Pour installer Docker sur Amazon Linux 2 ou Amazon Linux 2023**

1. Mettez à jour les packages installés et le cache du package sur votre instance.

   ```
   $ sudo yum update -y
   ```

1. Installez la version la plus récente du package Docker Community Edition.
   + Pour Amazon Linux 2, exécutez la commande suivante :

     ```
     $ sudo amazon-linux-extras install docker
     ```
   + Pour Amazon Linux 2023, exécutez la commande suivante :

     ```
     $ sudo yum install -y docker
     ```

1. Lancez le service Docker.

   ```
   $ sudo service docker start
   ```

1. Ajoutez `ec2-user` au groupe `docker` afin de pouvoir exécuter les commandes Docker sans utiliser **sudo**.

   ```
   $ sudo usermod -a -G docker ec2-user
   ```

1. Déconnectez-vous et reconnectez-vous pour récupérer les nouvelles autorisations de groupe `docker`. Pour cela, fermez votre fenêtre de terminal SSH actuelle et en vous reconnectant à votre instance dans une nouvelle fenêtre. Votre nouvelle session SSH devrait disposer des autorisations de groupe `docker` appropriées.

1. Vérifiez que `ec2-user` puisse exécuter les commandes Docker sans utiliser **sudo**.

   ```
   $ docker ps
   ```

   La sortie suivante doit s'afficher. Elle confirme que Docker est installé et en cours d'exécution :

   ```
    CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
   ```

**Note**  
Sous Linux, pour créer et exécuter des fonctions Lambda avec une architecture de jeu d'instructions différente de celle de votre machine hôte, la configuration de Docker nécessite quelques étapes supplémentaires. Par exemple, pour exécuter des fonctions `arm64` sur une machine `x86_64`, vous pouvez exécuter la commande suivante afin de configurer le démon Docker : `docker run --rm --privileged multiarch/qemu-user-static --reset -p yes`.

Si vous rencontrez des problèmes lors de l'installation de Docker, veuillez consulter la section [Résolution des erreurs d'installation](install-sam-cli.md#sam-cli-troubleshoot-install). Ou, consultez la section [Dépannage](https://docs.docker.com/engine/install/linux-postinstall/#troubleshooting) de **Étapes de post-installation pour Linux** sur le site web Docker Docs.

### macOS
<a name="install-docker-instructions-macos"></a>

**Note**  
Docker Desktop est officiellement pris en charge, mais à partir de la version 1.47.0 de la CLI  AWS SAM, vous pouvez utiliser des alternatives tant qu'elles utilisent le moteur d'exécution Docker.

1. Installer Docker

   La CLI  AWS SAM prend en charge Docker s'exécutant sur macOS Sierra 10.12 ou version ultérieure. Pour découvrir comment installer Docker, veuillez consulter la section [Installer Docker Desktop pour Mac](https://docs.docker.com/docker-for-mac/install/) sur le site web Docker Docs (langue française non garantie).

1. Configurer vos lecteurs partagés

   Le AWS SAMCLI nécessite que le répertoire du projet, ou tout répertoire parent, soit répertorié sur un lecteur partagé. Cela peut nécessiter le partage de fichiers. Pour plus d'informations, consultez la rubrique de résolution des problèmes liés au [montage de volumes nécessitant le partage de fichiers](https://docs.docker.com/desktop/troubleshoot-and-support/troubleshoot/topics/#volume-mounting-requires-file-sharing-for-any-project-directories-outside-of-home) dans la section *Documents Docker*.

1. Vérifier l'installation

   Une fois Docker installé, vérifiez qu'il fonctionne. Confirmez également que vous pouvez exécuter des commandes Docker à partir de la ligne de commande (par exemple, `docker ps`). Vous n'avez pas besoin d'installer, de récupérer ou de tirer un conteneur, la CLI  AWS SAM le fait automatiquement selon les besoins.

Si vous rencontrez des problèmes lors de l'installation de Docker, veuillez consulter la section [Dépannage et diagnostic](https://docs.docker.com/docker-for-mac/troubleshoot/) du site web Docker Docs afin d'obtenir davantage de conseils de dépannage (langue française non garantie).

### Windows
<a name="install-docker-instructions-windows"></a>

**Note**  
AWS SAM prend officiellement en charge Docker Desktop. Toutefois, à partir de la version 1.47.0 de la CLI  AWS SAM, vous pouvez utiliser des alternatives tant qu'elles utilisent le moteur d'exécution Docker.

1. Installer Docker.

   Docker Desktop prend en charge la version la plus récente du système d'exploitation Windows. Pour les versions héritées de Windows, la boîte à outils Docker est disponible. Choisissez votre version de Windows pour les étapes d'installation correctes de Docker :
   + Pour installer Docker sous Windows 10, veuillez consulter la section [Installer Docker Desktop pour Windows](https://docs.docker.com/docker-for-windows/install/) sur le site web Docker Docs (langue française non garantie).
   + Pour effectuer l'installation Docker pour les versions antérieures de Windows, voir [The Docker Toolbox dans](https://github.com/docker-archive/toolbox) le référentiel Docker Toolbox. GitHub 

1. Configurez vos lecteurs partagés.

   Le AWS SAMCLI nécessite que le répertoire du projet, ou tout répertoire parent, soit répertorié sur un lecteur partagé. Dans certains cas, vous devez partager votre disque pour que Docker fonctionne correctement.

1. Vérifiez l’installation.

   Une fois Docker installé, vérifiez qu'il fonctionne. Confirmez également que vous pouvez exécuter des commandes Docker à partir de la ligne de commande (par exemple, **docker ps**). Vous n'avez pas besoin d'installer, de récupérer ou de tirer un conteneur, la CLI  AWS SAM le fait automatiquement selon les besoins.

Si vous rencontrez des problèmes lors de l'installation de Docker, veuillez consulter la section [Dépannage et diagnostic](https://docs.docker.com/docker-for-mac/troubleshoot/) du site web Docker Docs afin d'obtenir davantage de conseils de dépannage (langue française non garantie).

## Étapes suivantes
<a name="install-docker-next-steps"></a>

Pour savoir comment installer le AWS SAMCLI, voir[Installer la CLI  AWS SAM](install-sam-cli.md).

# Installation Finch à utiliser avec la AWS SAM CLI
<a name="install-finch"></a>

Finch AWS est un outil de développement de conteneurs qui fournit une alternative particulièrement avantageuse sur les systèmes macOS et Linux. Docker Pour plus d'informations, voir [Finch sur GitHub](https://github.com/runfinch). AvecFinch, AWS SAM peut fournir un environnement local similaire à AWS Lambda un conteneur pour créer, tester et déboguer vos applications sans serveur.

**Note**  
Vous devez Finch tester vos applications localement, créer des packages de déploiement à l'aide de l'`--use-container`option et créer des fonctions d'image OCI. À partir de la version 1.145.0 de la AWS SAM CLI, la AWS SAM CLI prend Finch en charge l'exécution de conteneurs alternative à. Docker

**Topics**
+ [

## Installation deFinch
](#install-finch-instructions)
+ [

## Configuration à l'Finchaide de la AWS SAM CLI
](#install-finch-configuration)
+ [

## Vérification de l'installation
](#install-finch-verification)
+ [

## Arrêt d'Finch
](#install-finch-stopping)
+ [

## Résolution des problèmes
](#install-finch-troubleshooting)
+ [

## Étapes suivantes
](#install-finch-next-steps)

## Installation deFinch
<a name="install-finch-instructions"></a>

Pour installer Finch sur votre système d'exploitation, suivez ces instructions.

### Conditions préalables
<a name="install-finch-prerequisites"></a>

**Note**  
Finchl'intégration dans la AWS SAM CLI est disponible sur les systèmes macOS et Linux. Pour les utilisateurs de Windows, pensez à utiliser une machine virtuelle ou un environnement Linux pour les Finch fonctionnalités.

**Versions de macOS :**
+ macOS 15 Séquoia
+ macOS 14 Sonoma

**Note**  
Finchprend en charge les deux dernières versions de macOS.

**Linux :**
+ Noyau Linux v4.x\$1

### Installation de Finch
<a name="install-finch"></a>

#### macOS
<a name="install-finch-instructions-macos"></a>

**Pour installer Finch sur MacOS**

1. Installation Finch à l'aide de la `brew` CLI. Si vous y êtes invité, entrez votre mot de passe macOS.

   ```
   $ brew install finch
   ```

1. Vérifiez la Finch version installée.

   ```
   $ finch --version
   ```

1. Initialisez la machine Finch virtuelle (première configuration).

   ```
   $ finch vm init
   ```

1. Démarrez la machine Finch virtuelle.

   ```
   $ finch vm start
   ```

1. Vérifiez l'état de la machine Finch virtuelle.

   ```
   $ finch vm status
   ```

1. Vérifiez que cela Finch fonctionne correctement.

   ```
   $ finch --info
   $ finch ps
   ```

Pour plus d'informations, consultez la section [Installation de Finch sur macOS](https://runfinch.com/docs/managing-finch/macos/installation/).

#### Linux
<a name="install-finch-instructions-linux"></a>

Vous pouvez effectuer l'installation Finch sur Amazon Linux, Ubuntu ou en utilisant une méthode d'installation générique. Pour plus d'informations, consultez [Installation de Finch sous Linux.](https://runfinch.com/docs/managing-finch/linux/installation/)

## Configuration à l'Finchaide de la AWS SAM CLI
<a name="install-finch-configuration"></a>

Après l'installationFinch, la AWS SAM CLI détecte et utilise automatiquement Finch comme environnement d'exécution du conteneur lorsqu'elle Docker ne s'exécute pas.

**Note**  
Finchsert de solution de repli à. Docker Si vous avez Finch installé Docker et exécuté les deux, la AWS SAM CLI hiérarchise Docker par défaut.

### Configuration des préférences de l'administrateur (macOS)
<a name="install-finch-configuration-preference"></a>

Vous pouvez configurer la AWS SAM CLI pour utiliser un environnement d'exécution de conteneur spécifique par défaut en créant un fichier de préférences d'administrateur. Cette préférence à l'échelle du système remplace le comportement de secours par défaut.

**Options de configuration disponibles**
+ **Définissez Finch comme environnement d'exécution du conteneur préféré :**

  ```
  $ sudo /usr/libexec/PlistBuddy -c "Add :DefaultContainerRuntime string finch" /Library/Preferences/com.amazon.samcli.plist
  ```
+ **Définissez Docker comme environnement d'exécution du conteneur préféré :**

  ```
  $ sudo /usr/libexec/PlistBuddy -c "Add :DefaultContainerRuntime string docker" /Library/Preferences/com.amazon.samcli.plist
  ```
+ **Supprimer la préférence (retour au comportement par défaut) :**

  ```
  $ sudo /usr/libexec/PlistBuddy -c "Remove :DefaultContainerRuntime" /Library/Preferences/com.amazon.samcli.plist
  ```

**Note**  
Lorsqu'aucune préférence d'administrateur n'est définie, la AWS SAM CLI l'utilise Docker par défaut lorsqu'elle est disponible, avec Finch comme solution de secours lorsqu'elle n'Dockerest pas en cours d'exécution.

### Différences de montage de répertoires (macOS)
<a name="install-finch-differences"></a>

Sur macOS, les commandes AWS SAM locales échouent si vous localisez votre projet en dehors de votre répertoire personnel (`~`) ou`/Volumes`. Cette conception restreint le montage automatique de répertoires pour des raisons de sécurité à votre insu.

**Options d'atténuation**
+ **Option 1 :** Ouvrez la configuration Finch dans un éditeur de texte `~/.finch/finch.yaml` et ajoutez le chemin de votre projet sous la `additional_directories` section, puis redémarrez la machine Finch virtuelle. Pour plus d'informations, consultez la [documentation Finch](https://runfinch.com/docs/managing-finch/macos/disk-management/#adding-additional-disk-mounts).

  ```
  $ finch vm stop
  $ finch vm start
  ```
+ **Option 2 :** déplacez votre projet vers votre répertoire personnel.

## Vérification de l'installation
<a name="install-finch-verification"></a>

Après l'installation et le démarrageFinch, vérifiez qu'il fonctionne avec la AWS SAM CLI.

### Vérification de base
<a name="install-finch-verification-basic"></a>

Exécutez la commande suivante pour vérifier que la AWS SAM CLI peut utiliser Finch :

```
$ sam build --use-container
```

Vous devriez voir la AWS SAM CLI Finch utilisée pour créer votre application dans un environnement de conteneur.

**Note**  
Finchsert de solution de repli à. Docker Si elle Docker est en cours d'exécution, la AWS SAM CLI donnera la priorité Docker par défaut.

### Les tests Finch comme solution de secours
<a name="install-finch-verification-fallback"></a>

Pour effectuer un test Finch en tant que solution de secours en Docker cours d'exécution, vous devez d'Dockerabord vous arrêter.

**Pour tester la fonctionnalité de Finch secours**

1. Arrêtez Docker d'utiliser les commandes adaptées à votre système d'exploitation.

   **macOS :**

   ```
   $ docker stop $(docker ps -q)
   $ pkill -f "Docker Desktop"
   ```

   DockerLa vérification est arrêtée.

   ```
   $ docker ps
   ```

   **Linux :**

   ```
   $ docker stop $(docker ps -q)
   $ sudo systemctl stop docker
   ```

   DockerLa vérification est arrêtée.

   ```
   $ sudo systemctl status docker
   ```

1. Exécutez la `sam build --use-container` commande pour vérifier que la AWS SAM CLI est automatiquement utilisée Finch comme solution de secours.

## Arrêt d'Finch
<a name="install-finch-stopping"></a>

Si vous devez vous arrêterFinch, utilisez les commandes suivantes :

**macOS :**

```
$ finch vm stop
$ sudo pkill -f finch
```

FinchLa vérification est arrêtée.

```
$ finch vm status
```

**Linux :**

```
$ sudo systemctl stop finch
$ sudo pkill -f finch
```

FinchLa vérification est arrêtée.

```
$ sudo systemctl status finch
```

## Résolution des problèmes
<a name="install-finch-troubleshooting"></a>

Si vous rencontrez des problèmes avec Finch :
+ Vérifiez que votre système d'exploitation répond aux exigences requises.
+ Vérifiez que vous avez activé la virtualisation sur votre système.
+ Pour macOS, vérifiez que vous disposez de suffisamment d'espace disque pour la machine virtuelle.
+ Pour Linux, vérifiez que vous disposez des autorisations nécessaires pour exécuter `systemctl` des commandes.
+ Si vous rencontrez des échecs de CloudFormation déploiement avec des erreurs « type de support non pris en charge » lorsque vous transférez des images multi-architectures vers Amazon Elastic Container Registry (Amazon ECR), créez un artefact d'image unique au lieu d'utiliser des images multi-architectures. Cela se produit car envoie Finch à la fois l'index de l'image et l'image vers Amazon ECR, alors que seule l'Dockerimage est envoyée.
+ Si la construction multiplateforme échoue lorsque l'architecture de la fonction cible ne correspond pas à l'architecture de la machine hôte sous Linux, activez l'émulation multiplateforme en exécutant. `sudo finch run --privileged --rm tonistiigi/binfmt:master --install all`

Pour un dépannage supplémentaire, consultez la [documentation Finch](https://runfinch.com/docs/) ou le[Résolution des problèmes de la CLI AWS SAM](sam-cli-troubleshooting.md).

## Étapes suivantes
<a name="install-finch-next-steps"></a>

Maintenant que vous l'avez Finch installé, vous pouvez l'utiliser avec la AWS SAM CLI pour :
+ Créez des applications sans serveur à l'aide de conteneurs avec`sam build --use-container`. Pour de plus amples informations, veuillez consulter [sam build](sam-cli-command-reference-sam-build.md).
+ Testez les fonctions Lambda localement avec. `sam local invoke` Pour de plus amples informations, veuillez consulter [sam local invoke](sam-cli-command-reference-sam-local-invoke.md).
+ Démarrez une API Gateway locale avec`sam local start-api`. Pour de plus amples informations, veuillez consulter [sam local start-api](sam-cli-command-reference-sam-local-start-api.md).
+ Démarrez un point de terminaison Lambda local avec. `sam local start-lambda` Pour de plus amples informations, veuillez consulter [sam local start-lambda](sam-cli-command-reference-sam-local-start-lambda.md).

Pour plus d'informations sur l'utilisation de la AWS SAM CLI avec des conteneurs, consultez[Construit par défaut avec AWS SAM](serverless-sam-cli-using-build.md).

# Référentiels d'images pour AWS SAM
<a name="serverless-image-repositories"></a>

AWS SAM simplifie les tâches d'intégration continue et de livraison continue (CI/CD) pour les applications sans serveur à l'aide de la création d'images de conteneur. Les images AWS SAM fournies incluent l'interface de ligne de AWS SAM commande (CLI) et les outils de génération pour un certain nombre d'environnements d' AWS Lambda exécution pris en charge. Cela facilite la création et l'empaquetage d'applications sans serveur à l'aide de la CLI  AWS SAM. Vous pouvez utiliser ces images avec des CI/CD systèmes pour automatiser la création et le déploiement d' AWS SAM applications. Pour obtenir des exemples, consultez [Déployez avec CI/CD des systèmes et des pipelines](deploying-options.md#serverless-deploying-ci-cd).

AWS SAM URIs les images du conteneur de construction sont étiquetées avec la version AWS SAMCLI incluse dans cette image. Si vous spécifiez l'URI non balisé, la dernière version sera utilisée. Par exemple, `public.ecr.aws/sam/build-nodejs20.x` utilise la dernière image. Toutefois, `public.ecr.aws/sam/build-nodejs20.x:1.24.1` utilise l'image contenant la CLI AWS SAM version 1.24.1.

À partir de la version 1.33.0 de, les images AWS SAMCLI, les deux `x86_64` et les images de `arm64` conteneur sont disponibles pour les environnements d'exécution pris en charge. Pour en savoir plus amples, consultez la section [Quotas Lambda](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html) du *Guide du développeur AWS Lambda *.

**Note**  
Avant la version 1.22.0 de AWS SAMCLI, DockerHub était le référentiel par défaut à partir duquel l'image du conteneur était AWS SAMCLI extraite. À partir de la version 1.22.0, le référentiel par défaut devient Amazon Elastic Container Registry Public (Amazon ECR Public). Pour extraire une image de conteneur d'un référentiel autre que la valeur par défaut actuelle, vous pouvez utiliser la commande **[sam build](sam-cli-command-reference-sam-build.md)** avec l'option **--build-image**. Les exemples présentés à la fin de cette rubrique montrent comment créer des applications à l'aide d'images de DockerHub référentiel.

## Référentiel d'images URIs
<a name="serverless-image-repository-uris"></a>

Le tableau suivant répertorie les images URIs de conteneur de construction [Amazon ECR Public](https://docs.aws.amazon.com/AmazonECR/latest/public/what-is-ecr.html) que vous pouvez utiliser pour créer et empaqueter des applications sans serveur. AWS SAM

**Note**  
Amazon ECR Public a remplacé DockerHub à partir de la version 1.22.0 de la CLI  AWS SAM. Si vous utilisez une version antérieure du AWS SAMCLI, nous vous recommandons de procéder à une mise à niveau.


| Environnement d’exécution |  Amazon ECR Public | 
| --- | --- | 
| Temps d'exécution personnalisé (AL2023) | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-provided.al2023)-provid.al 2023 | 
| Environnement d'exécution personnalisé (AL2) | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-provided.al2)-provid.al2 | 
| Environnement d’exécution personnalisé | [public.ecr. aws/sam/build-fourni](https://gallery.ecr.aws/sam/build-provided) | 
| Java 25 | [public.ecr. aws/sam/build-java 25](https://gallery.ecr.aws/sam/build-java25) | 
| Java 21 | [public.ecr. aws/sam/build-java 21](https://gallery.ecr.aws/sam/build-java21) | 
| Java 17 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-java17)-java17 | 
| Java 11 | [public.ecr. aws/sam/build-java 11](https://gallery.ecr.aws/sam/build-java11) | 
| Java 8 | [public.ecr. aws/sam/build-java 8](https://gallery.ecr.aws/sam/build-java8) | 
| .NET 9 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-dotnet9)-dotnet9 | 
| .NET 8 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-dotnet8)-dotnet 8 | 
| .NET 7 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-dotnet7)-dotnet7 | 
| .NET 6 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-dotnet6)-dotnet6 | 
| Node.js 24 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-nodejs24.x)-nodejs24.x | 
| Node.js 22 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-nodejs22.x)-nodejs22.x | 
| Node.js 20 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-nodejs20.x)-nodejs20.x | 
| Node.js 18 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-nodejs18.x)-nodejs 18.x | 
| Node.js 16 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-nodejs16.x)-nodejs16.x | 
| Python 3.14 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-python3.14)-python3,14 | 
| Python 3.13 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-python3.13)-python3,13 | 
| Python 3.12 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-python3.12)-python3.12 | 
| Python 3.11 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-python3.11)-python3.11 | 
| Python 3.10 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-python3.10)-python3.10 | 
| Python 3.9 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-python3.9)-python3.9 | 
| Python 3.8 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-python3.8)-python3,8 | 
| Ruby 3.4 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-ruby3.4)- rubis 3,4 | 
| Ruby 3.3 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-ruby3.3)- rubis 3,3 | 
| Ruby 3.2 | [public.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-ruby3.2)- rubis 3,2 | 

## Exemples
<a name="serverless-image-repository-example-commands"></a>

Les deux exemples de commandes suivants créent des applications à l'aide d'images de conteneur issues du référentiel d'images :

**Créez une Node.js 24 application à l'aide d'une image de conteneur extraite d'Amazon ECR** :

```
$ sam build --use-container --build-image public.ecr.aws/sam/build-nodejs24.x
```

**Créez une ressource fonctionnelle à l'aide de l'image du Python 3.14 conteneur extraite d'Amazon ECR** :

```
$ sam build --use-container --build-image Function1=public.ecr.aws/sam/build-python3.14
```

# Déploiement progressif d'applications sans serveur avec AWS SAM
<a name="automating-updates-to-serverless-apps"></a>

AWS Serverless Application Model (AWS SAM) est intégré [CodeDeploy](https://docs.aws.amazon.com/codedeploy/latest/userguide/welcome.html)pour permettre des AWS Lambda déploiements progressifs. À l'aide de quelques lignes de configuration, AWS SAM effectue les opérations suivantes pour vous :
+ Déploie de nouvelles versions de la fonction Lambda et crée automatiquement des alias qui pointent vers la nouvelle version.
+ Déplace progressivement le trafic client vers la nouvelle version jusqu'à ce que vous estimiez qu'elle fonctionne comme prévu. Si une mise à jour ne fonctionne pas correctement, vous pouvez annuler les modifications.
+ Définit des fonctions de test pré- et post-trafic afin de vérifier que le code qui vient d'être déployé est correctement configuré et que l'application fonctionne comme prévu.
+ Annule automatiquement le déploiement si des CloudWatch alarmes sont déclenchées.

**Note**  
Si vous activez les déploiements progressifs via votre AWS SAM modèle, une CodeDeploy ressource est automatiquement créée pour vous. Vous pouvez consulter la CodeDeploy ressource directement via le AWS Management Console.

**Exemple**

L'exemple suivant illustre l'utilisation de CodeDeploy pour transférer progressivement les clients vers votre version récemment déployée de la fonction Lambda :

```
Resources:
MyLambdaFunction:
  Type: AWS::Serverless::Function
  Properties:
    Handler: index.handler
    Runtime: nodejs20.x
    CodeUri: s3://bucket/code.zip

    AutoPublishAlias: live

    DeploymentPreference:
      Type: Canary10Percent10Minutes 
      Alarms:
        # A list of alarms that you want to monitor
        - !Ref AliasErrorMetricGreaterThanZeroAlarm
        - !Ref LatestVersionErrorMetricGreaterThanZeroAlarm
      Hooks:
        # Validation Lambda functions that are run before & after traffic shifting
        PreTraffic: !Ref PreTrafficLambdaFunction
        PostTraffic: !Ref PostTrafficLambdaFunction
```

Ces révisions du AWS SAM modèle permettent d'effectuer les opérations suivantes :
+ `AutoPublishAlias`: En ajoutant cette propriété et en spécifiant un nom d'alias, AWS SAM :
  + Détecte le déploiement d'un nouveau code, en fonction des modifications apportées à l'URI Amazon S3 de la fonction Lambda.
  + Crée et publie une version mise à jour de cette fonction avec la dernière mise à jour du code.
  + Crée un alias avec un nom que vous spécifiez (sauf s'il existe déjà un alias) en pointant vers la version mise à jour de la fonction Lambda. Pour cela, les appels de fonction doivent utiliser le qualificateur de l'alias. Si vous n'êtes pas familier avec la gestion des versions et les alias des fonctions Lambda, consultez les [versions et alias des fonctions AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html).
+ `Deployment Preference Type` : dans l'exemple précédent, 10 % de votre trafic client est immédiatement déplacé vers la nouvelle version. Après 10 minutes, tout le trafic est déplacé vers la nouvelle version. Toutefois, si vos tests avant ou après le trafic échouent, ou si une CloudWatch alarme est déclenchée, annulez CodeDeploy votre déploiement. Vous pouvez spécifier la manière dont le trafic doit être déplacé d'une version à l'autre comme suit :
  + `Canary` : le trafic est déplacé en deux incréments. Vous pouvez choisir parmi les options Canary prédéfinies. Les options spécifient le pourcentage de trafic qui est déplacé vers la version mise à jour de votre fonction Lambda dans le premier incrément, et l'intervalle en minutes avant que le trafic restant soit déplacé dans le second incrément. 
  + `Linear` : le trafic est déplacé en incréments égaux avec un nombre égal de minutes entre chaque incrément. Vous pouvez choisir parmi les options linéaires prédéfinies qui définissent le pourcentage de trafic déplacé pour chaque incrément et le nombre de minutes entre chaque incrément. 
  + `AllAtOnce` : tout le trafic est déplacé en même temps de la fonction Lambda initiale vers sa version mise à jour. 

  Le tableau ci-dessous décrit les autres options de déplacement du trafic disponibles, outre celle qui est utilisée dans l'exemple.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/serverless-application-model/latest/developerguide/automating-updates-to-serverless-apps.html)
+ `Alarms`: il s'agit d' CloudWatch alarmes déclenchées par toute erreur générée par le déploiement. Elles annulent automatiquement votre déploiement. Par exemple, si le code mis à jour que vous déployez entraîne des erreurs dans l'application. Autre exemple : si l'une des métriques [AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/monitoring-functions-metrics.html)ou CloudWatch des métriques personnalisées que vous avez spécifiées ont dépassé le seuil d'alarme.
+ `Hooks` : fonctions de test pré- et post-trafic qui procèdent à des vérifications avant que ne commence le déplacement du trafic vers la nouvelle version et une fois ce déplacement terminé.
  + `PreTraffic`: Avant le début du transfert de trafic, CodeDeploy invoque la fonction Lambda du pré-trafic Hook. Cette fonction Lambda doit rappeler CodeDeploy et indiquer le succès ou l'échec. Si la fonction échoue, elle est abandonnée et signale un échec à CloudFormation. Si la fonction réussit, CodeDeploy passe au transfert de trafic.
  + `PostTraffic`: Une fois le transfert de trafic terminé, CodeDeploy invoque la fonction Lambda post-traffic hook. Ceci est similaire au hook pré-trafic, où la fonction doit rappeler CodeDeploy à pour signaler un succès ou un échec. Utilisez les crochets post-trafic pour exécuter des tests d'intégration ou d'autres opérations de validation.

  Pour en savoir plus, consultez [SAM Reference to Safe Deployments (Référence SAM pour des déploiements en toute sécurité)](https://github.com/aws/serverless-application-model/blob/master/docs/safe_lambda_deployments.rst). 

## Déploiement progressif d'une fonction Lambda pour la première fois
<a name="automating-updates-to-serverless-apps-first-time"></a>

 Lors du déploiement progressif d'une fonction Lambda, une version de fonction préalablement déployée est CodeDeploy nécessaire pour transférer le trafic. Par conséquent, votre premier déploiement doit se faire en deux étapes : 
+ **Étape 1** : déployer votre fonction Lambda et créer automatiquement des alias avec `AutoPublishAlias`.
+ **Étape 2** : réaliser votre déploiement progressif avec `DeploymentPreference`.

Si vous effectuez votre premier déploiement progressif en deux étapes, vous pouvez utiliser CodeDeploy une version précédente de la fonction Lambda à partir de laquelle transférer le trafic.

### Étape 1 : déployer votre fonction Lambda
<a name="automating-updates-to-serverless-apps-first-time-step1"></a>

```
Resources:
MyLambdaFunction:
  Type: AWS::Serverless::Function
  Properties:
    Handler: index.handler
    Runtime: nodejs20.x
    CodeUri: s3://bucket/code.zip

    AutoPublishAlias: live
```

### Étape 2 : réaliser votre déploiement progressif
<a name="automating-updates-to-serverless-apps-first-time-step2"></a>

```
Resources:
MyLambdaFunction:
  Type: AWS::Serverless::Function
  Properties:
    Handler: index.handler
    Runtime: nodejs20.x
    CodeUri: s3://bucket/code.zip

    AutoPublishAlias: live

    DeploymentPreference:
      Type: Canary10Percent10Minutes 
      Alarms:
        # A list of alarms that you want to monitor
        - !Ref AliasErrorMetricGreaterThanZeroAlarm
        - !Ref LatestVersionErrorMetricGreaterThanZeroAlarm
      Hooks:
        # Validation Lambda functions that are run before and after traffic shifting
        PreTraffic: !Ref PreTrafficLambdaFunction
        PostTraffic: !Ref PostTrafficLambdaFunction
```

## En savoir plus
<a name="automating-updates-to-serverless-apps-learn"></a>

Pour un exemple pratique de configuration d'un déploiement progressif, consultez le [Module 5 – déploiements Canary](https://s12d.com/sam-ws-en-canaries) dans *L'atelier AWS SAM complet*.

# Remarques de référence importantes pour AWS SAM
<a name="important-notes"></a>

Cette section contient des notes et des annonces importantes pour AWS Serverless Application Model (AWS SAM).

**Topics**
+ [

## Notes importantes pour 2023
](#important-notes-2023)

## Notes importantes pour 2023
<a name="important-notes-2023"></a>

### Octobre 2023
<a name="important-notes-2023-10"></a>

#### Fin de la prise en charge de Python 3.7 par l'CLIAWS SAM
<a name="important-notes-2023-10-python"></a>

*Date de publication : 20/10/2023*

Python 3.7a reçu le end-of-life statut en juin 2023. Le support AWS SAM CLI cessera d'être pris en charge Python 3.7 le 24 octobre 2023. Pour plus d'informations, consultez l'[annonce](https://github.com/aws/aws-sam-cli/issues/5889) publiée dans le *aws-sam-cli GitHubréférentiel*.

Cette modification concerne les utilisateurs suivants :
+ Si vous utilisez Python 3.7 et installez le AWS SAM CLI through`pip`.
+ Si vous utilisez `aws-sam-cli` en tant que bibliothèque et que vous créez votre application avec Python 3.7.

Si vous l'installez et le gérez AWS SAM CLI par une autre méthode, vous n'êtes pas concerné.

Pour les utilisateurs concernés, nous vous recommandons de mettre à niveau votre environnement de développement vers une version Python 3.8 plus récente.

Cette modification n'affecte pas la prise en charge de l'environnement Python 3.7 AWS Lambda d'exécution. Pour en savoir plus, consultez la rubrique [politique d'obsolescence de l'exécution](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy) du *Guide du développeur AWS Lambda *.