Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# AWS SAM riferimento
<a name="serverless-sam-reference"></a>

 Questa sezione contiene materiale AWS SAM di riferimento. Ciò include materiale AWS SAMCLI di riferimento, come informazioni di riferimento sui AWS SAMCLI comandi e AWS SAMCLI informazioni aggiuntive, come la configurazione, il controllo della versione e la risoluzione dei problemi. Inoltre, questa sezione include informazioni di riferimento sulla AWS SAM specifica e sul AWS SAM modello, come informazioni di riferimento su connettori, archivi di immagini e distribuzioni. 

## AWS SAM le specifiche e il modello AWS SAM
<a name="serverless-sam-spec"></a>

La AWS SAM specifica è una specifica open source con licenza Apache 2.0. La versione corrente della AWS SAM specifica è disponibile in. [AWS SAM modello](sam-specification.md) AWS SAM la specifica viene fornita con una sintassi abbreviata semplificata utilizzata per definire le funzioni, gli eventi APIs, le configurazioni e le autorizzazioni dell'applicazione serverless. 

L'interazione con le AWS SAM specifiche avviene tramite la directory del progetto AWS SAM dell'applicazione, che è costituita dalle cartelle e dai file creati quando si esegue il comando. **sam init** Questa directory include il AWS SAM modello, un file importante che definisce le AWS risorse. Il AWS SAM modello è un'estensione di un AWS CloudFormation modello. Per il riferimento completo ai CloudFormation modelli, consulta la sezione [Riferimento ai modelli](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-reference.html) nella *Guida per l'AWS CloudFormation utente*.

## AWS SAMCLIriferimento ai comandi
<a name="serverless-sam-cli"></a>

La AWS Serverless Application Model Command Line Interface (AWS SAMCLI) è uno strumento da riga di comando che puoi utilizzare con AWS SAM modelli e integrazioni di terze parti supportate per creare ed eseguire applicazioni serverless.

È possibile utilizzare i AWS SAMCLI comandi per sviluppare, testare e distribuire applicazioni serverless su. Cloud AWS Di seguito sono riportati alcuni esempi di AWS SAMCLI comandi:
+ `sam init`— Se sei un AWS SAMCLI utente alle prime armi, puoi eseguire il `sam init` comando senza parametri per creare un'applicazione Hello World. Il comando genera un AWS SAM modello preconfigurato e un codice applicativo di esempio nella lingua scelta.
+ `sam local invoke`e `sam local start-api` — Utilizzate questi comandi per testare il codice dell'applicazione localmente, prima di distribuirlo su. Cloud AWS
+ `sam logs`— Utilizzate questo comando per recuperare i log generati dalla funzione Lambda. Questo può aiutarti a testare ed eseguire il debug dell'applicazione dopo averla distribuita su. Cloud AWS
+ `sam package`*— Utilizzate questo comando per raggruppare il codice dell'applicazione e le dipendenze in un pacchetto di distribuzione.* È necessario il pacchetto di distribuzione per caricare l'applicazione su. Cloud AWS
+ `sam deploy`— Utilizzate questo comando per distribuire l'applicazione serverless su. Cloud AWS Crea le AWS risorse e imposta le autorizzazioni e altre configurazioni definite nel modello. AWS SAM 

Per istruzioni sull'installazione di AWS SAMCLI, vedere. [Installa il AWS SAMCLI](install-sam-cli.md)

## AWS SAM modelli di policy
<a name="serverless-policy-temps"></a>

Con AWS SAM, puoi scegliere da un elenco di modelli di policy per definire le autorizzazioni della tua AWS Lambda funzione per le risorse utilizzate dall'applicazione. Per un elenco dei modelli di policy disponibili, fare riferimento a[Tabella dei modelli di policy](serverless-policy-templates.md#serverless-policy-template-table). Per informazioni generali sui modelli di policy e AWS SAM, fare riferimento a[AWS SAM modelli di policy](serverless-policy-templates.md).

## Argomenti
<a name="reference-sam-topics"></a>
+ [AWS SAM modello](sam-specification.md)
+ [AWS SAMCLIriferimento al comando](serverless-sam-cli-command-reference.md)
+ [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md)
+  [AWS SAM riferimento del connettore](reference-sam-connector.md) 
+ [AWS SAM modelli di policy](serverless-policy-templates.md)
+ [Archivi di immagini per AWS SAM](serverless-image-repositories.md)
+ [Telemetria nel AWS SAMCLI](serverless-sam-telemetry.md)
+ [Configura e gestisci l'accesso alle risorse nel tuo AWS SAM modello](sam-permissions.md)

# AWS SAMCLIriferimento al comando
<a name="serverless-sam-cli-command-reference"></a>

Questa sezione include informazioni di riferimento sui AWS SAMCLI comandi. Ciò include dettagli sull'utilizzo, un elenco completo delle diverse opzioni disponibili per ogni comando e informazioni aggiuntive. Se applicabile, le informazioni aggiuntive includono dettagli come argomenti, variabili di ambiente ed eventi. Vedi ogni comando per i dettagli. Per istruzioni sull'installazione di AWS SAMCLI, vedere[Installa il AWS SAMCLI](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>

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam build`.
+ Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Per la documentazione sull'uso del AWS SAMCLI `sam build` comando, vedere[Introduzione alla costruzione con AWS SAM](using-sam-cli-build.md).

Il `sam build` comando prepara un'applicazione per i passaggi successivi del flusso di lavoro degli sviluppatori, ad esempio il test locale o la distribuzione su. Cloud AWS

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

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

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

**Resource ID (ID risorsa)**  <a name="ref-sam-cli-build-args-resource-id"></a>
Opzionale. Indica AWS SAM a creare una singola risorsa dichiarata in un [AWS SAM modello](what-is-sam-overview.md#what-is-sam-template). Gli artefatti di compilazione per la risorsa specificata saranno gli unici disponibili per i comandi successivi nel flusso di lavoro, ad esempio e. `sam package` `sam deploy`

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

`--base-dir, -s DIRECTORY`  <a name="ref-sam-cli-build-options-base-dir"></a>
Risolve i percorsi relativi al codice sorgente della funzione o del livello rispetto a questa directory. Utilizzate questa opzione se desiderate modificare il modo in cui vengono risolti i percorsi relativi alle cartelle del codice sorgente. Per impostazione predefinita, i percorsi relativi vengono risolti rispetto alla posizione del AWS SAM modello.  
Oltre alle risorse nell'applicazione root o nello stack che state creando, questa opzione si applica anche alle applicazioni o agli stack annidati.  
Questa opzione si applica ai seguenti tipi e proprietà di risorse:  
+ Tipo di risorsa: `AWS::Serverless::Function` Proprietà: `CodeUri`
+ Tipo di risorsa: Attributo della `AWS::Serverless::Function` risorsa: `Metadata` Voce: `DockerContext`
+ Tipo di risorsa: `AWS::Serverless::LayerVersion` Proprietà: `ContentUri`
+ Tipo di risorsa: `AWS::Lambda::Function` Proprietà: `Code`
+ Tipo di risorsa: `AWS::Lambda::LayerVersion` Proprietà: `Content`

`--beta-features | --no-beta-features`  <a name="ref-sam-cli-build-options-beta-features"></a>
Consenti o nega le funzionalità beta.

`--build-dir, -b DIRECTORY`  <a name="ref-sam-cli-build-options-build-dir"></a>
Il percorso di una directory in cui sono archiviati gli artefatti creati. Questa directory e tutto il suo contenuto vengono rimossi con questa opzione.

`--build-image TEXT`  <a name="ref-sam-cli-build-options-build-image"></a>
L'URI dell'immagine del contenitore che desideri estrarre per la build. Per impostazione predefinita, AWS SAM estrae l'immagine del contenitore da Amazon ECR Public. Usa questa opzione per estrarre l'immagine da un'altra posizione.  
Puoi specificare questa opzione più volte. Ogni istanza di questa opzione può accettare una stringa o una coppia chiave-valore. Se si specifica una stringa, si tratta dell'URI dell'immagine del contenitore da utilizzare per tutte le risorse dell'applicazione. Ad esempio, `sam build --use-container --build-image amazon/aws-sam-cli-build-image-python3.8`. Se si specifica una coppia chiave-valore, la chiave è il nome della risorsa e il valore è l'URI dell'immagine del contenitore da utilizzare per quella risorsa. Ad esempio, `sam build --use-container --build-image Function1=amazon/aws-sam-cli-build-image-python3.8`. Con le coppie chiave-valore, è possibile specificare immagini di contenitori diverse per risorse diverse.  
Questa opzione si applica solo se l'`--use-container`opzione è specificata, altrimenti si verificherà un errore.

`--build-in-source | --no-build-in-source`  <a name="ref-sam-cli-build-options-build-in-source"></a>
`--build-in-source`Provvedi a creare il tuo progetto direttamente nella cartella dei sorgenti.  
L'`--build-in-source`opzione supporta i seguenti runtime e metodi di compilazione:  
+ **Runtime**: qualsiasi Node.js runtime supportato dall'`sam init --runtime`opzione.
+ **Metodi di compilazione**:`Makefile`,`esbuild`.
L'`--build-in-source`opzione non è compatibile con le seguenti opzioni:  
+ `--hook-name`
+ `--use-container `
*Default*: `--no-build-in-source`

`--cached | --no-cached`  <a name="ref-sam-cli-build-options-cached"></a>
Abilita o disabilita le build memorizzate nella cache. Usa questa opzione per riutilizzare gli artefatti della build che non sono stati modificati rispetto alle build precedenti. AWS SAM valuta se sono stati modificati i file nella directory del progetto. Per impostazione predefinita, le build non vengono memorizzate nella cache. Se l'`--no-cached`opzione viene richiamata, sostituisce l'impostazione in samconfig.toml. `cached = true`  
AWS SAM non valuta se hai modificato i moduli di terze parti da cui dipende il tuo progetto, laddove non hai fornito una versione specifica. Ad esempio, se la tua funzione Python include un `requirements.txt` file con la voce `requests=1.x` e l'ultima versione del modulo di richiesta cambia da `1.1` a`1.2`, non estrae la versione più recente finché AWS SAM non esegui una build non memorizzata nella cache.

`--cache-dir`  <a name="ref-sam-cli-build-options-cached-dir"></a>
La directory in cui vengono memorizzati gli elementi della cache quando viene specificata. `--cached` La directory cache predefinita è. `.aws-sam/cache`

`--config-env TEXT`  <a name="ref-sam-cli-build-options-config-env"></a>
Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare. Il valore predefinito è «default». Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-build-options-config-file"></a>
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare. Il valore predefinito è "`samconfig.toml`" nella radice della directory del progetto. Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--container-env-var, -e TEXT`  <a name="ref-sam-cli-build-options-container-env-var"></a>
Variabili di ambiente da passare al contenitore di compilazione. Puoi specificare questa opzione più volte. Ogni istanza di questa opzione accetta una coppia chiave-valore, dove la chiave è la variabile risorsa e ambiente e il valore è il valore della variabile di ambiente. Ad esempio: `--container-env-var Function1.GITHUB_TOKEN=TOKEN1 --container-env-var Function2.GITHUB_TOKEN=TOKEN2`.  
Questa opzione si applica solo se l'`--use-container`opzione è specificata, altrimenti si verificherà un errore.

`--container-env-var-file, -ef PATH`  <a name="ref-sam-cli-build-options-container-env-var-file"></a>
Il percorso e il nome di un file JSON che contiene valori per le variabili di ambiente del contenitore. Per ulteriori informazioni sui file delle variabili di ambiente del contenitore, vedere[File variabile di ambiente del contenitore](serverless-sam-cli-using-build.md#serverless-sam-cli-using-container-environment-file).  
Questa opzione si applica solo se l'`--use-container`opzione è specificata, altrimenti si verificherà un errore.

`--debug`  <a name="ref-sam-cli-build-options-debug"></a>
Attiva la registrazione di debug per stampare i messaggi di debug che AWS SAMCLI genera e per visualizzare i timestamp.

`--docker-network TEXT`  <a name="ref-sam-cli-build-options-docker-network"></a>
Speciifica il nome o l'ID di una Docker rete esistente a cui i contenitori Docker Lambda devono connettersi, insieme alla rete bridge predefinita. Se non specificato, i contenitori Lambda si connettono solo alla rete bridge Docker predefinita.

`--exclude, -x`  <a name="ref-sam-cli-build-options-exclude"></a>
Il nome delle risorse da escludere da. `sam build` Ad esempio, se il modello contiene `Function1``Function2`, e `Function3` e lo esegui`sam build --exclude Function2`, solo `Function1` e `Function3` verrà creato.

`--help`  <a name="ref-sam-cli-build-options-help"></a>
Mostra questo messaggio ed esce.

`--hook-name TEXT`  <a name="ref-sam-cli-build-options-hook-name"></a>
Il nome dell'hook utilizzato per estendere le AWS SAMCLI funzionalità.  
Valori accettati:`terraform`.

`--manifest , -m PATH`  <a name="ref-sam-cli-build-options-manifest"></a>
Il percorso di un file manifesto delle dipendenze personalizzato (ad esempio, package.json) da utilizzare al posto di quello predefinito.

`--mount-symlinks`  <a name="ref-sam-cli-build-options-mount-symlinks"></a>
Assicura che monti AWS SAMCLI sempre i collegamenti simbolici presenti nei file da creare o richiamare. Questo vale solo per i collegamenti simbolici nella directory di primo livello (ovvero i collegamenti simbolici che si trovano direttamente nella radice della funzione). Per impostazione predefinita, i collegamenti simbolici non vengono montati ad eccezione di quelli necessari per essere utilizzati `build-in-source` `node_modules` in NodeJS.

`--no-use-container`  <a name="ref-sam-cli-build-options-no-use-container"></a>
Un'opzione che consente di utilizzare il toolkit IDE per impostare il comportamento predefinito. Puoi anche usarlo `sam build --no-use-container` per eseguire una build nella tua macchina locale anziché in un contenitore docker.

`--parallel`  <a name="ref-sam-cli-build-options-parallel"></a>
Abilita le build parallele. Usa questa opzione per creare le funzioni e i livelli del tuo AWS SAM modello in parallelo. Per impostazione predefinita, le funzioni e i livelli vengono creati in sequenza.

`--parameter-overrides`  <a name="ref-sam-cli-build-options-parameter-overrides"></a>
(Facoltativo) Una stringa che contiene le sostituzioni CloudFormation dei parametri codificate come coppie chiave-valore. Utilizza lo stesso formato di (). AWS Command Line Interface AWS CLI Ad esempio: '`ParameterKey`=`KeyPairName`, `ParameterValue` `MyKey` `ParameterKey` =`InstanceType`, `ParameterValue` =`t1.micro`'. Questa opzione non è compatibile con`--hook-name`.

`--profile TEXT`  <a name="ref-sam-cli-build-options-profile"></a>
Il profilo specifico del file delle credenziali che ottiene le AWS credenziali.

`--region TEXT`  <a name="ref-sam-cli-build-options-region"></a>
Il Regione AWS verso cui eseguire la distribuzione. Ad esempio, us-east-1.

`--save-params`  <a name="ref-sam-cli-build-options-save-params"></a>
Salva i parametri forniti dalla riga di comando nel file di AWS SAM configurazione.

`--skip-prepare-infra`  <a name="ref-sam-cli-build-options-skip-prepare-infra"></a>
Salta la fase di preparazione se non sono state apportate modifiche all'infrastruttura. Da utilizzare con l'`--hook-name`opzione.

`--skip-pull-image`  <a name="ref-sam-cli-build-options-skip-pull-image"></a>
Specifica se il comando deve ignorare l'estrazione dell'ultima immagine Docker per il runtime Lambda.

`--template-file, --template, -t PATH`  <a name="ref-sam-cli-build-options-template-file"></a>
Il percorso e il nome del file modello. AWS SAM `[default: template.[yaml|yml]]` Questa opzione non è compatibile con`--hook-name`.

`--terraform-project-root-path`  <a name="ref-sam-cli-build-options-terraform-project-root-path"></a>
Il percorso relativo o assoluto della directory di primo livello contenente i file di Terraform configurazione o il codice sorgente della funzione. Se questi file si trovano all'esterno della directory contenente il modulo Terraform root, utilizzate questa opzione per specificarne il percorso assoluto o relativo. Questa opzione richiede che `--hook-name` sia impostata su`terraform`.

`--use-container`, `-u`  <a name="ref-sam-cli-build-options-use-container"></a>
Se le tue funzioni dipendono da pacchetti che hanno dipendenze compilate in modo nativo, usa questa opzione per creare la tua funzione all'interno di un contenitore Docker simile a Lambda.

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

Per un esempio dettagliato e una procedura dettagliata sull'utilizzo del `sam build` sottocomando, fare riferimento a. [Introduzione alla costruzione con AWS SAM](using-sam-cli-build.md)

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

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam delete`.

Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Il `sam delete` comando elimina un' AWS SAM applicazione eliminando lo CloudFormation stack, gli artefatti che sono stati impacchettati e distribuiti su Amazon S3 e Amazon ECR e il file modello. AWS SAM 

Questo comando verifica anche se è stato distribuito uno stack complementare Amazon ECR e, in tal caso, richiede all'utente di eliminare quello stack e i repository Amazon ECR. Se `--no-prompts` specificato, gli stack complementari e i repository Amazon ECR vengono eliminati per impostazione predefinita.

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

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

## Opzioni
<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>
Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare. Il valore predefinito è `default`. Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-delete-options-config-file"></a>
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare. Il valore predefinito si trova `samconfig.toml` nella radice della directory del progetto. Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-delete-options-debug"></a>
Attiva la registrazione di debug per stampare il messaggio di debug AWS SAMCLI generato e per visualizzare i timestamp.

`--help`  <a name="sam-cli-command-reference-sam-delete-options-help"></a>
Mostra questo messaggio ed esce.

`--no-prompts`  <a name="sam-cli-command-reference-sam-delete-options-no-prompts"></a>
Specificate questa opzione per farla AWS SAM funzionare in modalità non interattiva. Il nome dello stack deve essere fornito, con l'`--stack-name`opzione o nel file di configurazione`toml`.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-delete-options-profile"></a>
Il profilo specifico del file di credenziali che ottiene AWS le credenziali.

`--region TEXT`  <a name="sam-cli-command-reference-sam-delete-options-region"></a>
La AWS regione in cui effettuare la distribuzione. Ad esempio, us-east-1.

`--s3-bucket`  <a name="sam-cli-command-reference-sam-delete-options-s3-bucket"></a>
Il percorso del bucket Amazon S3 che desideri eliminare.

`--s3-prefix`  <a name="sam-cli-command-reference-sam-delete-options-s3-prefix"></a>
Il prefisso del bucket Amazon S3 che desideri eliminare.

`--save-params`  <a name="sam-cli-command-reference-sam-delete-options-save-params"></a>
Salva i parametri che fornisci nella riga di comando nel file di configurazione. AWS SAM 

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-delete-options-stack-name"></a>
Il nome dello CloudFormation stack che desideri eliminare.

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

Il comando seguente elimina lo stack. `MY-STACK` 

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

Il comando seguente elimina lo stack `MY-STACK` e il bucket S3: `sam-s3-demo-bucket`

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

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

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam deploy`.
+ Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Per la documentazione sull'uso del AWS SAMCLI `sam deploy` comando, vedere[Introduzione alla distribuzione con AWS SAM](using-sam-cli-deploy.md).

Il `sam deploy` comando distribuisce un'applicazione all'utente Cloud AWS . AWS CloudFormation

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

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

## Variabili di ambiente
<a name="ref-sam-cli-deploy-env"></a>

`SAM_CLI_POLL_DELAY`  <a name="ref-sam-cli-deploy-env-sam-cli-poll-delay"></a>
Imposta la variabile di `SAM_CLI_POLL_DELAY` ambiente con un valore di secondi nella shell per configurare la frequenza con cui la CLI AWS SAM controlla lo stato dello CloudFormation stack, il che è utile quando si verifica la limitazione da. CloudFormation Questa variabile env viene utilizzata per il polling delle chiamate `describe_stack` API, che vengono effettuate durante l'esecuzione. `sam deploy`   
Di seguito è riportato un esempio di questa variabile:  

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

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

`--capabilities LIST`  <a name="ref-sam-cli-deploy-options-capabilities"></a>
Un elenco di funzionalità che è necessario specificare per consentire la creazione CloudFormation di determinati stack. Alcuni modelli di stack potrebbero includere risorse che influiscono sulle autorizzazioni dell'utente Account AWS, ad esempio creando nuovi utenti AWS Identity and Access Management (IAM). Per questi stack, è necessario riconoscerne esplicitamente le funzionalità specificando questa opzione. Gli unici valori validi sono `CAPABILITY_IAM` e `CAPABILITY_NAMED_IAM`. Se disponi di risorse IAM, puoi specificare entrambe le funzionalità. Se disponi di risorse IAM con nomi personalizzati, devi specificare`CAPABILITY_NAMED_IAM`. Se non specifichi questa opzione, l'operazione restituisce un `InsufficientCapabilities` errore.  
Quando si distribuisce un'applicazione che contiene applicazioni nidificate, è necessario utilizzare `CAPABILITY_AUTO_EXPAND` per confermare che l'applicazione contiene applicazioni nidificate. Per ulteriori informazioni, consulta [Distribuzione di applicazioni annidate](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>
Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare. Il valore predefinito è `default`. Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-deploy-options-config-file"></a>
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare. Il valore predefinito si trova `samconfig.toml` nella radice della directory del progetto. Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--confirm-changeset | --no-confirm-changeset`  <a name="ref-sam-cli-deploy-options-confirm-changeset"></a>
Richiede di confermare se AWS SAMCLI distribuisce il changeset calcolato.

`--debug`  <a name="ref-sam-cli-deploy-options-debug"></a>
Attiva la registrazione di debug per stampare il messaggio di debug generato e per visualizzare i timestamp. AWS SAMCLI

`--disable-rollback | --no-disable-rollback`  <a name="ref-sam-cli-deploy-options-disable-rollback"></a>
Specificate se ripristinare lo CloudFormation stack se si verifica un errore durante una distribuzione. Per impostazione predefinita, se si verifica un errore durante una distribuzione, lo CloudFormation stack torna all'ultimo stato stabile. Se si specifica `--disable-rollback` e si verifica un errore durante una distribuzione, non viene eseguito il rollback delle risorse create o aggiornate prima che si verificasse l'errore.

`--fail-on-empty-changeset | --no-fail-on-empty-changeset`  <a name="ref-sam-cli-deploy-options-fail-on-empty-changeset"></a>
Specificate se restituire un codice di uscita diverso da zero se non ci sono modifiche da apportare allo stack. Il comportamento predefinito consiste nel restituire un codice di uscita diverso da zero.

`--force-upload`  <a name="ref-sam-cli-deploy-options-force-upload"></a>
Specificate questa opzione per caricare gli artefatti anche se corrispondono agli artefatti esistenti nel bucket Amazon S3. Gli artefatti corrispondenti vengono sovrascritti.

`--guided, -g`  <a name="ref-sam-cli-deploy-options-guided"></a>
Specificate questa opzione per far sì che i prompt di AWS SAMCLI utilizzo vi guidino nella distribuzione.

`--help`  <a name="ref-sam-cli-deploy-options-help"></a>
Mostra questo messaggio ed esci.

`--image-repositories TEXT`  <a name="ref-sam-cli-deploy-options-image-repositories"></a>
Una mappatura delle funzioni sull'URI del loro repository Amazon ECR. Funzioni di riferimento in base al relativo ID logico. Di seguito è riportato un esempio:  

```
$ sam deploy --image-repositories Function1=123456789012.dkr.ecr.us-east-1.amazonaws.com/my-repo
```
È possibile specificare questa opzione più volte in un unico comando.

`--image-repository TEXT`  <a name="ref-sam-cli-deploy-options-image-repository"></a>
Il nome dell'archivio Amazon ECR in cui questo comando carica l'immagine della tua funzione. Questa opzione è necessaria per le funzioni dichiarate con il `Image` tipo di pacchetto.

`--kms-key-id TEXT`  <a name="ref-sam-cli-deploy-options-kms-key-id"></a>
L'ID di una chiave AWS Key Management Service (AWS KMS) utilizzata per crittografare gli artefatti che sono a riposo nel bucket Amazon S3. Se non specifichi questa opzione, AWS SAM utilizza le chiavi di crittografia gestite da Amazon S3.

`--metadata`  <a name="ref-sam-cli-deploy-options-metadata"></a>
Una mappa di metadati da allegare a tutti gli artefatti a cui si fa riferimento nel modello.

`--no-execute-changeset`  <a name="ref-sam-cli-deploy-options-no-execute-changeset"></a>
Indica se applicare il changeset. Specificate questa opzione se desiderate visualizzare le modifiche apportate allo stack prima di applicare il changeset. Questo comando crea un CloudFormation changeset e quindi esce senza applicare il changeset. Per applicare il changeset, esegui lo stesso comando senza questa opzione.

`--no-progressbar`  <a name="ref-sam-cli-deploy-options-no-progressbar"></a>
Non visualizzare una barra di avanzamento durante il caricamento di artefatti su Amazon S3.

`--notification-arns LIST`  <a name="ref-sam-cli-deploy-options-notification-arns"></a>
Un elenco di ARNs argomenti di Amazon Simple Notification Service (Amazon SNS) associati allo CloudFormation stack.

`--on-failure [ROLLBACK | DELETE | DO_NOTHING]`  <a name="ref-sam-cli-deploy-options-on-failure"></a>
Specificate l'azione da intraprendere quando la creazione di uno stack non riesce.  
Sono disponibili le seguenti opzioni:  
+ `ROLLBACK`— Riporta lo stack a uno stato precedente noto come buono.
+ `DELETE`— Riporta la pila a uno stato precedente noto come buono, se ne esiste uno. Altrimenti, elimina lo stack.
+ `DO_NOTHING`— Non ripristina né elimina lo stack. L'effetto è lo stesso di. `--disable-rollback`
Il comportamento predefinito è `ROLLBACK`.  
È possibile specificare l'`--disable-rollback`opzione o l'`--on-failure`opzione, ma non entrambe.

`--parameter-overrides LIST`  <a name="ref-sam-cli-deploy-options-parameter-overrides"></a>
Una stringa che contiene le sostituzioni CloudFormation dei parametri codificate come coppie chiave-valore. Ogni override utilizza il formato. `ParameterKey=name,ParameterValue=value` Le sostituzioni multiple sono separate da spazi. Di seguito, sono riportati due esempi:  

```
$ 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>
Il profilo specifico del file delle credenziali che ottiene le credenziali. AWS 

`--region TEXT`  <a name="ref-sam-cli-deploy-options-region"></a>
Il Regione AWS verso cui eseguire la distribuzione. Ad esempio, us-east-1.

`--resolve-image-repos`  <a name="ref-sam-cli-deploy-options-resolve-image-repos"></a>
Crea automaticamente repository Amazon ECR da utilizzare per il packaging e la distribuzione per distribuzioni non guidate. Questa opzione si applica solo alle funzioni e ai livelli specificati. `PackageType: Image` Se si specifica l'`--guided`opzione, la AWS SAMCLI ignora. `--resolve-image-repos`  
Se crea AWS SAM automaticamente un archivio Amazon ECR per funzioni o livelli con questa opzione e successivamente elimini tali funzioni o livelli dal AWS SAM modello, i repository Amazon ECR corrispondenti vengono eliminati automaticamente.

`--resolve-s3`  <a name="ref-sam-cli-deploy-options-resolve-s3"></a>
Crea automaticamente un bucket Amazon S3 da utilizzare per il packaging e la distribuzione per distribuzioni non guidate. Se si specifica l'`--guided`opzione, la AWS SAM CLI la ignora. `--resolve-s3` Se si specificano entrambe le `--resolve-s3` opzioni `--s3-bucket` e, si verifica un errore.

`--role-arn TEXT`  <a name="ref-sam-cli-deploy-options-role-arn"></a>
L'Amazon Resource Name (ARN) di un ruolo IAM che CloudFormation assume quando si applica il changeset.

`--s3-bucket TEXT`  <a name="ref-sam-cli-deploy-options-s3-bucket"></a>
Il nome del bucket Amazon S3 in cui questo comando carica il modello. CloudFormation Se il modello è più grande di 51.200 byte, è necessaria l'opzione o l'`--s3-bucket`opzione. `--resolve-s3` Se si specificano entrambe le `--resolve-s3` opzioni `--s3-bucket` e, si verifica un errore.

`--s3-prefix TEXT`  <a name="ref-sam-cli-deploy-options-s3-prefix"></a>
Il prefisso aggiunto ai nomi degli artefatti caricati nel bucket Amazon S3. Il nome del prefisso è un nome di percorso (nome della cartella) per il bucket Amazon S3.

`--save-params`  <a name="ref-sam-cli-deploy-options-save-params"></a>
Salva i parametri che fornisci nella riga di comando nel file di configurazione. AWS SAM 

`--signing-profiles LIST`  <a name="ref-sam-cli-deploy-options-signing-profiles"></a>
L'elenco dei profili di firma con cui firmare i pacchetti di distribuzione. Questa opzione richiede un elenco di coppie chiave-valore, in cui la chiave è il nome della funzione o del livello da firmare e il valore è il profilo di firma, con un proprietario del profilo opzionale delimitato da. `:` Ad esempio, `FunctionNameToSign=SigningProfileName1 LayerNameToSign=SigningProfileName2:SigningProfileOwner`.

`--stack-name TEXT`  <a name="ref-sam-cli-deploy-options-stack-name"></a>
(Obbligatorio) Il nome dello CloudFormation stack in cui stai eseguendo la distribuzione. Se specificate uno stack esistente, il comando aggiorna lo stack. Se specificate un nuovo stack, il comando lo crea.

`--tags LIST`  <a name="ref-sam-cli-deploy-options-tags"></a>
Un elenco di tag da associare allo stack creato o aggiornato. CloudFormation propaga inoltre questi tag alle risorse dello stack che li supportano.

`--template-file, --template, -t PATH`  <a name="ref-sam-cli-deploy-options-template-file"></a>
Il percorso e il nome del file in cui si trova il AWS SAM modello.  
Se si specifica questa opzione, AWS SAM distribuisce solo il modello e le risorse locali a cui punta.

`--use-json`  <a name="ref-sam-cli-deploy-options-use-json"></a>
Esporta JSON per il modello. CloudFormation L'output predefinito è YAML.

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

Per un esempio dettagliato e una procedura dettagliata sull'utilizzo del `sam deploy` sottocomando, fare riferimento a. [Introduzione alla distribuzione con AWS SAM](using-sam-cli-deploy.md)

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

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI). `sam init`
+ Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Per la documentazione sull'uso del AWS SAMCLI `sam init` comando, vedere[Crea la tua candidatura in AWS SAM](using-sam-cli-init.md).

Il `sam init` comando fornisce opzioni per inizializzare una nuova applicazione serverless.

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

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

## Opzioni
<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'identificatore del modello di applicazione gestita che si desidera utilizzare. Se non sei sicuro, chiama `sam init` senza opzioni per un flusso di lavoro interattivo.  
Questo parametro è obbligatorio se `--no-interactive` è specificato e non `--location` viene fornito.  
Questo parametro è disponibile solo nella AWS SAMCLI versione 0.30.0 e successive. La specificazione di questo parametro con una versione precedente genera un errore.

`--application-insights | --no-application-insights`  <a name="sam-cli-command-reference-sam-init-options-application-insights"></a>
 Attiva il monitoraggio di Amazon CloudWatch Application Insights per la tua applicazione. Per ulteriori informazioni, consulta [Utilizzo di CloudWatch Application Insights per monitorare le applicazioni AWS SAM serverless](monitor-app-insights.md).   
 L'opzione predefinita è `--no-application-insights`. 

`--architecture, -a [ x86_64 | arm64 ]`  <a name="sam-cli-command-reference-sam-init-options-architecture"></a>
L'architettura del set di istruzioni per le funzioni Lambda dell'applicazione. Specificate uno dei `x86_64` o`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'immagine di base dell'applicazione. Questa opzione si applica solo quando il tipo di pacchetto è`Image`.  
Questo parametro è obbligatorio se `--no-interactive` è specificato, `--package-type` è specificato come `Image` e non `--location` è specificato.

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-init-options-config-env"></a>
Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare. Il valore predefinito è «default». Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-init-options-config-file"></a>
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare. Il valore predefinito è «samconfig.toml» nella radice della directory del progetto. Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-init-options-debug"></a>
Attiva la registrazione di debug per stampare i messaggi di debug generati e per visualizzare i AWS SAMCLI timestamp.

`--dependency-manager, -d [ gradle | mod | maven | bundler | npm | cli-package | pip ]`  <a name="sam-cli-command-reference-sam-init-options-dependency-manager"></a>
Il gestore delle dipendenze del tuo runtime Lambda.

`--extra-content`  <a name="sam-cli-command-reference-sam-init-options-extra-content"></a>
Sovrascrivi qualsiasi parametro personalizzato nella `cookiecutter.json` configurazione del modello, ad esempio. `{"customParam1": "customValue1", "customParam2":"customValue2"}`

`--help, -h`  <a name="sam-cli-command-reference-sam-init-options-help"></a>
Mostra questo messaggio ed esce.

`--location, -l TEXT`  <a name="sam-cli-command-reference-sam-init-options-location"></a>
La posizione del modello o dell'applicazione (Git, Mercurial, HTTP/HTTPS, file.zip, percorso).  
Questo parametro è obbligatorio se `--no-interactive` è specificato e `--runtime``--name`, e `--app-template` non vengono forniti.  
Per i repository Git, è necessario utilizzare la posizione della radice del repository.  
[Per i percorsi locali, il modello deve essere in formato.zip o Cookiecutter.](https://cookiecutter.readthedocs.io/en/latest/README.html)

`--name, -n TEXT`  <a name="sam-cli-command-reference-sam-init-options-name"></a>
Il nome del progetto da generare come directory.  
Questo parametro è obbligatorio se `--no-interactive` è specificato e non `--location` viene fornito.

`--no-input`  <a name="sam-cli-command-reference-sam-init-options-no-input"></a>
Disattiva la richiesta di Cookiecutter e accetta i valori vcfdefault definiti nella configurazione del modello.

`--no-interactive`  <a name="sam-cli-command-reference-sam-init-options-no-interactive"></a>
Disabilita la richiesta interattiva per i parametri init e fallisce se mancano i valori richiesti.

`--output-dir, -o PATH`  <a name="sam-cli-command-reference-sam-init-options-output-dir"></a>
La posizione in cui viene emessa l'applicazione inizializzata.

`--package-type [ Zip | Image ]`  <a name="sam-cli-command-reference-sam-init-options-package-type"></a>
Il tipo di pacchetto dell'applicazione di esempio. `Zip`crea un archivio di file.zip e `Image` crea un'immagine del contenitore.

`--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>
Il runtime Lambda della tua applicazione. Questa opzione si applica solo quando il tipo di pacchetto è`Zip`.  
Questo parametro è obbligatorio se `--no-interactive` è specificato, `--package-type` è specificato come `Zip` e non `--location` è specificato.

`--save-params`  <a name="sam-cli-command-reference-sam-init-options-save-params"></a>
Salva i parametri forniti nella riga di comando nel file AWS SAM di configurazione.

`--tracing | --no-tracing`  <a name="sam-cli-command-reference-sam-init-options-tracing"></a>
Attiva il AWS X-Ray tracciamento per le tue funzioni Lambda.

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

Per un esempio dettagliato e una procedura dettagliata sull'utilizzo del `sam init` sottocomando, fare riferimento a. [Crea la tua candidatura in AWS SAM](using-sam-cli-init.md)

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

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam list`.

Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Il `sam list` comando fornisce informazioni importanti sulle risorse dell'applicazione serverless e sullo stato dell'applicazione serverless. Utilizzalo **sam list** prima e dopo l'implementazione per fornire assistenza durante lo sviluppo locale e nel cloud.

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

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

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

`--help, -h`  <a name="sam-cli-command-reference-sam-list-options-help"></a>
Mostra questo messaggio ed esci.

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

`endpoints`  <a name="sam-cli-command-reference-sam-list-subcommands-endpoints"></a>
Visualizza un elenco di endpoint cloud e locali dal tuo CloudFormation stack. Per ulteriori informazioni, consulta [sam list endpoints](sam-cli-command-reference-sam-list-endpoints.md).

`resources`  <a name="sam-cli-command-reference-sam-list-subcommands-resources"></a>
Visualizza le risorse del modello AWS Serverless Application Model (AWS SAM) create AWS CloudFormation al momento della distribuzione. Per ulteriori informazioni, consulta [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>
Visualizza gli output dello CloudFormation stack da un modello AWS SAM or CloudFormation . Per ulteriori informazioni, consulta [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>

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model `sam list endpoints` sottocomando Command Line Interface (AWS SAMCLI).

Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Il `sam list endpoints` sottocomando visualizza un elenco di endpoint cloud e locali dallo stack. CloudFormation È possibile interagire con queste risorse tramite i **sam local** comandi and. **sam sync**

AWS Lambda e i tipi di risorse Amazon API Gateway sono supportati con questo comando.

**Nota**  
I domini personalizzati sono supportati se configurati per le tue risorse Amazon API Gateway. Questo comando genererà il dominio personalizzato anziché l'endpoint predefinito.

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

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

## Opzioni
<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>
Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare.  
*Valore predefinito*: `default`  
Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--config-file TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-config-file"></a>
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare.  
*Valore predefinito*: `samconfig.toml` nella directory di lavoro corrente.  
Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-list-endpoints-options-debug"></a>
Attiva la registrazione di debug per stampare i messaggi di debug generati dai timestamp with. AWS SAMCLI

`--help, -h`  <a name="sam-cli-command-reference-sam-list-endpoints-options-help"></a>
Mostra questo messaggio ed esci.

`--output [json|table]`  <a name="sam-cli-command-reference-sam-list-endpoints-options-output"></a>
Specificate il formato per l'output dei risultati.  
*Valore predefinito*: `table`

`--profile TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-profile"></a>
Seleziona un profilo specifico dal tuo file di credenziali per ottenere le AWS credenziali.

`--region TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-region"></a>
Imposta la AWS regione del servizio. Ad esempio, `us-east-1`.

`--save-params`  <a name="sam-cli-command-reference-sam-list-endpoints-options-save-params"></a>
Salva i parametri forniti dalla riga di comando nel file AWS SAM di configurazione.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-stack-name"></a>
Nome dello CloudFormation stack distribuito. Il nome dello stack si trova nel `samconfig.toml` file dell'applicazione o nel file di configurazione designato.  
Quando questa opzione non è specificata, verranno visualizzate le risorse locali definite nel modello.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-list-endpoints-options-template"></a>
AWS SAM file modello.  
*Valore predefinito*: `template.[yaml|yml|json]`

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

Visualizza un output, in formato json, degli endpoint di risorse distribuiti dallo stack denominato. CloudFormation `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>

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model `sam list resources` sottocomando Command Line Interface (AWS SAMCLI).

Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Il `sam list resources` sottocomando visualizza le risorse del modello AWS Serverless Application Model (AWS SAM) create AWS CloudFormation dalla AWS SAM trasformazione al momento della distribuzione.

**sam list resources**Utilizzalo con un AWS SAM modello prima della distribuzione per vedere le risorse che verranno create. Fornisci un nome di CloudFormation stack per visualizzare un elenco consolidato che include le risorse distribuite.

**Nota**  
Per generare un elenco di risorse dal AWS SAM modello, viene eseguita una trasformazione locale del modello. Le risorse che verranno distribuite con determinate condizioni, ad esempio all'interno di una regione specifica, sono incluse in questo elenco.

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

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

## Opzioni
<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>
Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare.  
*Valore predefinito*: `default`  
Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--config-file TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-config-file"></a>
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare.  
*Valore predefinito*: `samconfig.toml` nella directory di lavoro corrente.  
Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-list-resources-options-debug"></a>
Attiva la registrazione di debug per stampare i messaggi di debug generati dai timestamp with. AWS SAMCLI

`--help, -h`  <a name="sam-cli-command-reference-sam-list-resources-options-help"></a>
Mostra questo messaggio ed esci.

`--output [json|table]`  <a name="sam-cli-command-reference-sam-list-resources-options-output"></a>
Specificate il formato per l'output dei risultati.  
*Valore predefinito*: `table`

`--profile TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-profile"></a>
Seleziona un profilo specifico dal tuo file di credenziali per ottenere le AWS credenziali.

`--region TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-region"></a>
Imposta la AWS regione del servizio. Ad esempio, `us-east-1`.

`--save-params`  <a name="sam-cli-command-reference-sam-list-resources-options-save-params"></a>
Salva i parametri forniti dalla riga di comando nel file AWS SAM di configurazione.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-stack-name"></a>
Nome dello CloudFormation stack distribuito. Il nome dello stack si trova nel `samconfig.toml` file dell'applicazione o nel file di configurazione designato.  
Una volta fornite, le risorse logiche IDs del modello verranno mappate all'ingresso fisico IDs corrispondente. CloudFormation Per ulteriori informazioni sulle risorse fisiche IDs, consulta [i campi delle risorse](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html#resources-section-structure-resource-fields) nella *Guida per l'AWS CloudFormation utente*.  
Quando questa opzione non è specificata, verranno visualizzate le risorse locali definite nel modello.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-list-resources-options-"></a>
AWS SAM file modello.  
*Valore predefinito*: `template.[yaml|yml|json]`

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

Visualizza un output, in formato tabella, delle risorse locali del tuo AWS SAM modello e delle risorse distribuite dallo CloudFormation stack denominato. `test-stack` Esegui dalla stessa directory del modello locale.

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

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model `sam list stack-outputs` sottocomando Command Line Interface (AWS SAMCLI).

Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Il `sam list stack-outputs` sottocomando visualizza gli output dello AWS CloudFormation stack da un AWS Serverless Application Model (AWS SAM) o da un modello. CloudFormation *Per ulteriori informazioni`Outputs`, consultate [Outputs](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/outputs-section-structure.html) nella User Guide.AWS CloudFormation *

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

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

## Opzioni
<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>
Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare.  
*Valore predefinito*: `default`  
Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--config-file TEXT`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-config-file"></a>
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare.  
*Valore predefinito*: `samconfig.toml` nella directory di lavoro corrente.  
Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-debug"></a>
Attiva la registrazione di debug per stampare i messaggi di debug generati dai timestamp with. AWS SAMCLI

`--help, -h`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-help"></a>
Mostra questo messaggio ed esci.

`--output [json|table]`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-output"></a>
Specificate il formato per l'output dei risultati.  
*Valore predefinito*: `table`

`--profile TEXT`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-profile"></a>
Seleziona un profilo specifico dal tuo file di credenziali per ottenere le AWS credenziali.

`--region TEXT`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-region"></a>
Imposta la AWS regione del servizio. Ad esempio, `us-east-1`.

`--save-params`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-save-params"></a>
Salva i parametri forniti dalla riga di comando nel file AWS SAM di configurazione.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-"></a>
Nome dello CloudFormation stack distribuito. Il nome dello stack si trova nel `samconfig.toml` file dell'applicazione o nel file di configurazione designato.  
Questa opzione è obbligatoria.

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

Visualizza gli output, in formato tabellare, delle risorse presenti nello CloudFormation stack denominato. `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>

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam local callback`.

Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Il `sam local callback` comando consente di inviare callback a esecuzioni di funzioni durevoli locali durante lo sviluppo e il test.

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

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

## Opzioni
<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>
Mostra questo messaggio ed esci.

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

`succeed`  <a name="sam-cli-command-reference-sam-local-callback-subcommands-succeed"></a>
Invia una callback riuscita a un'esecuzione duratura della funzione. Per ulteriori informazioni, consulta [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>
Invia un callback di errore a un'esecuzione duratura della funzione. Per ulteriori informazioni, consulta [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>
Invia un callback del battito cardiaco a un'esecuzione duratura della funzione. Per ulteriori informazioni, consulta [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>

Invia una callback riuscita a un'esecuzione duratura della funzione.

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

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

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

`CALLBACK_ID`  
L'identificatore univoco del callback a cui inviare una risposta riuscita.

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

`-r, --result TEXT`  
Risultato di successo: payload come stringa.

`--region TEXT`  
Imposta la AWS regione del servizio (ad esempio,`us-east-1`).

`--profile TEXT`  
Seleziona un profilo specifico dal tuo file di credenziali per ottenere le AWS credenziali.

`--config-env TEXT`  
Nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione. Impostazione predefinita: `default`

`--config-file TEXT`  
File di configurazione contenente i valori dei parametri predefiniti. Impostazione predefinita: `samconfig.toml`

`--save-params`  
Salva i parametri forniti tramite la riga di comando nel file di configurazione.

`--beta-features / --no-beta-features`  
Abilita/disabilita le funzionalità beta.

`--debug`  
Attiva la registrazione di debug per stampare i messaggi di debug generati dalla CLI e visualizzare i timestamp AWS SAM .

`-h, --help`  
Mostra questo messaggio ed esce.

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

Invia una richiamata riuscita senza risultati:

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

Invia una richiamata riuscita con risultato:

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

Invia una richiamata riuscita con l'opzione breve:

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

Invia un callback di errore a un'esecuzione duratura della funzione.

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

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

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

`CALLBACK_ID`  
L'identificatore univoco del callback a cui inviare una risposta di errore.

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

`--error-data TEXT`  
Dati di errore aggiuntivi.

`--stack-trace TEXT`  
Immetti le voci di tracciamento dello stack. Questa opzione può essere specificata più volte.

`--error-type TEXT`  
Tipo di errore.

`--error-message TEXT`  
Messaggio di errore dettagliato.

`--region TEXT`  
Imposta la AWS regione del servizio (ad esempio,`us-east-1`).

`--profile TEXT`  
Seleziona un profilo specifico dal tuo file di credenziali per ottenere le AWS credenziali.

`--config-env TEXT`  
Nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione. Impostazione predefinita: `default`

`--config-file TEXT`  
File di configurazione contenente i valori dei parametri predefiniti. Impostazione predefinita: `samconfig.toml`

`--save-params`  
Salva i parametri forniti tramite la riga di comando nel file di configurazione.

`--beta-features / --no-beta-features`  
Abilita/disabilita le funzionalità beta.

`--debug`  
Attiva la registrazione di debug per stampare i messaggi di debug generati dalla CLI e visualizzare i timestamp AWS SAM .

`-h, --help`  
Mostra questo messaggio ed esce.

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

Invia un callback di errore senza parametri:

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

Invia una richiamata di errore con messaggio di errore:

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

Invia una richiamata di errore con tutti i parametri:

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

Invia una richiamata del battito cardiaco a un'esecuzione duratura della funzione.

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

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

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

`CALLBACK_ID`  
L'identificatore univoco del callback a cui inviare un heartbeat.

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

`--region TEXT`  
Imposta la AWS regione del servizio (ad esempio,`us-east-1`).

`--profile TEXT`  
Seleziona un profilo specifico dal tuo file di credenziali per ottenere le AWS credenziali.

`--config-env TEXT`  
Nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione. Impostazione predefinita: `default`

`--config-file TEXT`  
File di configurazione contenente i valori dei parametri predefiniti. Impostazione predefinita: `samconfig.toml`

`--save-params`  
Salva i parametri forniti tramite la riga di comando nel file di configurazione.

`--beta-features / --no-beta-features`  
Abilita/disabilita le funzionalità beta.

`--debug`  
Attiva la registrazione di debug per stampare i messaggi di debug generati dalla CLI e visualizzare i timestamp AWS SAM .

`-h, --help`  
Mostra questo messaggio ed esce.

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

Invia una richiamata del battito cardiaco:

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

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

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam local execution`.

Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Il `sam local execution` comando consente di gestire e controllare le esecuzioni locali di funzioni durevoli durante lo sviluppo e il test.

**Nota**  
Questi comandi potrebbero non richiedere l'accesso alle credenziali. AWS 

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

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

## Opzioni
<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>
Mostra questo messaggio ed esci.

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

`get`  <a name="sam-cli-command-reference-sam-local-execution-subcommands-get"></a>
Ottieni i dettagli di un'esecuzione duratura della funzione. Per ulteriori informazioni, consulta [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>
Ottieni la cronologia di esecuzione di un'esecuzione duratura di una funzione. Per ulteriori informazioni, consulta [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>
Interrompe l'esecuzione duratura di una funzione. Per ulteriori informazioni, consulta [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>

Recupera i dettagli dell'esecuzione durevole di una funzione specifica.

**Nota**  
Questo comando potrebbe non richiedere l'accesso alle AWS credenziali.

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

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

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

`DURABLE_EXECUTION_ARN`  
L'Amazon Resource Name (ARN) dell'esecuzione durevole della funzione di cui recuperare i dettagli.

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

`--format [summary|json]`  
Formato di output. Impostazione predefinita: `summary`

`--region TEXT`  
Imposta la AWS regione del servizio (ad esempio,`us-east-1`).

`--profile TEXT`  
Seleziona un profilo specifico dal tuo file di credenziali per ottenere le AWS credenziali.

`--config-env TEXT`  
Nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione. Impostazione predefinita: `default`

`--config-file TEXT`  
File di configurazione contenente i valori dei parametri predefiniti. Impostazione predefinita: `samconfig.toml`

`--save-params`  
Salva i parametri forniti tramite la riga di comando nel file di configurazione.

`--beta-features / --no-beta-features`  
Abilita/disabilita le funzionalità beta.

`--debug`  
Attiva la registrazione di debug per stampare i messaggi di debug generati dalla CLI e visualizzare i timestamp AWS SAM .

`-h, --help`  
Mostra questo messaggio ed esce.

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

Ottieni i dettagli dell'esecuzione con il formato di riepilogo predefinito:

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

Ottieni i dettagli di esecuzione in formato 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>

Ottieni la cronologia di esecuzione di un'esecuzione duratura di una funzione.

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

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

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

`EXECUTION_ID`  
L'identificatore univoco dell'esecuzione durevole della funzione di cui recuperare la cronologia.

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

`--format [table|json]`  
Formato di output. Impostazione predefinita: `table`

`--region TEXT`  
Imposta la AWS regione del servizio (ad esempio,`us-east-1`).

`--profile TEXT`  
Seleziona un profilo specifico dal tuo file di credenziali per ottenere le AWS credenziali.

`--config-env TEXT`  
Nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione. Impostazione predefinita: `default`

`--config-file TEXT`  
File di configurazione contenente i valori dei parametri predefiniti. Impostazione predefinita: `samconfig.toml`

`--save-params`  
Salva i parametri forniti tramite la riga di comando nel file di configurazione.

`--beta-features / --no-beta-features`  
Abilita/disabilita le funzionalità beta.

`--debug`  
Attiva la registrazione di debug per stampare i messaggi di debug generati dalla CLI e visualizzare i timestamp AWS SAM .

`-h, --help`  
Mostra questo messaggio ed esce.

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

Ottieni la cronologia di esecuzione in formato tabella:

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

Ottieni la cronologia di esecuzione in formato 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>

Interrompe l'esecuzione durevole di una funzione in esecuzione.

**Nota**  
Questo comando potrebbe non richiedere l'accesso alle AWS credenziali.

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

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

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

`DURABLE_EXECUTION_ARN`  
L'Amazon Resource Name (ARN) dell'esecuzione durevole della funzione da interrompere.

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

`--error-message TEXT`  
Messaggio di errore da associare all'esecuzione interrotta.

`--error-type TEXT`  
Tipo di errore da associare all'esecuzione interrotta.

`--error-data TEXT`  
Dati di errore da associare all'esecuzione interrotta.

`--stack-trace TEXT`  
Immissioni di stack trace. Questa opzione può essere specificata più volte.

`--region TEXT`  
Imposta la AWS regione del servizio (ad esempio,`us-east-1`).

`--profile TEXT`  
Seleziona un profilo specifico dal tuo file di credenziali per ottenere le AWS credenziali.

`--config-env TEXT`  
Nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione. Impostazione predefinita: `default`

`--config-file TEXT`  
File di configurazione contenente i valori dei parametri predefiniti. Impostazione predefinita: `samconfig.toml`

`--save-params`  
Salva i parametri forniti tramite la riga di comando nel file di configurazione.

`--beta-features / --no-beta-features`  
Abilita/disabilita le funzionalità beta.

`--debug`  
Attiva la registrazione di debug per stampare i messaggi di debug generati dalla CLI e visualizzare i timestamp AWS SAM .

`-h, --help`  
Mostra questo messaggio ed esce.

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

Interrompi l'esecuzione senza dettagli sull'errore:

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

Interrompi l'esecuzione con un messaggio di errore e digita:

```
$ 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"
```

Interrompi l'esecuzione con i dettagli completi dell'errore e la traccia dello stack:

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

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model sottocomando Command Line Interface ()AWS SAMCLI. `sam local generate-event`
+ Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Per la documentazione sull'uso del AWS SAMCLI `sam local generate-event` comando, vedere[Introduzione ai test con sam local generate-event](using-sam-cli-local-generate-event.md).

Il `sam local generate-event` sottocomando genera esempi di payload di eventi per i supporti. Servizi AWS

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

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

## Opzioni
<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>
Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare. Il valore predefinito è «default». Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-local-generate-event-options-config-file"></a>
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare. Il valore predefinito si trova `samconfig.toml` nella radice della directory del progetto. Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--help`  <a name="ref-sam-cli-local-generate-event-options-help"></a>
Mostra questo messaggio ed esce.

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

Per visualizzare un elenco dei servizi supportati, esegui quanto segue:

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

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

Per visualizzare un elenco di eventi supportati che possono essere generati per ogni servizio, esegui quanto segue:

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

## Opzioni relative agli eventi
<a name="ref-sam-cli-local-generate-event-event-options"></a>

Per visualizzare un elenco delle opzioni di evento supportate che puoi modificare, esegui quanto segue:

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

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

Per esempi sull'utilizzo del `sam local generate-event` sottocomando, fare riferimento a. [Genera eventi di esempio](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>

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model `sam local invoke` sottocomando Command Line Interface (AWS SAMCLI).
+ Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Per la documentazione sull'uso del AWS SAMCLI `sam local invoke` sottocomando, vedere[Introduzione ai test con sam local invoke](using-sam-cli-local-invoke.md).

Il `sam local invoke` sottocomando avvia una chiamata una tantum di una funzione localmente. AWS Lambda 

**Nota**  
Non è consigliabile utilizzare le funzionalità di richiamo locale di SAM CLI in codice non attendibile. Per ottenere un isolamento completo dall'ambiente locale, esegui il codice direttamente nel servizio Lambda.

**Nota**  
Per funzioni durevoli, `sam local invoke` supporta l'esecuzione con stato con checkpoint e replay automatici. Il contenitore rimane in funzione durante l'esecuzione durevole della funzione per gestire la persistenza e la ripresa dello stato.

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

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

**Nota**  
Se hai più di una funzione definita nel tuo AWS SAM modello, fornisci l'ID logico della funzione che desideri richiamare.

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

**Resource ID (ID risorsa)**  <a name="ref-sam-cli-local-invoke-args-resource-id"></a>
L'ID della funzione Lambda da richiamare.  
Questo argomento è facoltativo. Se l'applicazione contiene una singola funzione Lambda, la AWS SAM CLI la richiamerà. Se l'applicazione contiene più funzioni, fornisci l'ID della funzione da richiamare.  
*Valori validi*: l'ID logico o l'ARN della risorsa.

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

`--add-host LIST`  <a name="ref-sam-cli-local-invoke-options-add-host"></a>
Passa un nome host alla mappatura dell'indirizzo IP al file host del contenitore Docker. Questo parametro può essere passato più volte.  

**Example**  
Ad esempio: `--add-host example.com:127.0.0.1`

`--beta-features | --no-beta-features`  <a name="ref-sam-cli-local-invoke-options-beta-features"></a>
Consenti o nega le funzionalità beta.

`--config-env TEXT`  <a name="ref-sam-cli-local-invoke-options-config-env"></a>
Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare. Il valore predefinito è «default». Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-local-invoke-options-config-file"></a>
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare. Il valore predefinito è "`samconfig.toml`" nella radice della directory del progetto. Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--container-env-vars`  <a name="ref-sam-cli-local-invoke-options-container-env-vars"></a>
(Facoltativo) Passa le variabili di ambiente al contenitore di immagini della funzione Lambda durante il debug locale.

`--container-host TEXT`  <a name="ref-sam-cli-local-invoke-options-container-host"></a>
Host del contenitore Lambda emulato localmente. Il valore predefinito è `localhost`. Se vuoi eseguirlo AWS SAMCLI in un contenitore Docker su macOS, puoi specificare. `host.docker.internal` Se desideri eseguire il contenitore su un host diverso da quello AWS SAMCLI, puoi specificare l'indirizzo IP dell'host remoto.

`--container-host-interface TEXT`  <a name="ref-sam-cli-local-invoke-options-container-host-interface"></a>
L'indirizzo IP dell'interfaccia di rete host a cui devono collegarsi le porte del contenitore. Il valore predefinito è `127.0.0.1`. Si usa `0.0.0.0` per collegarsi a tutte le interfacce.

`--debug`  <a name="ref-sam-cli-local-invoke-options-debug"></a>
Attiva la registrazione di debug per stampare i messaggi di debug AWS SAMCLI generati e per visualizzare i timestamp.

`--debug-args TEXT`  <a name="ref-sam-cli-local-invoke-options-debug-args"></a>
Argomenti aggiuntivi da passare al debugger.

`--debug-port, -d TEXT`  <a name="ref-sam-cli-local-invoke-options-debug-port"></a>
Quando specificato, avvia il contenitore di funzioni Lambda in modalità debug ed espone questa porta sull'host locale.

`--debugger-path TEXT`  <a name="ref-sam-cli-local-invoke-options-debugger-path"></a>
Il percorso dell'host di un debugger montato nel contenitore Lambda.

`--docker-network TEXT`  <a name="ref-sam-cli-local-invoke-options-docker-network"></a>
Il nome o l'ID di una rete Docker esistente a cui i contenitori Lambda Docker devono connettersi, insieme alla rete bridge predefinita. Se questo non è specificato, i contenitori Lambda si connettono solo alla rete bridge Docker predefinita.

`--docker-volume-basedir, -v TEXT`  <a name="ref-sam-cli-local-invoke-options-docker-volume-basedir"></a>
La posizione della directory di base in cui si trova il AWS SAM file. Se Docker è in esecuzione su un computer remoto, è necessario montare il percorso in cui esiste il AWS SAM file sulla macchina Docker e modificare questo valore in modo che corrisponda al computer remoto.

`--durable-execution-name TEXT`  <a name="ref-sam-cli-local-invoke-options-durable-execution-name"></a>
Nome per l'esecuzione durevole (solo per funzioni durevoli)

`--env-vars, -n PATH`  <a name="ref-sam-cli-local-invoke-options-env-vars"></a>
Il `.env` file JSON o che contiene i valori per le variabili di ambiente della funzione Lambda. Il formato del file viene rilevato automaticamente. Per ulteriori informazioni sui file delle variabili di ambiente, vedere[File di variabili di ambiente](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>
Il file JSON che contiene i dati degli eventi che vengono passati alla funzione Lambda quando viene richiamata. Se non si specifica questa opzione, non si presume alcun evento. Per inserire JSON da`stdin`, devi inserire il valore '-'. *Per informazioni dettagliate sui formati dei messaggi relativi agli eventi di diversi AWS servizi, consulta [Lavorare con altri servizi](https://docs.aws.amazon.com/lambda/latest/dg/lambda-services.html) nella Guida per gli AWS Lambda sviluppatori.*

`--force-image-build`  <a name="ref-sam-cli-local-invoke-options-force-image-build"></a>
Specifica se AWS SAMCLI deve ricostruire l'immagine usata per richiamare le funzioni Lambda con livelli.

`--help`  <a name="ref-sam-cli-local-invoke-options-help"></a>
Mostra questo messaggio ed esce.

`--hook-name TEXT`  <a name="ref-sam-cli-local-invoke-options-hook-name"></a>
Il nome dell'hook utilizzato per estendere le AWS SAMCLI funzionalità.  
Valori accettati:`terraform`.

`--invoke-image TEXT`  <a name="ref-sam-cli-local-invoke-options-invoke-image"></a>
L'URI dell'immagine del contenitore che si desidera utilizzare per l'invocazione della funzione locale. Per impostazione predefinita, AWS SAM estrae l'immagine del contenitore da Amazon ECR Public (che è elencato in[Archivi di immagini per AWS SAM](serverless-image-repositories.md)). Usa questa opzione per estrarre l'immagine da un'altra posizione.  
Ad esempio, `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>
Specifica la posizione della directory di base in cui vengono scaricati i layer utilizzati dal modello.

`--log-file, -l TEXT`  <a name="ref-sam-cli-local-invoke-options-log-file"></a>
Il file di registro a cui inviare i log di runtime.

`--mount-symlinks`  <a name="ref-sam-cli-local-invoke-options-mount-symlinks"></a>
Assicura che monti AWS SAMCLI sempre i collegamenti simbolici presenti nei file da compilare o richiamare. Questo vale solo per i collegamenti simbolici nella directory di primo livello (ovvero i collegamenti simbolici che si trovano direttamente nella radice della funzione). Per impostazione predefinita, i collegamenti simbolici non vengono montati ad eccezione di quelli necessari per essere utilizzati `build-in-source` `node_modules` in NodeJS.

`--no-event`  <a name="ref-sam-cli-local-invoke-options-no-event"></a>
Richiama la funzione con un evento vuoto.

`--no-memory-limit`  <a name="ref-sam-cli-local-invoke-options-no-memory-limit"></a>
Rimuove la limitazione di memoria nel contenitore durante la chiamata locale, anche quando la memoria è configurata nel modello. AWS SAM 

`--parameter-overrides`  <a name="ref-sam-cli-local-invoke-options-parameter-overrides"></a>
Una stringa che contiene le sostituzioni CloudFormation dei parametri codificate come coppie chiave-valore. Utilizzate lo stesso formato di (). AWS Command Line Interface AWS CLI Il AWS SAMCLI formato è costituito da parole chiave e valori esplicite, ogni override è separata da uno spazio. Di seguito, sono riportati due esempi:  
+ `--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>
Il profilo specifico del file delle credenziali che ottiene le credenziali. AWS 

`--region TEXT`  <a name="ref-sam-cli-local-invoke-options-region"></a>
La AWS regione in cui effettuare la distribuzione. Ad esempio, us-east-1.

`--runtime TEXT`  <a name="ref-sam-cli-local-invoke-options-runtime"></a>
Utilizza il runtime specificato per richiamare una funzione Lambda localmente. Ciò sovrascrive il runtime definito nel file. `template.yml` Ciò consente inoltre di testare le funzioni Lambda con tempi di esecuzione diversi senza modificare la configurazione della funzione originale.

`--save-params`  <a name="ref-sam-cli-local-invoke-options-save-params"></a>
Salva i parametri forniti nella riga di comando nel file di configurazione. AWS SAM 

`--shutdown`  <a name="ref-sam-cli-local-invoke-options-shutdown"></a>
Emula un evento di spegnimento dopo il completamento dell'invocazione, per testare la gestione delle estensioni del comportamento di spegnimento.

`--skip-prepare-infra`  <a name="ref-sam-cli-local-invoke-options-skip-prepare-infra"></a>
Salta la fase di preparazione se non sono state apportate modifiche all'infrastruttura. Da utilizzare con l'`--hook-name`opzione.

`--skip-pull-image`  <a name="ref-sam-cli-local-invoke-options-skip-pull-image"></a>
Per impostazione predefinita, AWS SAMCLI controlla l'ultimo ambiente di runtime remoto di Lambda e aggiorna automaticamente l'immagine locale per mantenerla sincronizzata.  
Specificate questa opzione per saltare l'estrazione dell'Dockerimmagine più recente per il vostro ambiente di runtime Lambda.

`--template, -t PATH`  <a name="ref-sam-cli-local-invoke-options-template"></a>
Il AWS SAM file modello.  
Questa opzione non è compatibile con`--hook-name`.  
Se si specifica questa opzione, AWS SAM carica solo il modello e le risorse locali a cui punta.

`--tenant-id TEXT`  <a name="ref-sam-cli-local-invoke-options-tenancyconfig"></a>
L'ID tenant per le funzioni Lambda multi-tenant. Utilizzato per garantire l'isolamento del calcolo tra diversi tenant. Richiesto quando si richiamano funzioni configurate con la modalità di isolamento dei tenant.

`--terraform-plan-file`  <a name="ref-sam-cli-local-invoke-options-terraform-plan-file"></a>
Il percorso relativo o assoluto del file del Terraform piano locale quando si utilizza with. AWS SAMCLI Terraform Cloud Questa opzione richiede che `--hook-name` sia impostata su`terraform`.

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

L'esempio seguente utilizza un evento generato per i test locali utilizzando un `s3.json` evento per richiamare localmente una funzione Lambda.

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

L'esempio seguente verifica la funzione ` HelloWorldFunction` utilizzando il runtime Python 3.11

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

L'esempio seguente verifica la funzione ` HelloWorldFunction` con un nome di esecuzione durevole

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

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

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model sottocomando Command Line Interface (AWS SAMCLI). `sam local start-api`
+ Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Per la documentazione sull'uso del AWS SAMCLI `sam local start-api` sottocomando, vedere[Introduzione ai test con sam local start-api](using-sam-cli-local-start-api.md).

Il `sam local start-api` sottocomando esegue le AWS Lambda funzioni localmente per eseguirle tramite un host di server HTTP locale.

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

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

## Opzioni
<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>
Passa un nome host alla mappatura dell'indirizzo IP al file host del contenitore Docker. Questo parametro può essere passato più volte.  

**Example**  
Ad esempio: `--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>
Consenti o nega le funzionalità beta.

`--config-env TEXT`  <a name="ref-sam-cli-local-start-api-options-config-env"></a>
Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare. Il valore predefinito è «default». Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-local-start-api-options-config-file"></a>
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare. Il valore predefinito è «samconfig.toml» nella radice della directory del progetto. Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--container-env-vars`  <a name="ref-sam-cli-local-start-api-options-container-env-vars"></a>
Opzionale. Passa le variabili di ambiente al contenitore di immagini durante il debug locale.

`--container-host TEXT`  <a name="ref-sam-cli-local-start-api-options-container-host"></a>
Host del contenitore Lambda emulato localmente. Il valore predefinito è `localhost`. Se vuoi eseguirlo AWS SAMCLI in un contenitore Docker su macOS, puoi specificare. `host.docker.internal` Se desideri eseguire il contenitore su un host diverso da quello AWS SAMCLI, puoi specificare l'indirizzo IP dell'host remoto.

`--container-host-interface TEXT`  <a name="ref-sam-cli-local-start-api-options-container-host-interface"></a>
L'indirizzo IP dell'interfaccia di rete host a cui devono collegarsi le porte del contenitore. Il valore predefinito è `127.0.0.1`. Si usa `0.0.0.0` per collegarsi a tutte le interfacce.

`--debug`  <a name="ref-sam-cli-local-start-api-options-debug"></a>
Attiva la registrazione di debug per stampare il messaggio di debug generato dai timestamp e visualizzarli. AWS SAMCLI

`--debug-args TEXT`  <a name="ref-sam-cli-local-start-api-options-debug-args"></a>
Argomenti aggiuntivi da passare al debugger.

`--debug-function`  <a name="ref-sam-cli-local-start-api-options-debug-function"></a>
Opzionale. Specifica la funzione Lambda a cui applicare le opzioni di debug quando viene specificato. `--warm-containers` Questo parametro si applica a`--debug-port`, `--debugger-path` e. `--debug-args`

`--debug-port, -d TEXT`  <a name="ref-sam-cli-local-start-api-options-debug-port"></a>
Quando specificato, avvia il contenitore di funzioni Lambda in modalità debug ed espone questa porta sull'host locale.

`--debugger-path TEXT`  <a name="ref-sam-cli-local-start-api-options-debugger-path"></a>
Il percorso host di un debugger che verrà montato nel contenitore Lambda.

`--docker-network TEXT`  <a name="ref-sam-cli-local-start-api-options-docker-network"></a>
Il nome o l'ID di una rete Docker esistente a cui i contenitori Lambda Docker devono connettersi, insieme alla rete bridge predefinita. Se questo non è specificato, i contenitori Lambda si connettono solo alla rete bridge Docker predefinita.

` --docker-volume-basedir, -v TEXT`  <a name="ref-sam-cli-local-start-api-options-docker-volume-basedir"></a>
La posizione della directory di base in cui si trova il AWS SAM file. Se Docker è in esecuzione su un computer remoto, è necessario montare il percorso in cui esiste il AWS SAM file sulla macchina Docker e modificare questo valore in modo che corrisponda al computer remoto.

`--env-vars, -n PATH`  <a name="ref-sam-cli-local-start-api-options-env-vars"></a>
Il `.env` file JSON o che contiene i valori per le variabili di ambiente della funzione Lambda. Il formato del file viene rilevato automaticamente.

`--force-image-build`  <a name="ref-sam-cli-local-start-api-options-force-image-build"></a>
Speciifica se AWS SAM CLI deve ricostruire l'immagine usata per richiamare funzioni con livelli.

`--help`  <a name="ref-sam-cli-local-start-api-options-help"></a>
Mostra questo messaggio ed esce.

`--hook-name TEXT`  <a name="ref-sam-cli-local-start-api-options-hook-name"></a>
Il nome dell'hook utilizzato per estendere le AWS SAMCLI funzionalità.  
Valori accettati:`terraform`.

`--host TEXT`  <a name="ref-sam-cli-local-start-api-options-host"></a>
Il nome host o l'indirizzo IP locale a cui collegarsi (impostazione predefinita: '127.0.0.1').

`--invoke-image TEXT`  <a name="ref-sam-cli-local-start-api-options-invoke-image"></a>
L'URI dell'immagine del contenitore che desideri utilizzare per le funzioni Lambda. Per impostazione predefinita, AWS SAM estrae l'immagine del contenitore da Amazon ECR Public. Usa questa opzione per estrarre l'immagine da un'altra posizione.  
Puoi specificare questa opzione più volte. Ogni istanza di questa opzione può accettare una stringa o una coppia chiave-valore. Se specificate una stringa, è l'URI dell'immagine del contenitore da utilizzare per tutte le funzioni dell'applicazione. Ad esempio, `sam local start-api --invoke-image public.ecr.aws/sam/emu-python3.8`. Se specificate una coppia chiave-valore, la chiave è il nome della risorsa e il valore è l'URI dell'immagine del contenitore da utilizzare per quella risorsa. Ad esempio, `sam local start-api --invoke-image public.ecr.aws/sam/emu-python3.8 --invoke-image Function1=amazon/aws-sam-cli-emulation-image-python3.8 `. Con le coppie chiave-valore, è possibile specificare immagini di contenitori diverse per risorse diverse.

`--layer-cache-basedir DIRECTORY`  <a name="ref-sam-cli-local-start-api-options-layer-cache-basedir"></a>
Specifica la posizione basedir in cui vengono scaricati i layer utilizzati dal modello.

`--log-file, -l TEXT`  <a name="ref-sam-cli-local-start-api-options-log-file"></a>
Il file di registro a cui inviare i log di runtime.

`--no-memory-limit`  <a name="ref-sam-cli-local-start-api-options-no-memory-limit"></a>
Rimuove la limitazione della memoria nel contenitore durante la chiamata locale, anche quando la memoria è configurata nel AWS SAM modello.

`--parameter-overrides`  <a name="ref-sam-cli-local-start-api-options-parameter-overrides"></a>
Una stringa che contiene le sostituzioni CloudFormation dei parametri codificate come coppie chiave-valore. Utilizzate lo stesso formato di (). AWS Command Line Interface AWS CLI Il AWS SAMCLI formato è costituito da parole chiave e valori esplicite, ogni override è separata da uno spazio. Di seguito, sono riportati due esempi:  
+ `--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>
Il numero di porta locale su cui ascoltare (impostazione predefinita: '3000').

`--profile TEXT`  <a name="ref-sam-cli-local-start-api-options-profile"></a>
Il profilo specifico del file delle credenziali che ottiene le AWS credenziali.

`--region TEXT`  <a name="ref-sam-cli-local-start-api-options-region"></a>
La AWS regione in cui effettuare la distribuzione. Ad esempio, us-east-1.

`--save-params`  <a name="ref-sam-cli-local-start-api-options-save-params"></a>
Salva i parametri forniti dalla riga di comando nel file di AWS SAM configurazione.

`--shutdown`  <a name="ref-sam-cli-local-start-api-options-shutdown"></a>
Emula un evento di spegnimento dopo il completamento dell'invocazione, per testare la gestione delle estensioni del comportamento di spegnimento.

`--skip-prepare-infra`  <a name="ref-sam-cli-local-start-api-options-skip-prepare-infra"></a>
Salta la fase di preparazione se non sono state apportate modifiche all'infrastruttura. Utilizzare con l'`--hook-name`opzione.

`--skip-pull-image`  <a name="ref-sam-cli-local-start-api-options-skip-pull-image"></a>
Specifica se la CLI deve ignorare l'estrazione dell'ultima immagine Docker per il runtime Lambda.

`--ssl-cert-file PATH`  <a name="ref-sam-cli-local-start-api-options-ssl-cert-file"></a>
Percorso del file del certificato SSL (impostazione predefinita: Nessuno). Quando si utilizza questa opzione, è necessario utilizzare anche l'`--ssl-key-file`opzione.

`--ssl-key-file PATH`  <a name="ref-sam-cli-local-start-api-options-static-dir"></a>
Percorso del file della chiave SSL (impostazione predefinita: Nessuno). Quando si utilizza questa opzione, è necessario utilizzare anche l'`--ssl-cert-file`opzione.

`--static-dir, -s TEXT`  <a name="ref-sam-cli-local-start-api-options-static-dir"></a>
Tutti i file di risorse statici (ad esempioCSS/JavaScript/HTML) che si trovano in questa directory vengono presentati in`/`.

`--template, -t PATH`  <a name="ref-sam-cli-local-start-api-options-template"></a>
Il file AWS SAM modello.  
Se si specifica questa opzione, AWS SAM carica solo il modello e le risorse locali a cui punta.

`--terraform-plan-file`  <a name="ref-sam-cli-local-start-api-options-terraform-plan-file"></a>
Il percorso relativo o assoluto del file del Terraform piano locale quando si utilizza AWS SAMCLI withTerraform Cloud. Questa opzione richiede che `--hook-name` sia impostata su`terraform`.

`--warm-containers [EAGER | LAZY]`  <a name="ref-sam-cli-local-start-api-options-warm-containers"></a>
Opzionale. Specifica come AWS SAMCLI gestisce i contenitori per ogni funzione.  
Sono disponibili due opzioni:  
   `EAGER`: I contenitori per tutte le funzioni vengono caricati all'avvio e persistono tra le chiamate.  
   `LAZY`: I contenitori vengono caricati solo quando ogni funzione viene richiamata per la prima volta. Questi contenitori persistono per chiamate aggiuntive.

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

L'esempio seguente avvia un server locale, che consente di testare l'applicazione tramite API. Affinché questo comando funzioni, è necessario che l'applicazione sia installata e Docker sia in esecuzione.

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

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

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model sottocomando Command Line Interface ()AWS SAMCLI. `sam local start-lambda`
+ Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Per la documentazione sull'uso del AWS SAMCLI `sam local start-lambda` sottocomando, vedere[Introduzione ai test con sam local start-lambda](using-sam-cli-local-start-lambda.md).

Il `sam local start-lambda` sottocomando avvia un endpoint locale da emulare. AWS Lambda

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

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

## Opzioni
<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>
Passa un nome host alla mappatura dell'indirizzo IP al file host del contenitore Docker. Questo parametro può essere passato più volte.  

**Example**  
Ad esempio: `--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>
Consenti o nega le funzionalità beta.

`--config-env TEXT`  <a name="ref-sam-cli-local-start-lambda-options-config-env"></a>
Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare. Il valore predefinito è «default». Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-local-start-lambda-options-config-file"></a>
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare. Il valore predefinito è «samconfig.toml» nella radice della directory del progetto. Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--container-env-vars`  <a name="ref-sam-cli-local-start-lambda-options-container-env-vars"></a>
Opzionale. Passa le variabili di ambiente al contenitore di immagini durante il debug locale.

`--container-host TEXT`  <a name="ref-sam-cli-local-start-lambda-options-container-host"></a>
Host del contenitore Lambda emulato localmente. Il valore predefinito è `localhost`. Se vuoi eseguirlo AWS SAMCLI in un contenitore Docker su macOS, puoi specificare. `host.docker.internal` Se desideri eseguire il contenitore su un host diverso da quello AWS SAMCLI, puoi specificare l'indirizzo IP dell'host remoto.

`--container-host-interface TEXT`  <a name="ref-sam-cli-local-start-lambda-options-container-host-interface"></a>
L'indirizzo IP dell'interfaccia di rete host a cui devono collegarsi le porte del contenitore. Il valore predefinito è `127.0.0.1`. Si usa `0.0.0.0` per collegarsi a tutte le interfacce.

`--debug`  <a name="ref-sam-cli-local-start-lambda-options-debug"></a>
Attiva la registrazione di debug per stampare il messaggio di debug generato dai timestamp e visualizzarli. AWS SAMCLI

`--debug-args TEXT`  <a name="ref-sam-cli-local-start-lambda-options-debug-args"></a>
Argomenti aggiuntivi da passare al debugger.

`--debug-function`  <a name="ref-sam-cli-local-start-lambda-options-debug-function"></a>
Opzionale. Specifica la funzione Lambda a cui applicare le opzioni di debug quando viene specificato. `--warm-containers` Questo parametro si applica a`--debug-port`, `--debugger-path` e. `--debug-args`

`--debug-port, -d TEXT`  <a name="ref-sam-cli-local-start-lambda-options-debug-port"></a>
Quando specificato, avvia il contenitore di funzioni Lambda in modalità debug ed espone questa porta sull'host locale.

`--debugger-path TEXT`  <a name="ref-sam-cli-local-start-lambda-options-debugger-path"></a>
Il percorso dell'host verso un debugger da montare nel contenitore Lambda.

`--docker-network TEXT`  <a name="ref-sam-cli-local-start-lambda-options-docker-network"></a>
Il nome o l'ID di una rete Docker esistente a cui i contenitori Lambda Docker devono connettersi, insieme alla rete bridge predefinita. Se viene specificato, i contenitori Lambda si connettono solo alla rete bridge Docker predefinita.

`--docker-volume-basedir, -v TEXT`  <a name="ref-sam-cli-local-start-lambda-options-docker-volume-basedir"></a>
La posizione della directory di base in cui si trova il AWS SAM file. Se Docker è in esecuzione su un computer remoto, è necessario montare il percorso in cui esiste il AWS SAM file sulla macchina Docker e modificare questo valore in modo che corrisponda al computer remoto.

`--env-vars, -n PATH`  <a name="ref-sam-cli-local-start-lambda-options-env-vars"></a>
Il `.env` file JSON o che contiene i valori per le variabili di ambiente della funzione Lambda. Il formato del file viene rilevato automaticamente.

`--force-image-build`  <a name="ref-sam-cli-local-start-lambda-options-force-image-build"></a>
Specificate se CLI deve ricostruire l'immagine usata per richiamare funzioni con livelli.

`--help`  <a name="ref-sam-cli-local-start-lambda-options-help"></a>
Mostra questo messaggio ed esce.

`--hook-name TEXT`  <a name="ref-sam-cli-local-start-lambda-options-hook-name"></a>
Il nome dell'hook utilizzato per estendere le AWS SAMCLI funzionalità.  
Valori accettati:`terraform`.

`--host TEXT`  <a name="ref-sam-cli-local-start-lambda-options-host"></a>
Il nome host o l'indirizzo IP locale a cui collegarsi (impostazione predefinita: '127.0.0.1').

`--invoke-image TEXT`  <a name="ref-sam-cli-local-start-lambda-options-invoke-image"></a>
L'URI dell'immagine del contenitore che si desidera utilizzare per l'invocazione della funzione locale. Per impostazione predefinita, AWS SAM estrae l'immagine del contenitore da Amazon ECR Public. Usa questa opzione per estrarre l'immagine da un'altra posizione.  
Ad esempio, `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>
Specifica la posizione basedir in cui vengono scaricati i layer utilizzati dal modello.

`--log-file, -l TEXT`  <a name="ref-sam-cli-local-start-lambda-options-log-file"></a>
Il file di registro a cui inviare i log di runtime.

`--no-memory-limit`  <a name="ref-sam-cli-local-start-lambda-options-no-memory-limit"></a>
Rimuove la limitazione della memoria nel contenitore durante la chiamata locale, anche quando la memoria è configurata nel AWS SAM modello.

`--parameter-overrides`  <a name="ref-sam-cli-local-start-lambda-options-parameter-overrides"></a>
Una stringa che contiene le sostituzioni CloudFormation dei parametri codificate come coppie chiave-valore. Utilizzate lo stesso formato di (). AWS Command Line Interface AWS CLI Il AWS SAMCLI formato è costituito da parole chiave e valori esplicite, ogni override è separata da uno spazio. Di seguito, sono riportati due esempi:  
+ `--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>
Il numero di porta locale su cui ascoltare (impostazione predefinita: '3001').

`--profile TEXT`  <a name="ref-sam-cli-local-start-lambda-options-profile"></a>
Il profilo specifico del file delle credenziali che ottiene AWS le credenziali.

`--region TEXT`  <a name="ref-sam-cli-local-start-lambda-options-region"></a>
La AWS regione in cui effettuare la distribuzione. Ad esempio, us-east-1.

`--save-params`  <a name="ref-sam-cli-local-start-lambda-options-save-params"></a>
Salva i parametri forniti dalla riga di comando nel file di AWS SAM configurazione.

`--shutdown`  <a name="ref-sam-cli-local-start-lambda-options-shutdown"></a>
Emula un evento di spegnimento dopo il completamento dell'invocazione, per testare la gestione delle estensioni del comportamento di spegnimento.

`--skip-prepare-infra`  <a name="ref-sam-cli-local-start-lambda-options-skip-prepare-infra"></a>
Salta la fase di preparazione se non sono state apportate modifiche all'infrastruttura. Utilizzare con l'`--hook-name`opzione.

`--skip-pull-image`  <a name="ref-sam-cli-local-start-lambda-options-skip-pull-image"></a>
Specifica se CLI non si deve estrarre l'ultima immagine Docker per il runtime Lambda.

`--template, -t PATH`  <a name="ref-sam-cli-local-start-lambda-options-template"></a>
 AWS SAM Il file modello.  
Se si specifica questa opzione, AWS SAM carica solo il modello e le risorse locali a cui punta. Questa opzione non è compatibile con`--hook-name`.

`--terraform-plan-file`  <a name="ref-sam-cli-local-start-lambda-options-terraform-plan-file"></a>
Il percorso relativo o assoluto del file del Terraform piano locale quando si utilizza AWS SAMCLI withTerraform Cloud. Questa opzione richiede che `--hook-name` sia impostata su`terraform`.

`--warm-containers [EAGER | LAZY]`  <a name="ref-sam-cli-local-start-lambda-options-warm-containers"></a>
Opzionale. Specifica come AWS SAMCLI gestisce i contenitori per ogni funzione.  
Sono disponibili due opzioni:  
+ `EAGER`: I contenitori per tutte le funzioni vengono caricati all'avvio e persistono tra le chiamate.
+ `LAZY`: I contenitori vengono caricati solo quando ogni funzione viene richiamata per la prima volta. Questi contenitori persistono per chiamate aggiuntive.

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

Per un esempio dettagliato e una procedura dettagliata sull'utilizzo del `sam local start-lambda` sottocomando, fare riferimento a. [Introduzione ai test con sam local start-lambda](using-sam-cli-local-start-lambda.md)

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

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam logs`.

Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Il `sam logs` comando recupera i log generati dalle tue AWS Lambda funzioni.

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

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

## Opzioni
<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>
Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare. Il valore predefinito è «default». Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-logs-options-config-file"></a>
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare. Il valore predefinito è «samconfig.toml» nella radice della directory del progetto. Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--cw-log-group LIST`  <a name="sam-cli-command-reference-sam-logs-options-cw-log-group"></a>
Include i log dei gruppi di CloudWatch log Logs specificati. Se si specifica questa opzione insieme a`name`, AWS SAM include i registri dei gruppi di log specificati oltre ai registri delle risorse denominate.

`--debug`  <a name="sam-cli-command-reference-sam-logs-options-debug"></a>
Attiva la registrazione di debug per stampare il messaggio di debug generato dai timestamp e visualizzarli. AWS SAMCLI

`---end-time, e TEXT`  <a name="sam-cli-command-reference-sam-logs-options-end-time"></a>
Recupera i log aggiornati a quest'ora. L'ora può essere costituita da valori relativi come «5 minuti fa», «domani» o un timestamp formattato come «2018-01-01 10:10:10».

`--filter TEXT`  <a name="sam-cli-command-reference-sam-logs-options-filter"></a>
Consente di specificare un'espressione per trovare rapidamente i log che corrispondono a termini, frasi o valori negli eventi di registro. Può trattarsi di una semplice parola chiave (ad esempio «errore») o di un pattern supportato da Amazon CloudWatch Logs. Per la sintassi, consulta la documentazione di [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>
Mostra questo messaggio ed esce.

`--include-traces`  <a name="sam-cli-command-reference-sam-logs-options-include-traces"></a>
Include tracce X-Ray nell'output del registro.

`--name, -n TEXT`  <a name="sam-cli-command-reference-sam-logs-options-name"></a>
Il nome della risorsa per la quale recuperare i log. Se questa risorsa fa parte di uno CloudFormation stack, può essere l'ID logico della risorsa funzionale nel CloudFormation modello /.AWS SAM È possibile fornire più nomi ripetendo nuovamente il parametro. Se la risorsa si trova in uno stack nidificato, al nome può essere aggiunto il nome dello stack nidificato per estrarre i log da quella risorsa (/). NestedStackLogicalId ResourceLogicalId Se il nome della risorsa non viene fornito, lo stack specificato verrà scansionato e verranno recuperate le informazioni di registro per tutte le risorse supportate. Se non specificate questa opzione, AWS SAM recupera i log per tutte le risorse nello stack specificato. Sono supportati i seguenti tipi di risorse:  
+ `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>
Speciifica il formato di output per i registri. Per stampare registri formattati, specificare. `text` Per stampare i log come JSON, specificare. `json`

`--profile TEXT`  <a name="sam-cli-command-reference-sam-logs-options-profile"></a>
Il profilo specifico del file delle credenziali che ottiene le credenziali. AWS 

`--region TEXT`  <a name="sam-cli-command-reference-sam-logs-options-region"></a>
La AWS regione in cui effettuare la distribuzione. Ad esempio, us-east-1.

`--save-params`  <a name="sam-cli-command-reference-sam-logs-options-save-params"></a>
Salva i parametri forniti dalla riga di comando nel file di AWS SAM configurazione.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-logs-options-stack-name"></a>
Il nome dello CloudFormation stack di cui fa parte la risorsa.

`--start-time, -s TEXT`  <a name="sam-cli-command-reference-sam-logs-options-start-time"></a>
Recupera i log a partire da questo momento. L'ora può essere costituita da valori relativi come «5 minuti fa», «ieri» o un timestamp formattato come «2018-01-01 10:10:10». Il valore predefinito è «10 minuti fa».

` --tail, -t`  <a name="sam-cli-command-reference-sam-logs-options-tail"></a>
Coordina l'output del registro. Questo ignora l'argomento dell'ora di fine e continua a recuperare i log non appena diventano disponibili.

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

Quando le funzioni fanno parte di uno CloudFormation stack, puoi recuperare i log utilizzando l'ID logico della funzione quando specifichi il nome dello stack.

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

Visualizza i log per un intervallo di tempo specifico utilizzando le opzioni -s (--start-time) e -e (--end-time).

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

Puoi anche aggiungere l'`--tail`opzione per attendere nuovi log e vederli man mano che arrivano.

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

Utilizza l'`--filter`opzione per trovare rapidamente i log che corrispondono a termini, frasi o valori nei tuoi eventi di registro.

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

Visualizza i log di una risorsa in uno stack secondario.

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

Registri di coda per tutte le risorse supportate nell'applicazione.

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

Recupera i log per una funzione Lambda specifica e l'API API Gateway nella tua applicazione.

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

Recupera i log per tutte le risorse supportate nell'applicazione e, in aggiunta, dai gruppi di log specificati.

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

La AWS Serverless Application Model Command Line Interface (AWS SAM CLI) impacchetta un' AWS SAM applicazione.

Questo comando crea un `.zip` file con il codice e le dipendenze e carica il file su Amazon Simple Storage Service (Amazon S3). AWS SAM abilita la crittografia per tutti i file archiviati in Amazon S3. Quindi restituisce una copia del AWS SAM modello, sostituendo i riferimenti agli artefatti locali con la posizione Amazon S3 in cui il comando ha caricato gli artefatti.

Per impostazione predefinita, quando si utilizza questo comando, si AWS SAMCLI presuppone che la directory di lavoro corrente sia la directory principale del progetto. Il AWS SAMCLI primo tenta di individuare un file modello creato utilizzando il [sam build](sam-cli-command-reference-sam-build.md) comando, situato nella `.aws-sam` sottocartella e denominato. `template.yaml` Successivamente, AWS SAMCLI tenta di individuare un file modello denominato `template.yaml` o `template.yml` nella directory di lavoro corrente. Se si specifica l'`--template`opzione, il comportamento predefinito AWS SAMCLI dell'opzione viene sovrascritto e includerà solo il AWS SAM modello e le risorse locali a cui punta.

**Nota**  
[sam deploy](sam-cli-command-reference-sam-deploy.md)ora esegue implicitamente la funzionalità di. `sam package` È possibile utilizzare il [sam deploy](sam-cli-command-reference-sam-deploy.md) comando direttamente per impacchettare e distribuire l'applicazione.

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

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

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

**Resource ID (ID risorsa)**  <a name="sam-cli-command-reference-sam-package-args-resource-id"></a>
L'ID della funzione Lambda da impacchettare.  
Questo argomento è facoltativo. Se l'applicazione contiene una singola funzione Lambda, la AWS SAM CLI la impacchetterà. Se l'applicazione contiene più funzioni, fornisci l'ID della funzione per impacchettare una singola funzione.  
*Valori validi*: l'ID logico o l'ARN della risorsa.

## Opzioni
<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>
Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare. Il valore predefinito è «default». Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-package-options-config-file"></a>
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare. Il valore predefinito è «samconfig.toml» nella radice della directory del progetto. Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-package-options-debug"></a>
Attiva la registrazione di debug per stampare il messaggio di debug generato dai timestamp e visualizzarli. AWS SAMCLI

`--force-upload`  <a name="sam-cli-command-reference-sam-package-options-force-upload"></a>
Sostituisci i file esistenti nel bucket Amazon S3. Specificate questo flag per caricare gli artefatti anche se corrispondono agli artefatti esistenti nel bucket Amazon S3.

`--help`  <a name="sam-cli-command-reference-sam-package-options-help"></a>
Mostra questo messaggio ed esce.

`--image-repository TEXT`  <a name="sam-cli-command-reference-sam-package-options-image-repository"></a>
L'URI del repository Amazon Elastic Container Registry (Amazon ECR) in cui questo comando carica l'immagine della funzione. Obbligatorio per le funzioni dichiarate con il `Image` tipo di pacchetto.

`--kms-key-id TEXT`  <a name="sam-cli-command-reference-sam-package-options-kms-key-id"></a>
L'ID di una chiave AWS Key Management Service (AWS KMS) utilizzata per crittografare gli artefatti che sono a riposo nel bucket Amazon S3. Se questa opzione non è specificata, AWS SAM utilizza le chiavi di crittografia gestite da Amazon S3.

`--metadata`  <a name="sam-cli-command-reference-sam-package-options-metadata"></a>
(Facoltativo) Una mappa di metadati da allegare a tutti gli artefatti a cui si fa riferimento nel modello.

`--no-progressbar`  <a name="sam-cli-command-reference-sam-package-options-no-progressbar"></a>
Non visualizzare una barra di avanzamento durante il caricamento di artefatti su Amazon S3.

`--output-template-file PATH`  <a name="sam-cli-command-reference-sam-package-options-output-template-file"></a>
Il percorso del file in cui il comando scrive il modello confezionato. Se non specificate un percorso, il comando scrive il modello nello standard output.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-package-options-profile"></a>
Il profilo specifico del file delle credenziali che ottiene le AWS credenziali.

`--region TEXT`  <a name="sam-cli-command-reference-sam-package-options-region"></a>
La AWS regione in cui effettuare la distribuzione. Ad esempio, us-east-1.

`--resolve-s3`  <a name="sam-cli-command-reference-sam-package-options-resolve-s3"></a>
Crea automaticamente un bucket Amazon S3 da utilizzare per il packaging. Se specifichi entrambe le `--resolve-s3` opzioni `--s3-bucket` e, si verificherà un errore.

`--s3-bucket TEXT`  <a name="sam-cli-command-reference-sam-package-options-s3-bucket"></a>
Il nome del bucket Amazon S3 in cui questo comando carica il tuo artefatto. Se il tuo artefatto è più grande di 51.200 byte, è richiesta l'opzione o l'opzione. `--s3-bucket` `--resolve-s3` Se si specificano entrambe le `--resolve-s3` opzioni `--s3-bucket` e, si verificherà un errore.

`--s3-prefix TEXT`  <a name="sam-cli-command-reference-sam-package-options-s3-prefix"></a>
Prefisso aggiunto al nome degli artefatti che vengono caricati nel bucket Amazon S3. Il nome del prefisso è un nome di percorso (nome della cartella) per il bucket Amazon S3. Questo vale solo per le funzioni dichiarate con `Zip` il tipo di pacchetto.

`--save-params`  <a name="sam-cli-command-reference-sam-package-options-save-params"></a>
Salva i parametri forniti dalla riga di comando nel file AWS SAM di configurazione.

`--signing-profiles LIST`  <a name="sam-cli-command-reference-sam-package-options-signing-profiles"></a>
(Facoltativo) L'elenco dei profili di firma con cui firmare i pacchetti di distribuzione. Questo parametro accetta un elenco di coppie chiave-valore, in cui la chiave è il nome della funzione o del livello da firmare e il valore è il profilo di firma, con un proprietario del profilo opzionale delimitato da. `:` Ad esempio, `FunctionNameToSign=SigningProfileName1 LayerNameToSign=SigningProfileName2:SigningProfileOwner`.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-package-options-template-file"></a>
Il percorso e il nome del file in cui si trova il AWS SAM modello.  
Se si specifica questa opzione, AWS SAM impacchetta solo il modello e le risorse locali a cui punta.

`--use-json`  <a name="sam-cli-command-reference-sam-package-options-use-json"></a>
Esporta JSON per il CloudFormation modello. Per impostazione predefinita, viene utilizzato YAML.

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

L'esempio seguente crea e impacchetta artefatti per una funzione e applicazioni Lambda. CodeDeploy Gli artefatti vengono caricati in un bucket Amazon S3. L'output del comando è un nuovo file denominato `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>

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model `sam local pipeline bootstrap` sottocomando Command Line Interface (AWS SAMCLI).

Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Il `sam pipeline bootstrap` sottocomando genera le risorse di AWS infrastruttura necessarie per connettersi al sistema CI/CD. Questo passaggio deve essere eseguito per ogni fase di distribuzione nella pipeline prima di eseguire il comando. **sam pipeline init**

Questo sottocomando imposta le seguenti risorse di AWS infrastruttura:
+ Possibilità di configurare le autorizzazioni della pipeline tramite:
  + Un utente IAM della pipeline con ID della chiave di accesso e credenziali di accesso alla chiave segreta da condividere con il sistema. CI/CD 
**Nota**  
Consigliamo di ruotare regolarmente le chiavi di accesso. Per ulteriori informazioni, consulta [Ruotare regolarmente le chiavi di accesso per i casi d'uso che richiedono credenziali a lungo termine](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#rotate-credentials) nella Guida per l'utente *IAM*.
  +  CI/CD Piattaforme supportate tramite OIDC. Per un'introduzione all'uso di OIDC con AWS SAM pipeline, vai a. [Come utilizzare l'autenticazione OIDC con le pipeline AWS SAM](deploying-with-oidc.md)
+ Un ruolo IAM di CloudFormation esecuzione assunto da CloudFormation per distribuire l'applicazione. AWS SAM 
+ Un bucket Amazon S3 per contenere gli artefatti. AWS SAM 
+ Facoltativamente, un repository di immagini Amazon ECR per contenere pacchetti di distribuzione Lambda con immagini container (se disponi di una risorsa di tipo pacchetto). `Image`

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

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

## Opzioni
<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 del repository Bitbucket. Questa opzione è specifica per l'utilizzo di Bitbucket OIDC per le autorizzazioni.  
Questo valore è disponibile all'indirizzo https://bitbucket.org///-connect *workspace* *repository* admin/addon/admin/pipelines/openid 

`--bucket TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-bucket"></a>
L'ARN del bucket Amazon S3 che contiene gli artefatti. AWS SAM 

`--cicd-provider TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-cicd-provider"></a>
La CI/CD piattaforma per la pipeline. AWS SAM 

`--cloudformation-execution-role TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-cloudformation-execution-role"></a>
L'ARN del ruolo IAM da assumere CloudFormation durante la distribuzione dello stack dell'applicazione. Forniscilo solo se desideri utilizzare il tuo ruolo. Altrimenti, il comando creerà un nuovo ruolo.

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-config-env"></a>
Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare. Il valore predefinito è **default**. Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-config-file"></a>
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare. Il valore predefinito si trova `samconfig.toml` nella radice della directory del progetto. Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--confirm-changeset | --no-confirm-changeset`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-confirm-changeset"></a>
Richiedi di confermare la distribuzione delle tue risorse.

`--create-image-repository | --no-create-image-repository`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-create-image-repository"></a>
Specificare se creare un repository di immagini Amazon ECR se non ne viene fornito nessuno. Il repository Amazon ECR contiene le immagini del contenitore delle funzioni Lambda o dei livelli con un tipo di pacchetto di. `Image` Il valore predefinito è `--no-create-image-repository`.

`--debug`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-debug"></a>
Attiva la registrazione di debug e stampa i messaggi di debug che AWS SAMCLI genera e visualizza i timestamp.

`--deployment-branch TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-deployment-branch"></a>
Nome del ramo da cui verranno effettuate le distribuzioni. Questa opzione è specifica per l'utilizzo di GitHub Actions OIDC per le autorizzazioni.

`--github-org TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-github-org"></a>
L' GitHub organizzazione a cui appartiene il repository. Se non esiste alcuna organizzazione, inserisci il nome utente del proprietario del repository. Questa opzione è specifica per l'utilizzo di GitHub Actions OIDC per le autorizzazioni.

`--github-repo TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-github-repo"></a>
Nome del GitHub repository da cui verranno eseguite le distribuzioni. Questa opzione è specifica per l'utilizzo di GitHub Actions OIDC per le autorizzazioni.

`--gitlab-group TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-gitlab-group"></a>
Il GitLab gruppo a cui appartiene il repository. Questa opzione è specifica per l'utilizzo di GitLab OIDC per le autorizzazioni.

`--gitlab-project TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-gitlab-project"></a>
Il GitLab nome del progetto. Questa opzione è specifica per l'utilizzo di GitLab OIDC per le autorizzazioni.

`--help, -h`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-help"></a>
Mostra questo messaggio ed esce.

`--image-repository TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-image-repository"></a>
L'ARN di un repository di immagini Amazon ECR che contiene le immagini del contenitore di funzioni Lambda o livelli con un tipo di pacchetto di. `Image` Se fornite, le opzioni vengono ignorate. `--create-image-repository` Se non viene fornito e `--create-image-repository` viene specificato, il comando ne crea una.

`--interactive | --no-interactive`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-interactive"></a>
Disabilita la richiesta interattiva per i parametri di bootstrap e fallisce se mancano i parametri richiesti. Il valore predefinito è `--interactive`. Per questo comando, `--stage` è l'unico parametro richiesto.  
Se `--no-interactive` specificato insieme a`--use-oidc-provider`, devono essere inclusi tutti i parametri richiesti per il provider OIDC.

`--oidc-client-id TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-client-id"></a>
L'ID client configurato per l'uso con il provider OIDC.

`--oidc-provider [github-actions | gitlab | bitbucket-pipelines]`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-provider"></a>
Nome del CI/CD provider che verrà utilizzato per le autorizzazioni OIDC. GitLab GitHub, e Bitbucket sono supportati.

`--oidc-provider-url TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-provider-url"></a>
L'URL del provider OIDC. Il valore deve iniziare con. **https://**

`--permissions-provider [oidc | iam]`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-permissions-provider"></a>
Scegliete un fornitore di autorizzazioni per assumere il ruolo di esecuzione della pipeline. Il valore predefinito è **iam**.

`--pipeline-execution-role TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-pipeline-execution-role"></a>
L'ARN del ruolo IAM che l'utente della pipeline deve assumere per operare in questa fase. Forniscilo solo se desideri utilizzare il tuo ruolo. Se non fornito, questo comando creerà un nuovo ruolo.

`--pipeline-user TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-pipeline-user"></a>
L'Amazon Resource Name (ARN) dell'utente IAM con l'ID della chiave di accesso e la chiave di accesso segreta condivisi con il CI/CD sistema. Viene utilizzato per concedere a questo utente IAM l'autorizzazione ad accedere all' AWS account corrispondente. Se non viene fornito, il comando creerà un utente IAM insieme all'ID della chiave di accesso e alle credenziali della chiave di accesso segreta.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-profile"></a>
Il profilo specifico del file di credenziali che ottiene AWS le credenziali.

`--region TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-region"></a>
La AWS regione in cui effettuare la distribuzione. Ad esempio, `us-east-1`.

`--save-params`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-save-params"></a>
Salva i parametri forniti dalla riga di comando nel file di AWS SAM configurazione.

`--stage TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-stage"></a>
Il nome della fase di distribuzione corrispondente. Viene utilizzato come suffisso per le risorse AWS infrastrutturali create.

## Risoluzione dei problemi
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-troubleshooting"></a>

### Errore: parametro obbligatorio mancante
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-troubleshooting-example1"></a>

Se `--no-interactive` viene specificato insieme a uno qualsiasi dei parametri richiesti `--use-oidc-provider` e non viene fornito, questo messaggio di errore verrà visualizzato insieme a una descrizione dei parametri mancanti.

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

L'esempio seguente crea le AWS risorse necessarie per creare il CI/CD sistema, attiva la registrazione di debug e stampa i messaggi di debug generati da AWS SAMCLI: utilizza un evento generato per i test locali utilizzando un evento per richiamare una funzione `s3.json` Lambda localmente

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

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

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model `sam pipeline init` sottocomando Command Line Interface (AWS SAMCLI).

Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Il `sam pipeline init` sottocomando genera un file di configurazione della pipeline che il CI/CD sistema può utilizzare per distribuire applicazioni serverless utilizzando. AWS SAM

Prima dell'uso**sam pipeline init**, è necessario avviare le risorse necessarie per ogni fase della pipeline. Puoi farlo eseguendo **sam pipeline init --bootstrap** per essere guidato nel processo di generazione del file di installazione e configurazione oppure facendo riferimento alle risorse che hai creato in precedenza con il **sam pipeline bootstrap** comando.

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

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

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

`--bootstrap`  <a name="sam-cli-command-reference-sam-pipeline-init-options-bootstrap"></a>
Abilita la modalità interattiva che guida l'utente nella creazione delle risorse AWS infrastrutturali necessarie.

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-pipeline-init-options-config-env"></a>
Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare. Il valore predefinito è `default`. Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--config-file TEXT`  <a name="sam-cli-command-reference-sam-pipeline-init-options-config-file"></a>
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare. Il valore predefinito si trova `samconfig.toml` nella directory principale del progetto. Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-pipeline-init-options-debug"></a>
Attiva la registrazione di debug per stampare i messaggi di debug AWS SAMCLI generati e per visualizzare i timestamp.

`--help, -h`  <a name="sam-cli-command-reference-sam-pipeline-init-options-help"></a>
Mostra questo messaggio ed esce.

`--save-params`  <a name="sam-cli-command-reference-sam-pipeline-init-options-save-params"></a>
Salva i parametri forniti dalla riga di comando nel file di AWS SAM configurazione.

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

L'esempio seguente mostra come utilizzare l'`--bootstrap`opzione che consente di utilizzare una modalità interattiva che guida l'utente nella creazione delle risorse infrastrutturali necessarie AWS :

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

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

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam publish`.

Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Il `sam publish` comando pubblica un' AWS SAM applicazione in. AWS Serverless Application Repository Questo comando accetta un AWS SAM modello impacchettato e pubblica l'applicazione nella regione specificata. AWS 

Il `sam publish` comando prevede che il AWS SAM modello includa una `Metadata` sezione contenente i metadati dell'applicazione necessari per la pubblicazione. Nella `Metadata` sezione, le `ReadmeUrl` proprietà `LicenseUrl` and devono fare riferimento ai bucket Amazon Simple Storage Service (Amazon S3), non ai file locali. Per ulteriori informazioni sulla `Metadata` sezione del AWS SAM modello, consulta. [Pubblicazione della tua applicazione con AWS SAMCLI](serverless-sam-template-publishing-applications.md)

Per impostazione predefinita, `sam publish` crea l'applicazione come privata. Prima di consentire ad altri AWS account di visualizzare e distribuire l'applicazione, è necessario condividerla. *Per informazioni sulla condivisione delle applicazioni, consulta [Esempi di policy AWS Serverless Application Repository basate sulle risorse](https://docs.aws.amazon.com/serverlessrepo/latest/devguide/security_iam_resource-based-policy-examples.html) nella Guida per gli sviluppatori.AWS Serverless Application Repository *

**Nota**  
Attualmente `sam publish` non supporta la pubblicazione di applicazioni annidate specificate localmente. Se l'applicazione contiene applicazioni nidificate, è necessario pubblicarle separatamente nell'applicazione principale AWS Serverless Application Repository prima di pubblicare l'applicazione principale.

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

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

## Opzioni
<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>
Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare. Il valore predefinito è «default». Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-publish-options-config-file"></a>
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare. Il valore predefinito è "`samconfig.toml`" nella radice della directory del progetto. Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-publish-options-debug"></a>
Attiva la registrazione di debug per stampare i messaggi di debug AWS SAMCLI generati e per visualizzare i timestamp.

`--help`  <a name="sam-cli-command-reference-sam-publish-options-help"></a>
Mostra questo messaggio ed esce.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-publish-options-profile"></a>
Il profilo specifico contenuto nel file delle credenziali che ottiene AWS le credenziali.

`--region TEXT`  <a name="sam-cli-command-reference-sam-publish-options-region"></a>
La AWS regione in cui effettuare la distribuzione. Ad esempio, us-east-1.

`--save-params`  <a name="sam-cli-command-reference-sam-publish-options-save-params"></a>
Salva i parametri forniti dalla riga di comando nel file di AWS SAM configurazione.

`--semantic-version TEXT`  <a name="sam-cli-command-reference-sam-publish-options-semantic-version"></a>
(Facoltativo) Utilizzate questa opzione per fornire una versione semantica dell'applicazione che sostituisca la `SemanticVersion` proprietà nella `Metadata` sezione del file modello. [Per ulteriori informazioni sul controllo delle versioni semantiche, vedete la specifica Semantic Versioning.](https://semver.org/)

`--template, -t PATH`  <a name="sam-cli-command-reference-sam-publish-options-template"></a>
Il percorso del file modello. AWS SAM `[default: template.[yaml|yml]]`

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

Per pubblicare un'applicazione:

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

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

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam remote callback`.

Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Il `sam remote callback` comando consente di inviare callback a esecuzioni di funzioni durature remote in esecuzione in AWS Lambda.

**Nota**  
Questi comandi richiedono l'accesso alle credenziali. AWS 

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

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

## Opzioni
<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>
Mostra questo messaggio ed esci.

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

`succeed`  <a name="sam-cli-command-reference-sam-remote-callback-subcommands-succeed"></a>
Invia una callback riuscita a un'esecuzione remota di una funzione duratura. Per ulteriori informazioni, consulta [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>
Invia un errore di callback a un'esecuzione remota di una funzione duratura. Per ulteriori informazioni, consulta [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>
Invia un battito cardiaco di callback a un'esecuzione remota di una funzione duratura. Per ulteriori informazioni, consulta [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>

Invia una callback riuscita a un'esecuzione remota di una funzione duratura.

**Nota**  
Questo comando richiede l'accesso alle AWS credenziali.

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

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

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

`CALLBACK_ID`  
L'identificatore univoco del callback a cui inviare una risposta riuscita.

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

`-r, --result TEXT`  
Risultato di successo: payload come stringa.

`--region TEXT`  
Imposta la AWS regione del servizio (ad esempio,`us-east-1`).

`--profile TEXT`  
Seleziona un profilo specifico dal tuo file di credenziali per ottenere le AWS credenziali.

`--config-env TEXT`  
Nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione. Impostazione predefinita: `default`

`--config-file TEXT`  
File di configurazione contenente i valori dei parametri predefiniti. Impostazione predefinita: `samconfig.toml`

`--save-params`  
Salva i parametri forniti tramite la riga di comando nel file di configurazione.

`--beta-features / --no-beta-features`  
Abilita/disabilita le funzionalità beta.

`--debug`  
Attiva la registrazione di debug per stampare i messaggi di debug generati dalla CLI e visualizzare i timestamp AWS SAM .

`-h, --help`  
Mostra questo messaggio ed esce.

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

Invia una richiamata riuscita senza risultati:

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

Invia una richiamata riuscita con risultato:

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

Invia un errore di callback a un'esecuzione remota di una funzione duratura.

**Nota**  
Questo comando richiede l'accesso alle AWS credenziali.

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

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

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

`CALLBACK_ID`  
L'identificatore univoco del callback a cui inviare una risposta di errore.

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

`--error-data TEXT`  
Dati di errore aggiuntivi.

`--stack-trace TEXT`  
Immetti le voci di tracciamento dello stack. Questa opzione può essere specificata più volte.

`--error-type TEXT`  
Tipo di errore.

`--error-message TEXT`  
Messaggio di errore dettagliato.

`--region TEXT`  
Imposta la AWS regione del servizio (ad esempio,`us-east-1`).

`--profile TEXT`  
Seleziona un profilo specifico dal tuo file di credenziali per ottenere le AWS credenziali.

`--config-env TEXT`  
Nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione. Impostazione predefinita: `default`

`--config-file TEXT`  
File di configurazione contenente i valori dei parametri predefiniti. Impostazione predefinita: `samconfig.toml`

`--save-params`  
Salva i parametri forniti tramite la riga di comando nel file di configurazione.

`--beta-features / --no-beta-features`  
Abilita/disabilita le funzionalità beta.

`--debug`  
Attiva la registrazione di debug per stampare i messaggi di debug generati dalla CLI e visualizzare i timestamp AWS SAM .

`-h, --help`  
Mostra questo messaggio ed esce.

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

Invia una richiamata di errore senza parametri:

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

Invia una richiamata di errore con messaggio di errore:

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

Invia una richiamata di errore con tutti i parametri:

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

Invia un battito cardiaco di callback a un'esecuzione remota di una funzione duratura.

**Nota**  
Questo comando richiede l'accesso alle credenziali. AWS 

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

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

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

`CALLBACK_ID`  
L'identificatore univoco del callback a cui inviare un heartbeat.

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

`--region TEXT`  
Imposta la AWS regione del servizio (ad esempio,`us-east-1`).

`--profile TEXT`  
Seleziona un profilo specifico dal tuo file di credenziali per ottenere le AWS credenziali.

`--config-env TEXT`  
Nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione. Impostazione predefinita: `default`

`--config-file TEXT`  
File di configurazione contenente i valori dei parametri predefiniti. Impostazione predefinita: `samconfig.toml`

`--save-params`  
Salva i parametri forniti tramite la riga di comando nel file di configurazione.

`--beta-features / --no-beta-features`  
Abilita/disabilita le funzionalità beta.

`--debug`  
Attiva la registrazione di debug per stampare i messaggi di debug generati dalla CLI e visualizzare i timestamp AWS SAM .

`-h, --help`  
Mostra questo messaggio ed esce.

## Esempi
<a name="ref-sam-cli-remote-callback-heartbeat-examples"></a>

Invia una richiamata del battito cardiaco:

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

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

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam remote execution`.

Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Il `sam remote execution` comando consente di gestire e ispezionare le esecuzioni di funzioni durevoli remote in esecuzione in AWS Lambda.

**Nota**  
Questi comandi richiedono l'accesso alle credenziali. AWS 

## Utilizzo
<a name="sam-cli-command-reference-sam-remote-execution-usage"></a>

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

## Opzioni
<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>
Mostra questo messaggio ed esci.

## Sottocomandi
<a name="sam-cli-command-reference-sam-remote-execution-subcommands"></a>

`get`  <a name="sam-cli-command-reference-sam-remote-execution-subcommands-get"></a>
Ottieni i dettagli di un'esecuzione duratura. Per ulteriori informazioni, consulta [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>
Ottieni la cronologia di esecuzione di un'esecuzione duratura di una funzione. Per ulteriori informazioni, consulta [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>
Interrompe l'esecuzione duratura di una funzione. Per ulteriori informazioni, consulta [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>

Recupera i dettagli dell'esecuzione durevole di una funzione specifica da AWS Lambda.

L'ARN di esecuzione deve essere nel formato restituito da Invoke o trovato nei log di esecuzione.

**Nota**  
Questo comando richiede l'accesso alle credenziali. AWS 

## Utilizzo
<a name="ref-sam-cli-remote-execution-get-usage"></a>

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

## Argomenti richiesti
<a name="ref-sam-cli-remote-execution-get-arguments"></a>

`DURABLE_EXECUTION_ARN`  
L'Amazon Resource Name (ARN) dell'esecuzione durevole della funzione di cui recuperare i dettagli.

## Opzioni
<a name="ref-sam-cli-remote-execution-get-options"></a>

`--format [summary|json]`  
Formato di output. Impostazione predefinita: `summary`

`--region TEXT`  
Imposta la AWS regione del servizio (ad esempio,`us-east-1`).

`--profile TEXT`  
Seleziona un profilo specifico dal tuo file di credenziali per ottenere le AWS credenziali.

`--config-env TEXT`  
Nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione. Impostazione predefinita: `default`

`--config-file TEXT`  
File di configurazione contenente i valori dei parametri predefiniti. Impostazione predefinita: `samconfig.toml`

`--save-params`  
Salva i parametri forniti tramite la riga di comando nel file di configurazione.

`--beta-features / --no-beta-features`  
Abilita/disabilita le funzionalità beta.

`--debug`  
Attiva la registrazione di debug per stampare i messaggi di debug generati dalla CLI e visualizzare i timestamp AWS SAM .

`-h, --help`  
Mostra questo messaggio ed esce.

## Esempi
<a name="ref-sam-cli-remote-execution-get-examples"></a>

Ottieni i dettagli dell'esecuzione con il formato di riepilogo predefinito:

```
$ 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'
```

Ottieni i dettagli di esecuzione in formato 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
```

**Nota**  
È necessario assicurarsi che i caratteri di controllo simili all'ARN di esecuzione vengano espulsi correttamente quando si utilizzano `$` i comandi della shell.

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

Recupera la cronologia di esecuzione di una funzione duratura specifica da AWS Lambda.

L'ARN di esecuzione deve essere nel formato restituito StartDurableExecution o trovato nei log di esecuzione.

**Nota**  
Questo comando richiede l'accesso alle credenziali. AWS 

## Utilizzo
<a name="ref-sam-cli-remote-execution-history-usage"></a>

```
$ sam remote execution history DURABLE_EXECUTION_ARN [OPTIONS]
```

## Argomenti richiesti
<a name="ref-sam-cli-remote-execution-history-arguments"></a>

`DURABLE_EXECUTION_ARN`  
L'Amazon Resource Name (ARN) dell'esecuzione durevole della funzione di cui recuperare la cronologia.

## Opzioni
<a name="ref-sam-cli-remote-execution-history-options"></a>

`--format [table|json]`  
Formato di output. Impostazione predefinita: `table`

`--region TEXT`  
Imposta la AWS regione del servizio (ad esempio,`us-east-1`).

`--profile TEXT`  
Seleziona un profilo specifico dal tuo file di credenziali per ottenere le AWS credenziali.

`--config-env TEXT`  
Nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione. Impostazione predefinita: `default`

`--config-file TEXT`  
File di configurazione contenente i valori dei parametri predefiniti. Impostazione predefinita: `samconfig.toml`

`--save-params`  
Salva i parametri forniti tramite la riga di comando nel file di configurazione.

`--beta-features / --no-beta-features`  
Abilita/disabilita le funzionalità beta.

`--debug`  
Attiva la registrazione di debug per stampare i messaggi di debug generati dalla CLI e visualizzare i timestamp AWS SAM .

`-h, --help`  
Mostra questo messaggio ed esce.

## Esempi
<a name="ref-sam-cli-remote-execution-history-examples"></a>

Ottieni la cronologia di esecuzione con il formato di tabella predefinito:

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

Ottieni la cronologia di esecuzione in formato 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>

Interrompi l'esecuzione di una funzione durevole in esecuzione in AWS Lambda.

L'ARN di esecuzione deve essere nel formato restituito StartDurableExecution o trovato nei log di esecuzione.

**Nota**  
Questo comando richiede l'accesso alle credenziali. AWS 

## Utilizzo
<a name="ref-sam-cli-remote-execution-stop-usage"></a>

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

## Argomenti richiesti
<a name="ref-sam-cli-remote-execution-stop-arguments"></a>

`DURABLE_EXECUTION_ARN`  
L'Amazon Resource Name (ARN) dell'esecuzione durevole della funzione da interrompere.

## Opzioni
<a name="ref-sam-cli-remote-execution-stop-options"></a>

`--error-message TEXT`  
Messaggio di errore da associare all'esecuzione interrotta.

`--error-type TEXT`  
Tipo di errore da associare all'esecuzione interrotta.

`--error-data TEXT`  
Dati di errore da associare all'esecuzione interrotta.

`--stack-trace TEXT`  
Immissioni di stack trace. Questa opzione può essere specificata più volte.

`--region TEXT`  
Imposta la AWS regione del servizio (ad esempio,`us-east-1`).

`--profile TEXT`  
Seleziona un profilo specifico dal tuo file di credenziali per ottenere le AWS credenziali.

`--config-env TEXT`  
Nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione. Impostazione predefinita: `default`

`--config-file TEXT`  
File di configurazione contenente i valori dei parametri predefiniti. Impostazione predefinita: `samconfig.toml`

`--save-params`  
Salva i parametri forniti tramite la riga di comando nel file di configurazione.

`--beta-features / --no-beta-features`  
Abilita/disabilita le funzionalità beta.

`--debug`  
Attiva la registrazione di debug per stampare i messaggi di debug generati dalla CLI e visualizzare i timestamp AWS SAM .

`-h, --help`  
Mostra questo messaggio ed esce.

## Esempi
<a name="ref-sam-cli-remote-execution-stop-examples"></a>

Interrompi l'esecuzione senza dettagli sull'errore:

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

Interrompi l'esecuzione con un messaggio di errore e digita:

```
$ 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"
```

Interrompi l'esecuzione con i dettagli completi dell'errore e la traccia dello stack:

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

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam remote invoke`.
+ Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Per la documentazione sull'uso del AWS SAMCLI `sam remote invoke` comando, vedere[Introduzione ai test nel cloud con sam remote invoke](using-sam-cli-remote-invoke.md).

Il `sam remote invoke` comando richiama le risorse supportate in. Cloud AWS

## Utilizzo
<a name="sam-cli-command-reference-remote-invoke-usage"></a>

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

## Arguments (Argomenti)
<a name="sam-cli-command-reference-remote-invoke-args"></a>

**Resource ID (ID risorsa)**  <a name="sam-cli-command-reference-remote-invoke-args-resource-id"></a>
L'ID della risorsa supportata da richiamare.  
Questo argomento accetta i seguenti valori:  
+ **Amazon Resource Name (ARN)**: l'ARN della risorsa.
**Suggerimento**  
`sam list stack-outputs --stack-name <stack-name>`Utilizzalo per ottenere l'ARN delle tue risorse.
+ **ID logico**: l'ID logico della risorsa. È inoltre necessario fornire il nome AWS CloudFormation dello stack utilizzando l'`--stack-name`opzione.
+ **ID fisico**: l'ID fisico della risorsa. Questo ID viene creato quando si distribuisce una risorsa utilizzando CloudFormation.
**Suggerimento**  
`sam list resources --stack-name <stack-name>`Utilizzalo per ottenere l'ID fisico delle tue risorse.  
**Quando fornisci un ARN o un ID fisico:**  
Se fornisci un ARN o un ID fisico, non fornire un nome dello stack. Quando il nome dello stack viene fornito utilizzando l'`--stack-name`opzione o quando il nome dello stack è definito nel file di configurazione, AWS SAM CLI elaborerà automaticamente l'ID della risorsa come valore ID logico dello stack. CloudFormation   
**Quando non fornisci un ID di risorsa:**  
Se non fornisci un ID di risorsa, ma fornisci un nome di stack con `--stack-name` l'opzione, la AWS SAM CLI tenterà di richiamare automaticamente una risorsa nello stack utilizzando CloudFormation la seguente logica:  

1.  AWS SAM CLIIdentificherà i tipi di risorse nell'ordine seguente e passerà alla fase successiva una volta trovato il tipo di risorsa nello stack:

   1. Lambda

   1. Step Functions

   1. Amazon SQS

   1. Flussi di dati Kinesis

1. Se il tipo di risorsa ha una sola risorsa nello stack, la AWS SAM CLI invocherà. Se nello stack sono presenti più risorse dello stesso tipo di risorsa, AWS SAM CLI verrà restituito un errore.
Di seguito sono riportati alcuni esempi di ciò che AWS SAM CLI farà:  
+ **Stack che contiene due funzioni Lambda e una coda Amazon SQS**: AWS SAM CLI individuerà il tipo di risorsa Lambda e restituirà un errore poiché lo stack contiene più di una funzione Lambda.
+ **Stack che contiene una funzione Lambda e due applicazioni Amazon Kinesis Data Streams** AWS SAM CLI: individuerà la funzione Lambda e la richiamerà poiché lo stack contiene una singola risorsa Lambda.
+ **Stack che contiene una singola coda Amazon SQS e due applicazioni Kinesis Data Streams**: AWS SAM CLI individuerà la coda Amazon SQS e la richiamerà poiché lo stack contiene un'unica coda Amazon SQS.

## Opzioni
<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>
Consenti o nega le funzionalità beta.

`--config-env TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-config-env"></a>
Specificate l'ambiente da utilizzare dal file AWS SAMCLI di configurazione.  
*Default*: `default`

`--config-file FILENAME`  <a name="sam-cli-command-reference-remote-invoke-options-config-file"></a>
Specificate il percorso e il nome del file di configurazione.  
Per ulteriori informazioni sui file di configurazione, consulta [Configurazione del AWS SAMCLI](using-sam-cli-configure.md).  
*Impostazione predefinita*: `samconfig.toml` nella radice della directory del progetto. 

`--debug`  <a name="sam-cli-command-reference-remote-invoke-options-debug"></a>
Attiva la registrazione di debug. Questo stampa i messaggi di debug e i timestamp generati da. AWS SAMCLI

`--event, -e TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-event"></a>
L'evento da inviare alla risorsa di destinazione.

`--event-file FILENAME`  <a name="sam-cli-command-reference-remote-invoke-options-event-file"></a>
Il percorso di un file che contiene l'evento da inviare alla risorsa di destinazione.

`--help, -h`  <a name="sam-cli-command-reference-remote-invoke-options-help"></a>
Mostra il messaggio di aiuto ed esci.

`--output [ text | json ]`  <a name="sam-cli-command-reference-remote-invoke-options-output"></a>
Visualizza i risultati della chiamata in un formato di output specifico.  
`json`— I metadati della richiesta e la risposta delle risorse vengono restituiti nella struttura JSON. La risposta contiene l'output SDK completo.  
`text`— I metadati della richiesta vengono restituiti nella struttura del testo. La risposta della risorsa viene restituita nel formato di output della risorsa richiamata.

`--parameter`  <a name="sam-cli-command-reference-remote-invoke-options-parameter"></a>
[https://boto3.amazonaws.com/v1/documentation/api/latest/index.html](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html)Parametri aggiuntivi che è possibile passare alla risorsa richiamata.    
**Flusso di dati Amazon Kinesis**  <a name="sam-cli-command-reference-remote-invoke-options-parameter-kinesis"></a>
I seguenti parametri aggiuntivi possono essere utilizzati per inserire un record nel flusso di dati Kinesis:  
+ `ExplicitHashKey='string'`
+ `PartitionKey='string'`
+ `SequenceNumberForOrdering='string'`
+ `StreamARN='string'`
Per una descrizione di ogni parametro, vedi [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>
I seguenti parametri aggiuntivi possono essere utilizzati per richiamare una risorsa Lambda e ricevere una risposta bufferizzata:  
+ `ClientContext='base64-encoded string'`
+ `InvocationType='[ DryRun | Event | RequestResponse ]'`
+ `LogType='[ None | Tail ]'`
+ `Qualifier='string'`
I seguenti parametri aggiuntivi possono essere utilizzati per richiamare una risorsa Lambda con streaming di risposte:  
+ `ClientContext='base64-encoded string'`
+ `InvocationType='[ DryRun | RequestResponse ]'`
+ `LogType='[ None | Tail ]'`
+ `Qualifier='string'`
Per una descrizione di ogni parametro, consulta quanto segue:  
+ [Lambda con risposta bufferizzata — lambda.client.Invoke](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/lambda/client/invoke.html)
+ [Lambda con streaming di risposte — 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>
I seguenti parametri aggiuntivi possono essere utilizzati per inviare un messaggio a una coda Amazon SQS:  
+ `DelaySeconds=integer`
+ `MessageAttributes='json string'`
+ `MessageDeduplicationId='string'`
+ `MessageGroupId='string'`
+ `MessageSystemAttributes='json string'`
[Per una descrizione di ogni parametro, consulta 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>
I seguenti parametri aggiuntivi possono essere utilizzati per avviare l'esecuzione di una macchina a stati:  
+ `name='string'`
+ `traceHeader='string'`
Per una descrizione di ogni parametro, vedere [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>
Il profilo specifico del file di credenziali per ottenere le credenziali. AWS 

`--region TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-region"></a>
La Regione AWS risorsa. Ad esempio, `us-east-1`.

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-stack-name"></a>
Il nome dello CloudFormation stack a cui appartiene la risorsa.

`--tenant-id TEXT`  <a name="ref-sam-cli-local-invoke-options-tenancyconfig"></a>
L'ID tenant per le funzioni Lambda multi-tenant. Utilizzato per garantire l'isolamento del calcolo tra diversi tenant. Richiesto quando si richiamano funzioni configurate con la modalità di isolamento dei tenant.

`--test-event-name NAME`  <a name="sam-cli-command-reference-remote-invoke-options-test-event-name"></a>
Il nome dell'evento di test condivisibile da passare alla funzione Lambda.  
Questa opzione supporta solo le funzioni Lambda.

## Esempio
<a name="sam-cli-command-reference-remote-invoke-examples"></a>

L'esempio seguente richiama le risorse supportate nel AWS Cloud e attiva la registrazione di debug, che stampa i messaggi di debug e i timestamp generati da: AWS SAMCLI

```
$ sam remote invoke--debug
```

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

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam remote test-event`.
+ Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Per la documentazione sull'uso del AWS SAMCLI `sam remote test-event` comando, vedere[Introduzione al cloud testing con sam remote test-event](using-sam-cli-remote-test-event.md).

Il `sam remote test-event` comando interagisce con eventi di test condivisibili nel registro degli EventBridge schemi di Amazon.

## Utilizzo
<a name="sam-cli-command-reference-remote-test-event-usage"></a>

```
$ sam remote test-event <options> <subcommand>
```

## Opzioni
<a name="sam-cli-command-reference-remote-test-event-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-remote-invoke-options-help"></a>
Mostra il messaggio di aiuto ed esci.

## Sottocomandi
<a name="sam-cli-command-reference-remote-test-event-subcommands"></a>

`delete`  
Elimina un evento di test condivisibile dal registro dello EventBridge schema. Per ulteriori informazioni di riferimento, vedere[sam remote test-event delete](sam-cli-command-reference-remote-test-event-delete.md).

`get`  
Ottieni un evento di test condivisibile dal registro degli EventBridge schemi. Per ulteriori informazioni di riferimento, vedere[sam remote test-event get](sam-cli-command-reference-remote-test-event-get.md).

`list`  
Elenca gli eventi di test condivisibili esistenti per una AWS Lambda funzione. Per ulteriori informazioni di riferimento, vedere[sam remote test-event list](sam-cli-command-reference-remote-test-event-list.md).

`put`  
Salvare un evento da un file locale nel registro dello EventBridge schema. Per ulteriori informazioni di riferimento, vedere[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>

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model `sam remote test-event delete` sottocomando Command Line Interface (AWS SAMCLI).
+ Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Per la documentazione sull'uso del AWS SAMCLI `sam remote test-event` comando, vedere[Introduzione al cloud testing con sam remote test-event](using-sam-cli-remote-test-event.md).

Il `sam remote test-event delete` sottocomando elimina un evento di test condivisibile dal registro degli schemi di Amazon EventBridge .

## Utilizzo
<a name="sam-cli-command-reference-remote-test-event-delete-usage"></a>

```
$ sam remote test-event delete <arguments> <options>
```

## Arguments (Argomenti)
<a name="sam-cli-command-reference-remote-test-event-delete-args"></a>

**Resource ID (ID risorsa)**  <a name="sam-cli-command-reference-remote-test-event-delete-args-resource-id"></a>
L'ID della AWS Lambda funzione associata all'evento di test condivisibile.  
Se si fornisce un ID logico, è necessario fornire anche un valore per lo AWS CloudFormation stack associato alla funzione Lambda utilizzando `--stack-name` l'opzione.  
*Valori validi*: l'ID o la risorsa logico della risorsa. ARN

## Opzioni
<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>
Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare. Il valore predefinito è «default». Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-remote-test-event-delete-options-config-file"></a>
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare. Il valore predefinito è "`samconfig.toml`" nella radice della directory del progetto. Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--help, -h`  <a name="sam-cli-command-reference-remote-test-event-delete-options-help"></a>
Mostra il messaggio di aiuto ed esci.

`--name TEXT`  <a name="sam-cli-command-reference-remote-test-event-delete-options-name"></a>
Il nome dell'evento di test condivisibile da eliminare.

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-test-event-delete-options-stack-name"></a>
Il nome dello CloudFormation stack associato alla funzione Lambda.  
Questa opzione è obbligatoria se si fornisce l'ID logico della funzione Lambda come argomento.

# sam remote test-event get
<a name="sam-cli-command-reference-remote-test-event-get"></a>

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model `sam remote test-event get` sottocomando Command Line Interface (AWS SAMCLI).
+ Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Per la documentazione sull'uso del AWS SAMCLI `sam remote test-event` comando, vedere[Introduzione al cloud testing con sam remote test-event](using-sam-cli-remote-test-event.md).

Il `sam remote test-event get` sottocomando ottiene un evento di test condivisibile dal registro degli EventBridge schemi di Amazon.

## Utilizzo
<a name="sam-cli-command-reference-remote-test-event-get-usage"></a>

```
$ sam remote test-event get <arguments> <options>
```

## Arguments (Argomenti)
<a name="sam-cli-command-reference-remote-test-event-get-args"></a>

**Resource ID (ID risorsa)**  <a name="sam-cli-command-reference-remote-test-event-get-args-resource-id"></a>
L'ID della AWS Lambda funzione associata all'evento di test condivisibile da ottenere.  
Se si fornisce un ID logico, è necessario fornire anche un valore per lo AWS CloudFormation stack associato alla funzione Lambda utilizzando `--stack-name` l'opzione.  
*Valori validi*: l'ID o la risorsa logico della risorsa. ARN

## Opzioni
<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>
Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare. Il valore predefinito è «default». Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-remote-test-event-get-options-config-file"></a>
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare. Il valore predefinito è "`samconfig.toml`" nella radice della directory del progetto. Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--help, -h`  <a name="sam-cli-command-reference-remote-test-event-get-options-help"></a>
Mostra il messaggio di aiuto ed esci.

`--name TEXT`  <a name="sam-cli-command-reference-remote-test-event-get-options-name"></a>
Il nome dell'evento di test condivisibile da ottenere.

`--output-file FILENAME`  <a name="sam-cli-command-reference-remote-test-event-get-options-output-file"></a>
Il percorso e il nome del file in cui salvare l'evento sul computer locale.  
Se non fornisci questa opzione, AWS SAM CLI invierà il contenuto dell'evento di test condivisibile sulla tua console.

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-test-event-get-options-stack-name"></a>
Il nome dello CloudFormation stack associato alla funzione Lambda.  
Questa opzione è obbligatoria se si fornisce l'ID logico della funzione Lambda come argomento.

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

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model `sam remote test-event list` sottocomando Command Line Interface (AWS SAMCLI).
+ Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Per la documentazione sull'uso del AWS SAMCLI `sam remote test-event` comando, vedere[Introduzione al cloud testing con sam remote test-event](using-sam-cli-remote-test-event.md).

Il `sam remote test-event list` sottocomando elenca gli eventi di test condivisibili esistenti per una AWS Lambda funzione specifica dal registro degli EventBridge schemi di Amazon.

## Utilizzo
<a name="sam-cli-command-reference-remote-test-event-list-usage"></a>

```
$ sam remote test-event list <arguments> <options>
```

## Arguments (Argomenti)
<a name="sam-cli-command-reference-remote-test-event-list-args"></a>

**Resource ID (ID risorsa)**  <a name="sam-cli-command-reference-remote-test-event-list-args-resource-id"></a>
L'ID della funzione Lambda associata agli eventi di test condivisibili.  
Se si fornisce un ID logico, è necessario fornire anche un valore per lo AWS CloudFormation stack associato alla funzione Lambda utilizzando `--stack-name` l'opzione.  
*Valori validi*: l'ID o la risorsa logico della risorsa. ARN

## Opzioni
<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>
Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare. Il valore predefinito è «default». Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-remote-test-event-list-options-config-file"></a>
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare. Il valore predefinito è "`samconfig.toml`" nella radice della directory del progetto. Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--help, -h`  <a name="sam-cli-command-reference-remote-test-event-list-options-help"></a>
Mostra il messaggio di aiuto ed esci.

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-test-event-list-options-stack-name"></a>
Il nome dello CloudFormation stack associato alla funzione Lambda.  
Questa opzione è obbligatoria se si fornisce l'ID logico della funzione Lambda come argomento.

## Esempi
<a name="sam-cli-command-reference-remote-test-event-list-examples"></a>

Per esempi sull'utilizzo di questo comando, fare riferimento a[Elenco degli eventi di test condivisibili](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>

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model `sam remote test-event put` sottocomando Command Line Interface (AWS SAMCLI).
+ Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Per la documentazione sull'uso del AWS SAMCLI `sam remote test-event` comando, vedere[Introduzione al cloud testing con sam remote test-event](using-sam-cli-remote-test-event.md).

Il `sam remote test-event put` sottocomando salva un evento di test condivisibile dal computer locale nel registro degli EventBridge schemi Amazon.

## Utilizzo
<a name="sam-cli-command-reference-remote-test-event-put-usage"></a>

```
$ sam remote test-event put <arguments> <options>
```

## Arguments (Argomenti)
<a name="sam-cli-command-reference-remote-test-event-put-args"></a>

**Resource ID (ID risorsa)**  <a name="sam-cli-command-reference-remote-test-event-put-args-resource-id"></a>
L'ID della AWS Lambda funzione associata all'evento di test condivisibile.  
Se si fornisce un ID logico, è necessario fornire anche un valore per lo AWS CloudFormation stack associato alla funzione Lambda utilizzando `--stack-name` l'opzione.  
*Valori validi*: l'ID o la risorsa logico della risorsa. ARN

## Opzioni
<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>
Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare. Il valore predefinito è «default». Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-remote-test-event-put-options-config-file"></a>
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare. Il valore predefinito è "`samconfig.toml`" nella radice della directory del progetto. Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--file FILENAME`  <a name="sam-cli-command-reference-remote-test-event-put-options-file"></a>
Il percorso del file e il nome dell'evento sul computer locale.  
Fornisci `-` come nome del file il valore da cui leggere`stdin`.  
Questa opzione è obbligatoria.

`--force`, `-f`  <a name="sam-cli-command-reference-remote-test-event-put-options-force"></a>
Sovrascrivi un evento di test condivisibile con lo stesso nome.

`--help, -h`  <a name="sam-cli-command-reference-remote-test-event-put-options-help"></a>
Mostra il messaggio di aiuto ed esci.

`--name TEXT`  <a name="sam-cli-command-reference-remote-test-event-put-options-name"></a>
Il nome con cui salvare l'evento di test condivisibile.  
Se nel registro dello EventBridge schema esiste un evento di test condivisibile con lo stesso nome, non lo AWS SAM CLI sovrascriverà. Per sovrascrivere, aggiungi l'opzione. `--force`

`--output-file FILENAME`  <a name="sam-cli-command-reference-remote-test-event-put-options-output-file"></a>
Il percorso e il nome del file in cui salvare l'evento sul computer locale.  
Se non fornisci questa opzione, AWS SAM CLI invierà il contenuto dell'evento di test condivisibile sulla tua console.

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-test-event-put-options-stack-name"></a>
Il nome dello CloudFormation stack associato alla funzione Lambda.  
Questa opzione è obbligatoria se si fornisce l'ID logico della funzione Lambda come argomento.

## Esempio
<a name="sam-cli-command-reference-remote-test-event-put-examples"></a>

Per un esempio sull'utilizzo di questo comando, fare riferimento a[Salvataggio di eventi di test condivisibili](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>

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam sync`.
+ Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Per la documentazione sull'utilizzo di AWS SAMCLI, vedere[AWS SAM CLI](using-sam-cli.md).

Il `sam sync` comando sincronizza le modifiche dell'applicazione locale con. Cloud AWS

## Utilizzo
<a name="sam-cli-command-reference-sam-sync-usage"></a>

```
$ sam sync <options>
```

## Opzioni
<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>
Risolve i percorsi relativi al codice sorgente della funzione o del livello rispetto a questa directory. Utilizzate questa opzione per modificare il modo in cui vengono risolti i percorsi relativi alle cartelle del codice sorgente. Per impostazione predefinita, i percorsi relativi vengono risolti rispetto alla posizione del AWS SAM modello.  
Oltre alle risorse nell'applicazione root o nello stack che stai creando, questa opzione si applica anche alle applicazioni o agli stack annidati. Inoltre, questa opzione si applica ai seguenti tipi e proprietà di risorse:  
+ Tipo di risorsa: `AWS::Serverless::Function` Proprietà: `CodeUri`
+ Tipo di risorsa: Attributo della `AWS::Serverless::Function` risorsa: `Metadata` Voce: `DockerContext`
+ Tipo di risorsa: `AWS::Serverless::LayerVersion` Proprietà: `ContentUri`
+ Tipo di risorsa: `AWS::Lambda::Function` Proprietà: `Code`
+ Tipo di risorsa: `AWS::Lambda::LayerVersion` Proprietà: `Content`

`--build-image TEXT`  <a name="sam-cli-command-reference-sam-sync-options-build-image"></a>
L'URI per l'[immagine del contenitore](serverless-image-repositories.md#serverless-image-repository-uris) che desideri utilizzare durante la creazione dell'applicazione. Per impostazione predefinita, AWS SAM utilizza l'URI del repository di immagini del contenitore di [Amazon Elastic Container Registry (Amazon ECR) Public](https://docs.aws.amazon.com/AmazonECR/latest/public/what-is-ecr.html). Specificate questa opzione per utilizzare un'immagine diversa.  
È possibile utilizzare questa opzione più volte in un unico comando. Ogni opzione accetta una stringa o una coppia chiave-valore.  
+ **Stringa**: specifica l'URI dell'immagine del contenitore che verranno utilizzate da tutte le risorse dell'applicazione. Di seguito è riportato un esempio:

  ```
  $ sam sync --build-image amazon/aws-sam-cli-build-image-python3.8
  ```
+ **Coppia chiave-valore**: specifica il nome della risorsa come chiave e l'URI dell'immagine del contenitore da utilizzare con quella risorsa come valore. Utilizzate questo formato per specificare un URI di immagine del contenitore diverso per ogni risorsa dell'applicazione. Di seguito è riportato un esempio:

  ```
  $ sam sync --build-image Function1=amazon/aws-sam-cli-build-image-python3.8
  ```
Questa opzione si applica solo se l'`--use-container`opzione è specificata, altrimenti si verificherà un errore.

`--build-in-source | --no-build-in-source`  <a name="sam-cli-command-reference-sam-sync-options-build-in-source"></a>
Fornisce `--build-in-source` la possibilità di creare il progetto direttamente nella cartella dei sorgenti.  
L'`--build-in-source`opzione supporta i seguenti runtime e metodi di compilazione:  
+ **Runtime**: qualsiasi Node.js runtime supportato dall'`sam init --runtime`opzione.
+ **Metodi di compilazione**:`Makefile`,`esbuild`.
L'`--build-in-source`opzione non è compatibile con le seguenti opzioni:  
+ `--use-container `
*Default*: `--no-build-in-source`

`--capabilities LIST`  <a name="sam-cli-command-reference-sam-sync-options-capabilities"></a>
Un elenco di funzionalità specificate per consentire la creazione CloudFormation di determinati stack. Alcuni modelli di stack potrebbero includere risorse che possono influire sulle autorizzazioni del tuo. Account AWS Ad esempio, creando nuovi utenti AWS Identity and Access Management (IAM). Specificate questa opzione per sovrascrivere i valori predefiniti. I valori validi includono quanto segue:  
+ CAPABILITY\$1IAM
+ CAPABILITY\$1NAMED\$1IAM
+ POLITICA DELLE RISORSE IN MATERIA DI CAPACITÀ
+ CAPABILITY\$1AUTO\$1EXPAND
*Predefinito: e* `CAPABILITY_NAMED_IAM` `CAPABILITY_AUTO_EXPAND`

`--code`  <a name="sam-cli-command-reference-sam-sync-options-code"></a>
Per impostazione predefinita, AWS SAM sincronizza tutte le risorse dell'applicazione. Specificate questa opzione per sincronizzare solo le risorse di codice, che includono quanto segue:  
+ `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`
Per sincronizzare le risorse di codice, AWS SAM utilizza APIs direttamente il AWS servizio, anziché distribuirlo tramite AWS CloudFormation. Per aggiornare il tuo CloudFormation stack, **sam sync --watch** esegui o. **sam deploy**

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-sync-options-config-env"></a>
Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare. Il valore predefinito è «default». Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-sync-options-config-file"></a>
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare. Il valore predefinito è "`samconfig.toml`" nella radice della directory del progetto. Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--dependency-layer | --no-dependency-layer`  <a name="sam-cli-command-reference-sam-sync-options-dependency-layer"></a>
Speciifica se separare le dipendenze delle singole funzioni in un altro livello per accelerare il processo di sincronizzazione.  
*Default*: `--dependency-layer`

`--image-repository TEXT`  <a name="sam-cli-command-reference-sam-sync-options-image-repository"></a>
Il nome del repository Amazon Elastic Container Registry (Amazon ECR) in cui questo comando carica l'immagine della funzione. Obbligatorio per le funzioni dichiarate con il `Image` tipo di pacchetto.

`--image-repositories TEXT`  <a name="sam-cli-command-reference-sam-sync-options-image-repositories"></a>
Una mappatura delle funzioni sull'URI del loro repository Amazon ECR. Funzioni di riferimento in base al relativo ID logico. Di seguito è riportato un esempio:  

```
$ sam sync --image-repositories Function1=123456789012.dkr.ecr.us-east-1.amazonaws.com/my-repo
```
È possibile specificare questa opzione più volte in un unico comando.

`--kms-key-id TEXT`  <a name="sam-cli-command-reference-sam-sync-options-kms-key-id"></a>
L'ID di una chiave AWS Key Management Service (AWS KMS) utilizzata per crittografare gli artefatti che sono a riposo nel bucket Amazon S3. Se non specifichi questa opzione, AWS SAM utilizza le chiavi di crittografia gestite da Amazon S3.

`--metadata`  <a name="sam-cli-command-reference-sam-sync-options-metadata"></a>
Una mappa di metadati da allegare a tutti gli artefatti a cui fai riferimento nel modello.

`--notification-arns LIST`  <a name="sam-cli-command-reference-sam-sync-options-notification-arns"></a>
Un elenco di ARNs argomenti relativi a Amazon Simple Notification Service (Amazon SNS) associati allo CloudFormation stack.

`--no-use-container`  <a name="ref-sam-cli-sync-options-no-use-container"></a>
Un'opzione che consente di utilizzare il toolkit IDE per impostare il comportamento predefinito.

`--parameter-overrides`  <a name="sam-cli-command-reference-sam-sync-options-parameter-overrides"></a>
Una stringa che contiene le sostituzioni CloudFormation dei parametri codificate come coppie chiave-valore. Utilizzate lo stesso formato di (). AWS Command Line Interface AWS CLI Il AWS SAMCLI formato è costituito da parole chiave e valori esplicite, ogni override è separata da uno spazio. Di seguito, sono riportati due esempi:  
+ `--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>
Speciifica il tipo di risorsa da sincronizzare. Per sincronizzare più risorse, è possibile specificare questa opzione più volte. Questa opzione è supportata dall'`--code`opzione. Il valore deve essere una delle risorse elencate sotto`--code`. Ad esempio, `--resource AWS::Serverless::Function --resource AWS::Serverless::LayerVersion`.

`--resource-id TEXT`  <a name="sam-cli-command-reference-sam-sync-options-resource-id"></a>
Speciifica l'ID della risorsa da sincronizzare. Per sincronizzare più risorse, è possibile specificare questa opzione più volte. Questa opzione è supportata dall'`--code`opzione. Ad esempio, `--resource-id Function1 --resource-id Function2`.

`--role-arn TEXT`  <a name="sam-cli-command-reference-sam-sync-options-role-arn"></a>
L'Amazon Resource Name (ARN) di un ruolo IAM che CloudFormation assume quando si applica il changeset.

`--s3-bucket TEXT`  <a name="sam-cli-command-reference-sam-sync-options-s3-bucket"></a>
Il nome del bucket Amazon Simple Storage Service (Amazon S3) in cui questo comando carica il modello. CloudFormation Se il modello è più grande di 51.200 byte, è richiesta l'opzione o l'`--s3-bucket`opzione. `--resolve-s3` Se si specificano entrambe le `--resolve-s3` opzioni `--s3-bucket` e, si verifica un errore.

`--s3-prefix TEXT`  <a name="sam-cli-command-reference-sam-sync-options-s3-prefix"></a>
Il prefisso aggiunto ai nomi degli artefatti caricati nel bucket Amazon S3. Il nome del prefisso è un nome di percorso (nome della cartella) per il bucket Amazon S3. Questo vale solo per le funzioni dichiarate con il `Zip` tipo di pacchetto.

`--save-params`  <a name="sam-cli-command-reference-sam-sync-options-save-params"></a>
Salva i parametri forniti dalla riga di comando nel file AWS SAM di configurazione.

`--skip-deploy-sync | --no-skip-deploy-sync`  <a name="sam-cli-command-reference-sam-sync-options-skip-deploy-sync"></a>
Specifica `--skip-deploy-sync` di saltare la sincronizzazione iniziale dell'infrastruttura se non è richiesta. AWS SAMCLIConfronterà il AWS SAM modello locale con il CloudFormation modello distribuito ed eseguirà una distribuzione solo se viene rilevata una modifica.  
Specifica `--no-skip-deploy-sync` di eseguire una CloudFormation distribuzione ogni volta che `sam sync` viene eseguita.  
Per ulteriori informazioni, consulta [Salta la distribuzione iniziale CloudFormation](using-sam-cli-sync.md#using-sam-cli-sync-options-skip-deploy-sync).  
*Default*: `--skip-deploy-sync`

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-sync-options-stack-name"></a>
Il nome dello CloudFormation stack per l'applicazione.  
Questa opzione è obbligatoria.

`--tags LIST`  <a name="sam-cli-command-reference-sam-sync-options-tags"></a>
Un elenco di tag da associare allo stack creato o aggiornato. CloudFormation propaga inoltre questi tag alle risorse dello stack che li supportano.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-sync-options-template-file"></a>
Il percorso e il nome del file in cui si trova il AWS SAM modello.  
Se si specifica questa opzione, AWS SAM distribuisce solo il modello e le risorse locali a cui punta.

`--use-container, -u`  <a name="sam-cli-command-reference-sam-sync-options-use-container"></a>
Se le tue funzioni dipendono da pacchetti che hanno dipendenze compilate in modo nativo, usa questa opzione per creare la tua funzione all'interno di un AWS Lambda contenitore simile a -like. Docker  
Attualmente, questa opzione non è compatibile con. `--dependency-layer` Se usi `--use-container` con`--dependency-layer`, ti AWS SAMCLI informa e continua con`--no-dependency-layer`.

`--watch`  <a name="sam-cli-command-reference-sam-sync-options-watch"></a>
Avvia un processo che controlla le modifiche apportate all'applicazione locale e le sincronizza automaticamente con. Cloud AWS Per impostazione predefinita, quando si specifica questa opzione, AWS SAM sincronizza tutte le risorse dell'applicazione durante l'aggiornamento. Con questa opzione, AWS SAM esegue una CloudFormation distribuzione iniziale. Quindi, AWS SAM utilizza il AWS servizio APIs per aggiornare le risorse del codice. AWS SAM utilizza CloudFormation per aggiornare le risorse dell'infrastruttura quando si aggiorna il AWS SAM modello.

`--watch-exclude TEXT`  <a name="sam-cli-command-reference-sam-sync-options-watch-exclude"></a>
Esclude un file o una cartella dall'osservazione delle modifiche apportate ai file. Per utilizzare questa opzione, è `--watch` necessario fornire anche questa opzione.  
Questa opzione riceve una coppia chiave-valore:  
+ **Chiave**: l'ID logico di una funzione Lambda nell'applicazione.
+ **Valore**: il nome o la cartella del file associato da escludere.
Quando si aggiornano i file o le cartelle specificati con l'`--watch-exclude`opzione, AWS SAM CLI la sincronizzazione non viene avviata. Tuttavia, quando un aggiornamento ad altri file o cartelle avvia una sincronizzazione, tali file o cartelle verranno inclusi in tale sincronizzazione.  
È possibile fornire questa opzione più volte in un unico comando.

## Esempi
<a name="sam-cli-command-reference-sam-sync-examples"></a>

Per esempi sull'utilizzo di questo comando, fare riferimento a[Opzioni per il comando sam sync](using-sam-cli-sync.md#using-sam-cli-sync-options).

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

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam traces`.

Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Il `sam traces` comando recupera AWS X-Ray le tracce presenti Account AWS nel Regione AWS file.

## Utilizzo
<a name="sam-cli-command-reference-sam-traces-usage"></a>

```
$ sam traces <options>
```

## Opzioni
<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>
Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare. Il valore predefinito è «default». Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-traces-options-config-file"></a>
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare. Il valore predefinito è "`samconfig.toml`" nella radice della directory del progetto. Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--end-time TEXT`  <a name="sam-cli-command-reference-sam-traces-options-end-time"></a>
Recupera le tracce fino a questo momento. L'ora può essere costituita da valori relativi come «5 minuti fa», «domani» o un timestamp formattato come «2018-01-01 10:10:10».

`--output TEXT`  <a name="sam-cli-command-reference-sam-traces-options-output"></a>
Specificate il formato di output per i log. Per stampare registri formattati, specificare. `text` Per stampare i log come JSON, specificare. `json`

`--save-params`  <a name="sam-cli-command-reference-sam-traces-options-save-params"></a>
Salva i parametri forniti nella riga di comando nel AWS SAM file di configurazione.

`--start-time TEXT`  <a name="sam-cli-command-reference-sam-traces-options-start-time"></a>
Recupera le tracce a partire da questo momento. L'ora può essere costituita da valori relativi come «5 minuti fa», «ieri» o un timestamp formattato come «2018-01-01 10:10:10». Il valore predefinito è «10 minuti fa».

`--tail`  <a name="sam-cli-command-reference-sam-traces-options-tail"></a>
Copia l'output della traccia. Questo ignora l'argomento dell'ora di fine e continua a visualizzare le tracce non appena diventano disponibili.

`--trace-id TEXT`  <a name="sam-cli-command-reference-sam-traces-options-trace-id"></a>
L'identificatore univoco per una traccia a raggi X.

## Esempi
<a name="sam-cli-command-reference-sam-traces-examples"></a>

Esegui il seguente comando per recuperare le tracce X-Ray per ID.

```
$ sam traces --trace-id tracing-id-1 --trace-id tracing-id-2
```

Eseguite il seguente comando per seguire le tracce X-Ray non appena diventano disponibili.

```
$ sam traces --tail
```

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

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam validate`.

Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Il `sam validate` comando verifica se un file AWS SAM modello è valido.

## Utilizzo
<a name="sam-cli-command-reference-sam-validate-usage"></a>

```
$ sam validate <options>
```

## Opzioni
<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>
Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare. Il valore predefinito è «default». Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-validate-options-config-file"></a>
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare. Il valore predefinito è «samconfig.toml» nella radice della directory del progetto. Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-validate-options-debug"></a>
Attiva la registrazione di debug per stampare il messaggio di debug generato dai timestamp e visualizzarli. AWS SAMCLI

`--lint`  <a name="sam-cli-command-reference-sam-validate-options-lint"></a>
 Esegui la convalida del linting sul modello tramite. **cfn-lint** Crea un file di `cfnlintrc` configurazione per specificare parametri aggiuntivi. *Per ulteriori informazioni, vedere [cfn-lint](https://github.com/aws-cloudformation/cfn-lint) nel repository.CloudFormation GitHub * 

`--profile TEXT`  <a name="sam-cli-command-reference-sam-validate-options-profile"></a>
Il profilo specifico del file delle credenziali che ottiene le credenziali. AWS 

`--region TEXT`  <a name="sam-cli-command-reference-sam-validate-options-region"></a>
La AWS regione in cui effettuare la distribuzione. Ad esempio, us-east-1.

`--save-params`  <a name="sam-cli-command-reference-sam-validate-options-save-params"></a>
Salva i parametri forniti dalla riga di comando nel file di AWS SAM configurazione.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-validate-options-template-file"></a>
 Il file AWS SAM modello. Il valore predefinito è `template.[yaml|yml]`.   
 Se il modello si trova nella directory di lavoro corrente ed è denominato`template.[yaml|yml|json]`, questa opzione non è richiesta.   
 Se l'hai appena eseguito**sam build**, questa opzione non è richiesta. 

## Esempio
<a name="sam-cli-command-reference-sam-validate-examples"></a>

Per un esempio sull'utilizzo di questo comando per convalidare un modello, fare riferimento a. [Convalida dei file AWS SAM modello](serverless-sam-cli-using-validate.md)

Per un esempio sull'utilizzo di questo comando con cfn-lint, fare riferimento a. [Convalida le tue AWS SAM applicazioni con CloudFormation Linter](validate-cfn-lint.md)

# AWS SAMCLIgestione
<a name="reference-sam-cli"></a>

Questa sezione contiene informazioni sui modi in cui è possibile gestire e personalizzare la versione di. AWS SAMCLI Ciò include informazioni su come configurare i valori dei parametri dei AWS SAMCLI comandi utilizzando un file di configurazione a livello di progetto. Include anche informazioni sulla gestione delle diverse versioni del file AWS SAMCLI, sull'impostazione delle AWS credenziali in modo da AWS SAM poter effettuare chiamate ai AWS servizi per conto dell'utente e su diversi modi di personalizzazione. AWS SAM Questa sezione termina con una sezione sulla AWS SAM risoluzione dei problemi generali.

**Topics**
+ [

# AWS SAMCLIfile di configurazione
](serverless-sam-cli-config.md)
+ [

# Gestione delle AWS SAMCLI versioni
](manage-sam-cli-versions.md)
+ [

# Impostazione delle AWS credenziali
](serverless-getting-started-set-up-credentials.md)
+ [

# Telemetria nel AWS SAMCLI
](serverless-sam-telemetry.md)
+ [

# AWS SAMCLIrisoluzione dei problemi
](sam-cli-troubleshooting.md)

# AWS SAMCLIfile di configurazione
<a name="serverless-sam-cli-config"></a>

La AWS Serverless Application Model Command Line Interface (AWS SAMCLI) supporta un file di configurazione a livello di progetto che è possibile utilizzare per configurare i valori dei parametri di AWS SAMCLI comando.

Per la documentazione sulla creazione e l'utilizzo dei file di configurazione, vedere. [Configurazione del AWS SAMCLI](using-sam-cli-configure.md)

**Topics**
+ [

## Impostazioni predefinite del file di configurazione
](#serverless-sam-cli-config-default)
+ [

## Formati di file di configurazione supportati
](#serverless-sam-cli-config-formats)
+ [

## Specificare un file di configurazione
](#serverless-sam-cli-config-specify)
+ [

## Nozioni di base sui file di configurazione
](#serverless-sam-cli-config-basics)
+ [

## Regole relative al valore dei parametri
](#serverless-sam-cli-config-rules)
+ [

## Precedenza di configurazione
](#serverless-sam-cli-config-precedence)
+ [

## Creazione e modifica dei file di configurazione
](#serverless-sam-cli-config-using)

## Impostazioni predefinite del file di configurazione
<a name="serverless-sam-cli-config-default"></a>

AWS SAM utilizza le seguenti impostazioni predefinite del file di configurazione:
+ **Nome**: `samconfig`.
+ **Posizione**: alla base del progetto. Questa è la stessa posizione `template.yaml` del file.
+ **Formato**:`TOML`. Per saperne di più, consulta [TOML](https://toml.io/en/) nella *TOMLdocumentazione*.

Di seguito è riportato un esempio di struttura di progetto che include il nome e la posizione del file di configurazione predefiniti:

```
sam-app
├── README.md
├── __init__.py
├── events
├── hello_world
├── samconfig.toml
├── template.yaml
└── tests
```

Di seguito è riportato un esempio del file `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
```

## Formati di file di configurazione supportati
<a name="serverless-sam-cli-config-formats"></a>

`TOML`e i `[YAML|YML]` formati sono supportati. Vedi la seguente sintassi di base:

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

## Specificare un file di configurazione
<a name="serverless-sam-cli-config-specify"></a>

Per impostazione predefinita, AWS SAMCLI cerca un file di configurazione nell'ordine seguente:

1. **File di configurazione personalizzato**: se si utilizza l'`--config-file`opzione per specificare il nome e la posizione di un file, AWS SAMCLI cerca prima questo file.

1. **`samconfig.toml`File predefinito**: si tratta del nome e del formato del file di configurazione predefiniti, che si trova alla radice del progetto. Se non specifichi un file di configurazione personalizzato, AWS SAMCLI cerca successivamente questo file.

1. **`samconfig.[yaml|yml]`file** — Se `samconfig.toml` non esiste nella radice del progetto, AWS SAMCLI cerca questo file.

Di seguito è riportato un esempio di specificazione di un file di configurazione personalizzato utilizzando l'`--config-file`opzione:

```
$ sam deploy --config-file myconfig.yaml
```

**Nota**  
Il `--config-file` parametro deve essere relativo alla posizione del file AWS SAM modello perché AWS SAMCLI deve determinare il contesto in cui viene applicata la configurazione. Il `samconfig.toml` file gestisce le impostazioni di configurazione per la versione in AWS SAMCLI uso di e la CLI cerca il `samconfig.toml` file (o il parametro del file di configurazione sovrascritto) nella cartella relativa del file. `template.yaml`

## Nozioni di base sui file di configurazione
<a name="serverless-sam-cli-config-basics"></a>

### Ambiente
<a name="serverless-sam-cli-config-basics-environment"></a>

Un **ambiente** è un identificatore denominato che contiene un set unico di impostazioni di configurazione. È possibile avere più ambienti in una singola AWS SAM applicazione.

Il nome dell'ambiente predefinito è`default`.

Utilizzate l' AWS SAMCLI`--config-env`opzione per specificare l'ambiente da utilizzare.

### Comando
<a name="serverless-sam-cli-config-basics-command"></a>

Il **comando** è il AWS SAMCLI comando per cui specificare i valori dei parametri.

Per specificare i valori dei parametri per tutti i comandi, utilizzate l'`global`identificatore.

Quando fate riferimento a un AWS SAMCLI comando, sostituite gli spazi (` `) e i trattini () con caratteri di sottolineatura (`–`). `_` Fare riferimento agli esempi riportati di seguito:
+ `build`
+ `local_invoke`
+ `local_start_api`

### Parameters
<a name="serverless-sam-cli-config-basics-parameters"></a>

**I parametri** sono specificati come coppie chiave-valore.
+ La **chiave** è il nome dell'opzione AWS SAMCLI di comando.
+ Il **valore** è il valore da specificare.

Quando specificate le chiavi, utilizzate l'opzione di comando in formato lungo name e sostituite i trattini (`–`) con caratteri di sottolineatura (). `_` Di seguito vengono mostrati gli esempi:
+ `region`
+ `stack_name`
+ `template_file`

## Regole relative al valore dei parametri
<a name="serverless-sam-cli-config-rules"></a>

### TOML
<a name="serverless-sam-cli-config-rules-toml"></a>
+ I valori booleani possono essere `true` o. `false` Ad esempio, `confirm_changeset = true`.
+ Per i valori di stringa, utilizzare le virgolette (). `""` Ad esempio, `region = "us-west-2"`.
+ Per i valori degli elenchi, utilizzate le virgolette (`""`) e separate ogni valore utilizzando uno spazio (` `). Ad esempio: `capabilities = "CAPABILITY_IAM CAPABILITY_NAMED_IAM"`.
+ Per i valori che contengono un elenco di coppie chiave-valore, le coppie sono delimitate da spazi (` `) e il valore di ciascuna coppia è racchiuso tra virgolette codificate (). `\" \"` Ad esempio, `tags = "project=\"my-application\" stage=\"production\""`.
+ Per i valori dei parametri che possono essere specificati più volte, il valore è una matrice di argomenti. Ad esempio: `image_repositories = ["my-function-1=image-repo-1", "my-function-2=image-repo-2"]`.

### YAML
<a name="serverless-sam-cli-config-rules-yaml"></a>
+ I valori booleani possono essere `true` o. `false` Ad esempio, `confirm_changeset: true`.
+ Per le voci che contengono un solo valore di stringa, le virgolette (`""`) sono facoltative. Ad esempio, `region: us-west-2`. Sono incluse le voci che contengono più coppie chiave-valore fornite come singola stringa. Di seguito è riportato un esempio:

  ```
  $ sam deploy --tags "foo=bar hello=world"
  ```

  ```
  default:
    deploy:
      parameters:
        tags: foo=bar hello=world
  ```
+ Per le voci che contengono un elenco di valori o le voci che possono essere utilizzate più volte in un singolo comando, specificale come elenco di stringhe.

  Di seguito è riportato un esempio:

  ```
  $ sam remote invoke --parameter "InvocationType=Event" --parameter "LogType=None"
  ```

  ```
  default:
    remote_invoke:
      parameters:
          parameter:
          - InvocationType=Event
          - LogType=None
  ```

## Precedenza di configurazione
<a name="serverless-sam-cli-config-precedence"></a>

Durante la configurazione dei valori, ha la seguente precedenza:
+ I valori dei parametri forniti nella riga di comando hanno la precedenza sui valori corrispondenti nel file di configurazione e nella `Parameters` sezione del file modello.
+ Se l'`--parameter-overrides`opzione viene utilizzata nella riga di comando o nel file di configurazione con la `parameter_overrides` chiave, i suoi valori hanno la precedenza sui valori nella `Parameters` sezione del file modello.
+ Nel file di configurazione, le voci fornite per un comando specifico hanno la precedenza sulle voci globali. Nell'esempio seguente, il `sam deploy` comando utilizzerà il nome dello stack. `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
  ```

------

## Creazione e modifica dei file di configurazione
<a name="serverless-sam-cli-config-using"></a>

### Creazione di file di configurazione
<a name="serverless-sam-cli-config-using-create"></a>

Quando si crea un'applicazione utilizzando`sam init`, viene creato un `samconfig.toml` file predefinito. È inoltre possibile creare manualmente il file di configurazione.

### Modifica dei file di configurazione
<a name="serverless-sam-cli-config-using-modify"></a>

È possibile modificare manualmente i file di configurazione. Inoltre, durante qualsiasi flusso AWS SAMCLI interattivo, i valori configurati verranno visualizzati tra parentesi (`[ ]`). Se modifichi questi valori, AWS SAMCLI aggiornerà il tuo file di configurazione.

Di seguito è riportato un esempio di flusso interattivo che utilizza il `sam deploy --guided` comando:

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

Quando si modifica il file di configurazione, AWS SAMCLI gestisce i valori globali come segue:
+ Se il valore del parametro esiste nella `global` sezione del file di configurazione, AWS SAMCLI non scrive il valore nella sezione di comando specifica.
+ Se il valore del parametro esiste `global` sia nella sezione di comando che in quella specifica, AWS SAMCLI elimina la voce specifica a favore del valore globale.

# Gestione delle AWS SAMCLI versioni
<a name="manage-sam-cli-versions"></a>

Gestisci le versioni dell'interfaccia a riga di AWS Serverless Application Model comando (AWS SAMCLI) tramite l'aggiornamento, il downgrade e la disinstallazione. Facoltativamente, puoi scaricare e installare la nightly build. AWS SAMCLI

**Topics**
+ [

## Aggiornamento del AWS SAMCLI
](#manage-sam-cli-versions-upgrade)
+ [

## Disinstallazione di AWS SAMCLI
](#manage-sam-cli-versions-uninstall)
+ [

## Passa dall'uso Homebrew alla gestione di AWS SAMCLI
](#manage-sam-cli-versions-switch)
+ [

## Gestire la build AWS SAMCLI notturna
](#manage-sam-cli-versions-nightly-build)
+ [

## Installare il file AWS SAMCLI in un ambiente virtuale utilizzando pip
](#manage-sam-cli-versions-install-virtual)
+ [

## Gestire il AWS SAMCLI con Homebrew
](#manage-sam-cli-versions-homebrew)
+ [

## Risoluzione dei problemi
](#manage-sam-cli-versions-troubleshoot)

## Aggiornamento del AWS SAMCLI
<a name="manage-sam-cli-versions-upgrade"></a>

### Linux
<a name="manage-sam-cli-versions-upgrade-linux"></a>

Per eseguire l'aggiornamento AWS SAMCLI su Linux, segui le istruzioni di installazione riportate in[Installazione di AWS SAMCLI](install-sam-cli.md#install-sam-cli-instructions), ma aggiungi l'`--update`opzione al comando install, come segue:

```
sudo ./sam-installation/install --update
```

### macOS
<a name="manage-sam-cli-versions-upgrade-macos"></a>

 AWS SAMCLIDeve essere aggiornato con lo stesso metodo utilizzato per installarlo. Si consiglia di utilizzare il programma di installazione del pacchetto per installare e aggiornare il. AWS SAMCLI

 Per aggiornarlo AWS SAMCLI utilizzando il programma di installazione del pacchetto, installa la versione più recente del pacchetto. Per istruzioni, consulta [Installazione di AWS SAMCLI](install-sam-cli.md#install-sam-cli-instructions). 

### Windows
<a name="manage-sam-cli-versions-upgrade-windows"></a>

Per aggiornare il AWS SAMCLI, ripeti [Installa il AWS SAMCLI](install-sam-cli.md) nuovamente la procedura di installazione di Windows.

## Disinstallazione di AWS SAMCLI
<a name="manage-sam-cli-versions-uninstall"></a>

### Linux
<a name="manage-sam-cli-versions-uninstall-linux"></a>

Per disinstallare AWS SAMCLI su Linux, è necessario eliminare il collegamento simbolico e la directory di installazione eseguendo i seguenti comandi:

1. Individuare il collegamento simbolico e i percorsi di installazione.
   + Trovate il collegamento simbolico usando il **which** comando:

     ```
     which sam
     ```

     L'output mostra il percorso in cui si trovano i AWS SAM file binari, ad esempio:

     ```
      /usr/local/bin/sam
     ```
   + Trova la directory a cui punta il collegamento simbolico usando il **ls** comando:

     ```
     ls -l /usr/local/bin/sam
     ```

     Nell'esempio seguente, la directory di installazione è`/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. Eliminare il collegamento simbolico.

   ```
   sudo rm /usr/local/bin/sam
   ```

1. Eliminare la directory di installazione.

   ```
   sudo rm -rf /usr/local/aws-sam-cli
   ```

### macOS
<a name="manage-sam-cli-versions-uninstall-macos"></a>

Disinstallalo AWS SAMCLI con lo stesso metodo utilizzato per installarlo. Si consiglia di utilizzare il programma di installazione del pacchetto per installare il AWS SAMCLI.

Se hai installato il pacchetto AWS SAMCLI utilizzando il programma di installazione del pacchetto, segui questi passaggi per disinstallarlo.

**Per disinstallare il AWS SAMCLI**

1.  Rimuovere il AWS SAMCLI programma modificando ed eseguendo quanto segue: 

   ```
   $ sudo rm -rf /path-to/aws-sam-cli
   ```

   1.  *sudo*— Se l'utente dispone dei permessi di scrittura sulla posizione in cui è installato il AWS SAMCLI programma, non **sudo** è necessario. In caso contrario, **sudo** è richiesto. 

   1.  */path-to*— Percorso in cui è stato installato il AWS SAMCLI programma. Il percorso predefinito è `/usr/local`. 

1.  Rimuovere il file AWS SAMCLI `$PATH` modificando ed eseguendo quanto segue: 

   ```
   $ sudo rm -rf /path-to-symlink-directory/sam
   ```

   1.  *sudo*— Se l'utente dispone dei permessi di scrittura`$PATH`, non **sudo** è necessario. In caso contrario, **sudo** è richiesto. 

   1.  *path-to-symlink-directory*— La tua variabile di `$PATH` ambiente. Il percorso predefinito è `/usr/local/bin`. 

1.  Verificate che AWS SAMCLI sia disinstallato eseguendo quanto segue: 

   ```
   $ sam --version
   command not found: sam
   ```

### Windows
<a name="manage-sam-cli-versions-uninstall-windows"></a>

Per disinstallarlo AWS SAMCLI utilizzando le impostazioni di Windows, procedi nel seguente modo:

1. Dal menu Start, cerca «Aggiungi o rimuovi programmi».

1. Scegli il risultato denominato **AWS SAM Command Line Interface**, quindi scegli **Disinstalla** per avviare il programma di disinstallazione.

1. Conferma di voler disinstallare il. AWS SAMCLI

## Passa dall'uso Homebrew alla gestione di AWS SAMCLI
<a name="manage-sam-cli-versions-switch"></a>

Se si utilizza Homebrew per installare e aggiornare il AWS SAMCLI, si consiglia di utilizzare un metodo AWS supportato. Segui queste istruzioni per passare a un metodo supportato.

**Per passare dall'uso Homebrew**

1. Segui le istruzioni riportate in [Disinstallazione di una CLI Homebrew installata AWS SAM](#manage-sam-cli-versions-homebrew-uninstall) per disinstallare la versione Homebrew gestita.

1. Segui le istruzioni su [Installa il AWS SAMCLI](install-sam-cli.md) per installare la AWS SAM CLI utilizzando un metodo supportato.

## Gestire la build AWS SAMCLI notturna
<a name="manage-sam-cli-versions-nightly-build"></a>

Puoi scaricare e installare la AWS SAMCLI build notturna. Contiene una versione preliminare del AWS SAMCLI codice che potrebbe essere meno stabile della versione di produzione. Una volta installato, è possibile utilizzare il nightly build con il comando. `sam-nightly` È possibile installare e utilizzare contemporaneamente sia la versione di produzione che quella nightly build AWS SAMCLI di.

**Nota**  
La nightly build non contiene una versione preliminare dell'immagine di build. Per questo motivo, la creazione di un'applicazione serverless con l'**--use-container**opzione utilizza l'ultima versione di produzione dell'immagine di build.

### Installazione della AWS SAMCLI nightly build
<a name="manage-sam-cli-versions-nightly-build-install"></a>

Per installare la AWS SAMCLI versione notturna, segui queste istruzioni.

#### Linux
<a name="manage-sam-cli-versions-nightly-build-install-linux"></a>

È possibile installare la versione nightly build di AWS SAMCLI sulla piattaforma Linux x86\$164 utilizzando il programma di installazione del pacchetto.

**Per installare AWS SAMCLI la nightly build**

1. *Scarica il programma di installazione del pacchetto dal repository [sam-cli-nightly](https://github.com/aws/aws-sam-cli/releases/sam-cli-nightly/). aws-sam-cli GitHub*

1. Segui i passaggi per [AWS SAMCLIinstallare il](install-sam-cli.md) pacchetto nightly build.

#### macOS
<a name="manage-sam-cli-versions-nightly-build-install-macos"></a>

È possibile installare la versione nightly build di AWS SAMCLI onmacOS, utilizzando il programma di installazione del pacchetto nightly build.

**Per installare la versione nightly build AWS SAMCLI**

1. *Scarica il programma di installazione del pacchetto per la tua piattaforma dal repository [sam-cli-nightly](https://github.com/aws/aws-sam-cli/releases/sam-cli-nightly/). aws-sam-cli GitHub*

1. Segui i passaggi per [AWS SAMCLIinstallare il](install-sam-cli.md) pacchetto nightly build.

#### Windows
<a name="manage-sam-cli-versions-nightly-build-windows"></a>

La versione nightly build di AWS SAMCLI è disponibile con questo link per il download: [AWS SAMCLInightly](https://github.com/aws/aws-sam-cli/releases/download/sam-cli-nightly/AWS_SAM_CLI_64_PY3.msi) build. Per installare la versione nightly build su Windows, esegui gli stessi passaggi di[Installa il AWS SAMCLI](install-sam-cli.md), ma utilizza invece il link per il download di nightly build.

Per verificare di aver installato la versione nightly build, esegui il comando. **sam-nightly --version** L'output di questo comando è nel formato`1.X.Y.dev<YYYYMMDDHHmm>`, ad esempio:

```
SAM CLI, version 1.20.0.dev202103151200
```

### Passa da Homebrew al programma di installazione del pacchetto
<a name="manage-sam-cli-versions-nightly-build-switch"></a>

Se stai utilizzando Homebrew per installare e aggiornare la AWS SAMCLI nightly build e desideri passare all'utilizzo del programma di installazione del pacchetto, segui questi passaggi.

**Per passare dal programma di installazione del Homebrew pacchetto**

1. Disinstalla la build AWS SAMCLI nightly Homebrew installata.

   ```
   $ brew uninstall aws-sam-cli-nightly
   ```

1. Verifica che la AWS SAMCLI nightly build sia disinstallata eseguendo quanto segue:

   ```
   $ sam-nightly --version
   zsh: command not found: sam-nightly
   ```

1. Segui i passaggi della sezione precedente per installare la nightly build. AWS SAMCLI

## Installare il file AWS SAMCLI in un ambiente virtuale utilizzando pip
<a name="manage-sam-cli-versions-install-virtual"></a>

Si consiglia di utilizzare il programma di installazione nativo del pacchetto per installare. AWS SAMCLI Se è necessario utilizzarlopip, si consiglia di installarlo AWS SAMCLI in un ambiente virtuale. Ciò garantisce un ambiente di installazione pulito e un ambiente isolato in caso di errori.

**Nota**  
A partire dal 24 ottobre 2023, AWS SAM CLI il supporto perPython 3.7. Per ulteriori informazioni, consulta [AWS SAMCLIinterruzione del supporto per Python 3.7](important-notes.md#important-notes-2023-10-python).

**Per installarlo AWS SAMCLI in un ambiente virtuale**

1. Da una directory iniziale di tua scelta, crea un ambiente virtuale e assegnagli un nome.

------
#### [ Linux / macOS ]

   ```
   $ mkdir project
   $ cd project
   $ python3 -m venv venv
   ```

------
#### [ Windows ]

   ```
   > mkdir project
   > cd project
   > py -3 -m venv venv
   ```

------

1. Attiva l'ambiente virtuale

------
#### [ Linux / macOS ]

   ```
   $ . venv/bin/activate
   ```

   La richiesta cambia per mostrare che l'ambiente virtuale è attivo.

   ```
   (venv) $ 
   ```

------
#### [ Windows ]

   ```
   > venv\Scripts\activate
   ```

   Il prompt cambia per mostrare che l'ambiente virtuale è attivo.

   ```
   (venv) > 
   ```

------

1. Installalo AWS SAMCLI nel tuo ambiente virtuale.

   ```
   (venv) $ pip install --upgrade aws-sam-cli
   ```

1. Verifica che AWS SAMCLI sia installato correttamente.

   ```
   (venv) $ sam --version
   SAM CLI, version 1.94.0
   ```

1. Puoi utilizzare il comando `deactivate` per chiudere l'ambiente virtuale. Quando avvii una nuova sessione, devi attivare nuovamente l'ambiente.

## Gestire il AWS SAMCLI con Homebrew
<a name="manage-sam-cli-versions-homebrew"></a>

**Nota**  
A partire da settembre 2023, AWS non manterrà più il programma di Homebrew installazione AWS gestito per AWS SAMCLI ()`aws/tap/aws-sam-cli`. Per continuare a utilizzareHomebrew, puoi utilizzare il programma di installazione gestito dalla community ()`aws-sam-cli`. A partire da settembre 2023, qualsiasi Homebrew comando a cui fa riferimento `aws/tap/aws-sam-cli` verrà reindirizzato a. `aws-sam-cli`  
Ti consigliamo di utilizzare i nostri metodi di [installazione](install-sam-cli.md) e [aggiornamento](#manage-sam-cli-versions-upgrade) supportati.

### Installazione dell' AWS SAMCLIutilizzo Homebrew
<a name="manage-sam-cli-versions-homebrew-install"></a>

**Nota**  
Queste istruzioni utilizzano il programma di AWS SAMCLI Homebrew installazione gestito dalla comunità. Per ulteriore assistenza, consulta il repository *[homebrew-core](https://github.com/Homebrew/homebrew-core/issues)*.

**Per installare il AWS SAMCLI**

1. Esegui il seguente codice:

   ```
   $ brew install aws-sam-cli
   ```

1. Verifica l’installazione:

   ```
   $ sam --version
   ```

   Dopo la corretta installazione di AWS SAMCLI, si dovrebbe vedere un risultato simile al seguente:

   ```
   SAM CLI, version 1.94.0
   ```

### Aggiornamento dell'utilizzo AWS SAMCLI Homebrew
<a name="manage-sam-cli-versions-homebrew-upgrade"></a>

Per aggiornare l' AWS SAMCLIutilizzoHomebrew, esegui il seguente comando:

```
$ brew upgrade aws-sam-cli
```

### Disinstallazione di una CLI Homebrew installata AWS SAM
<a name="manage-sam-cli-versions-homebrew-uninstall"></a>

Se AWS SAMCLI è stato installato utilizzandoHomebrew, segui questi passaggi per disinstallarlo.

**Per disinstallare il AWS SAMCLI**

1. Esegui il seguente codice:

   ```
   $ brew uninstall aws-sam-cli
   ```

1. Verificare che AWS SAMCLI sia disinstallato eseguendo quanto segue:

   ```
   $ sam --version
   command not found: sam
   ```

### Passaggio al programma di installazione gestito Homebrew dalla community
<a name="manage-sam-cli-versions-homebrew-switch"></a>

Se stai usando il programma di Homebrew installazione AWS gestito (`aws/tap/aws-sam-cli`) e preferisci continuare a usarloHomebrew, ti consigliamo di passare al programma di Homebrew installazione gestito dalla community ()`aws-sam-cli`.

Per passare a un solo comando, esegui quanto segue:

```
$ brew uninstall aws-sam-cli && brew untap aws/tap && brew cleanup aws/tap && brew update && brew install aws-sam-cli
```

Segui queste istruzioni per eseguire ogni comando singolarmente.

**Per passare al programma di Homebrew installazione gestito dalla community**

1. Disinstalla la Homebrew versione AWS gestita di AWS SAMCLI:

   ```
   $ brew uninstall aws-sam-cli
   ```

1. Verifica che sia AWS SAMCLI stato disinstallato:

   ```
   $ which sam
   sam not found
   ```

1. Rimuovi il AWS SAMCLI rubinetto AWS gestito:

   ```
   $ brew untap aws/tap
   ```

   Se ricevi un errore come il seguente, aggiungi l'`--force`opzione e riprova.

   ```
   Error: Refusing to untap aws/tap because it contains the following installed formulae or casks:
   aws-sam-cli-nightly
   ```

1. Rimuovi i file memorizzati nella cache per il programma di installazione AWS gestito:

   ```
   $ brew cleanup aws/tap
   ```

1. Aggiornamento Homebrew e tutte le formule:

   ```
   $ brew update
   ```

1. Installa la versione gestita dalla community di AWS SAMCLI:

   ```
   $ brew install aws-sam-cli
   ```

1. Verifica che AWS SAMCLI sia installato correttamente:

   ```
   $ sam --version
   SAM CLI, version 1.94.0
   ```

## Risoluzione dei problemi
<a name="manage-sam-cli-versions-troubleshoot"></a>

Se riscontri errori durante l'installazione o l'utilizzo di AWS SAMCLI, consulta[AWS SAMCLIrisoluzione dei problemi](sam-cli-troubleshooting.md).

# Impostazione delle AWS credenziali
<a name="serverless-getting-started-set-up-credentials"></a>

L'interfaccia a riga di AWS SAM comando (CLI) richiede l'impostazione di AWS credenziali in modo da poter effettuare chiamate ai AWS servizi per conto dell'utente. Ad esempio, AWS SAMCLI effettua chiamate verso Amazon S3 e. CloudFormation

Potresti aver già impostato AWS le credenziali per lavorare con AWS strumenti, come uno dei AWS SDKs o il. AWS CLI In caso contrario, in questo argomento vengono illustrati gli approcci consigliati per l'impostazione delle AWS credenziali.

Per impostare AWS le credenziali, devi disporre dell'*ID della chiave di accesso* e della *chiave di accesso segreta* per l'utente IAM che desideri configurare. Per informazioni sulla chiave di accesso IDs e sulle chiavi di accesso segrete, consulta [Managing Access Keys for IAM Users](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) nella *IAM User Guide*.

Quindi, stabilisci se hai AWS CLI installato il. Quindi segui le istruzioni in una delle seguenti sezioni:

## Usando il AWS CLI
<a name="serverless-getting-started-set-up-credentials-cli"></a>

Se l'hai AWS CLI installato, usa il `aws configure` comando e segui le istruzioni:

```
$ 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]:
```

*Per informazioni sul `aws configure` comando, consulta la sezione [Configurazione rapida di AWS CLI nella Guida per l'](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html#cli-quick-configuration)utente.AWS Command Line Interface *

## Non si utilizza il AWS CLI
<a name="serverless-getting-started-set-up-credentials-no-cli"></a>

Se non l'hai AWS CLI installato, puoi creare un file di credenziali o impostare variabili di ambiente:
+ **File di credenziali**: è possibile impostare le credenziali nel file delle AWS credenziali sul sistema locale. Questo file deve trovarsi in una delle seguenti posizioni:
  + `~/.aws/credentials`su Linux o macOS
  + `C:\Users\USERNAME\.aws\credentials` in Windows

  Questo file deve contenere righe nel seguente formato:

  ```
  [default]
  aws_access_key_id = your_access_key_id
  aws_secret_access_key = your_secret_access_key
  ```

   
+ **Variabili di ambiente**: puoi impostare le variabili di `AWS_SECRET_ACCESS_KEY` ambiente `AWS_ACCESS_KEY_ID` e.

  Per impostare queste variabili su Linux o macOS, usa il comando **export**:

  ```
  export AWS_ACCESS_KEY_ID=your_access_key_id
  export AWS_SECRET_ACCESS_KEY=your_secret_access_key
  ```

  Per impostare queste variabili su Windows, usa il comando **set**:

  ```
  set AWS_ACCESS_KEY_ID=your_access_key_id
  set AWS_SECRET_ACCESS_KEY=your_secret_access_key
  ```

# Telemetria nel AWS SAMCLI
<a name="serverless-sam-telemetry"></a>

In AWS, sviluppiamo e lanciamo servizi basati su ciò che apprendiamo dalle interazioni con i clienti. Utilizziamo il feedback dei clienti per iterare sul nostro prodotto. La telemetria è un'informazione aggiuntiva che ci aiuta a comprendere meglio le esigenze dei nostri clienti, diagnosticare i problemi e fornire funzionalità che migliorano l'esperienza del cliente.

L'interfaccia a riga di AWS SAM comando (CLI) raccoglie dati di telemetria, ad esempio metriche di utilizzo generiche, informazioni sul sistema e sull'ambiente ed errori. Per informazioni dettagliate sui tipi di telemetria raccolti, consulta. [Tipo di informazioni da raccogliere](#serverless-sam-telemtry-data-collected)

**Non AWS SAMCLI** raccoglie informazioni personali, come nomi utente o indirizzi e-mail. Inoltre, non estrae informazioni sensibili a livello di progetto.

I clienti controllano se la telemetria è attivata e possono modificare le impostazioni in qualsiasi momento. Se la telemetria rimane attiva, AWS SAMCLI invia i dati di telemetria in background senza richiedere alcuna interazione aggiuntiva con il cliente.

## Disattiva la telemetria per una sessione
<a name="serverless-sam-telemtry-opt-out"></a>

Nei sistemi operativi macOS e Linux, puoi disattivare la telemetria per una singola sessione. Per disattivare la telemetria per la sessione corrente, esegui il comando seguente per impostare la variabile di ambiente `SAM_CLI_TELEMETRY` su `false`. Ripeti il comando per ogni nuovo terminale o sessione.

```
export SAM_CLI_TELEMETRY=0
```

## Disattivazione della telemetria per il tuo profilo in tutte le sessioni
<a name="serverless-sam-telemtry-opt-out-profile"></a>

Esegui i seguenti comandi per disattivare la telemetria per tutte le sessioni quando la esegui sul tuo sistema operativo. AWS SAMCLI

### Per disattivare la telemetria in Linux
<a name="w2aac28c19c16c15b5"></a>

1. Esegui:

   ```
   echo "export SAM_CLI_TELEMETRY=0" >>~/.profile
   ```

1. Esegui:

   ```
   source ~/.profile
   ```

### Per disattivare la telemetria in Linux
<a name="w2aac28c19c16c15b7"></a>

1. Esegui:

   ```
   echo "export SAM_CLI_TELEMETRY=0" >>~/.profile
   ```

1. Esegui:

   ```
   source ~/.profile
   ```

### Per disattivare la telemetria in Linux
<a name="w2aac28c19c16c15b9"></a>

Puoi impostare temporaneamente la variabile di ambiente per tutta la durata della finestra del terminale con il seguente comando:

Se si utilizza il prompt dei comandi:

```
set SAM_CLI_TELEMETRY=0
```

Se si utilizza PowerShell:

```
$env:SAM_CLI_TELEMETRY=0
```

Per impostare la variabile di ambiente in modo permanente nel prompt dei comandi oppure PowerShell, utilizzate il seguente comando:

```
setx SAM_CLI_TELEMETRY 0
```

**Nota**  
Le modifiche entreranno in vigore solo dopo la chiusura e la riapertura del terminale.

## Tipo di informazioni da raccogliere
<a name="serverless-sam-telemtry-data-collected"></a>
+ **Informazioni sull'utilizzo**: i comandi e i sottocomandi generici eseguiti dai clienti.
+ **Errori e informazioni diagnostiche**: lo stato e la durata dei comandi eseguiti dai clienti, inclusi i codici di uscita, i nomi delle eccezioni interne e gli errori durante la connessione a Docker.
+ **Informazioni sul sistema e sull'ambiente**: la versione di Python, il sistema operativo (Windows, Linux o macOS), l'ambiente in cui AWS SAMCLI viene eseguito (ad esempio AWS CodeBuild, un toolkit AWS IDE o un terminale) e i valori hash degli attributi di utilizzo.

## Ulteriori informazioni
<a name="serverless-sam-telemtry-learn-more"></a>

I dati di telemetria AWS SAMCLI raccolti aderiscono alle politiche sulla privacy dei dati. AWS Per ulteriori informazioni, consulta gli argomenti seguenti:
+ [AWS Termini del servizio](https://aws.amazon.com/service-terms/)
+ [Domande frequenti sulla privacy dei dati](https://aws.amazon.com/compliance/data-privacy-faq/)

# AWS SAMCLIrisoluzione dei problemi
<a name="sam-cli-troubleshooting"></a>

Questa sezione fornisce dettagli su come risolvere i messaggi di errore durante l'utilizzo, l'installazione e la gestione dell'interfaccia a riga di AWS Serverless Application Model comando ().AWS SAMCLI

**Topics**
+ [

## Risoluzione dei problemi
](#install-sam-cli-troubleshooting)
+ [

## Messaggi di errore
](#sam-cli-troubleshoot-messages)
+ [

## Messaggi di avviso
](#sam-cli-troubleshoot-warning)

## Risoluzione dei problemi
<a name="install-sam-cli-troubleshooting"></a>

Per indicazioni sulla risoluzione dei problemi relative a AWS SAMCLI, vedere[Risoluzione degli errori di installazione](install-sam-cli.md#sam-cli-troubleshoot-install).

## Messaggi di errore
<a name="sam-cli-troubleshoot-messages"></a>

### Errore curl: «curl: (6) Impossibile risolvere:...»
<a name="sam-cli-troubleshoot-messages-curl"></a>

Quando si tenta di richiamare l'endpoint API Gateway, viene visualizzato il seguente errore:

```
curl: (6) Could not resolve: endpointdomain (Domain name not found)
```

Ciò significa che hai tentato di inviare una richiesta a un dominio non valido. Ciò può accadere se l'applicazione serverless non è stata distribuita correttamente o se hai un errore di battitura nel comando. **curl** Verifica che l'applicazione sia stata distribuita correttamente utilizzando la CloudFormation console o il AWS CLI, e verifica che il **curl** comando sia corretto.

### Errore: impossibile trovare informazioni esatte sulle risorse con il nome dello stack specificato
<a name="sam-cli-troubleshoot-messages-exact-resource"></a>

Quando si esegue il `sam remote invoke` comando su un'applicazione che contiene una singola risorsa della funzione Lambda, viene visualizzato il seguente errore:

```
Error: Can't find exact resource information with given <stack-name>. Please provide full resource ARN or --stack-name to resolve the ambiguity.
```

**Causa possibile: non hai fornito l'`--stack-name`opzione.**  
Se una funzione ARN non viene fornita come argomento, il `sam remote invoke` comando richiede che venga fornita l'`--stack-name`opzione.

**Soluzione: fornire l'`--stack-name`opzione.**  
Di seguito è riportato un esempio:  

```
$ 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\"}"}%
```

### Errore: impossibile trovare le informazioni sulle risorse dal nome dello stack
<a name="sam-cli-troubleshoot-messages-stack-name"></a>

Quando si esegue il `sam remote invoke` comando e si passa una funzione Lambda ARN come argomento, viene visualizzato il seguente errore:

```
Error: Can't find resource information from stack name (<stack-name>) and resource id (<function-id>)
```

**Possibile causa: il valore del nome dello stack è definito nel file. `samconfig.toml`**  
Il AWS SAMCLI primo verifica la presenza di un `samconfig.toml` nome per lo stack nel file. Se specificato, l'argomento viene passato come valore ID logico.

**Soluzione: passate invece l'ID logico della funzione.**  
È possibile passare l'ID logico della funzione come argomento anziché l'ARN della funzione.

**Soluzione: rimuovete il valore del nome dello stack dal file di configurazione.**  
È possibile rimuovere il valore del nome dello stack dal file di configurazione. Ciò impedisce di passare l' AWS SAMCLIARN della funzione come valore ID logico.  
Esegui `sam build` dopo aver modificato il file di configurazione.

### Errore: creazione di risorse gestite non riuscita: impossibile individuare le credenziali
<a name="sam-cli-troubleshoot-messages-credentials"></a>

Quando si esegue il **sam deploy** comando, viene visualizzato il seguente errore:

```
Error: Failed to create managed resources: Unable to locate credentials
```

Ciò significa che non sono state impostate AWS le credenziali per consentire l'esecuzione AWS SAMCLI di chiamate AWS di servizio. Per risolvere questo problema, è necessario impostare AWS le credenziali. Per ulteriori informazioni, consulta [Impostazione delle AWS credenziali](serverless-getting-started-set-up-credentials.md).

### Errore: FileNotFoundError in Windows
<a name="sam-cli-troubleshoot-messages-filenotfound-win"></a>

Quando si eseguono AWS SAMCLI comandi in Windows, è possibile che venga visualizzato il seguente errore:

```
Error: FileNotFoundError
```

Possibile causa: AWS SAMCLI potrebbe interagire con percorsi di file che superano il limite massimo di percorso di Windows.

Soluzione: per risolvere questo problema, è necessario abilitare il nuovo comportamento dei percorsi lunghi. A tale scopo, consulta [Abilitare percorsi lunghi in Windows 10, versione 1607 e successive](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) nella *documentazione sullo sviluppo di app per Microsoft Windows*.

### Errore: il risolutore di dipendenze di pip...
<a name="sam-cli-troubleshoot-messages-pip"></a>

*Esempio di testo dell’errore:*

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

**Possibile causa: se si utilizza pip per installare pacchetti, le dipendenze tra i pacchetti potrebbero essere in conflitto.**  
Ogni versione del `aws-sam-cli` pacchetto dipende da una versione del `aws-sam-translator` pacchetto. Ad esempio, la `aws-sam-cli` v1.58.0 può dipendere dalla v1.51.0. `aws-sam-translator`  
Se si installa l' AWS SAMCLIusingpip, quindi si installa un altro pacchetto che dipende da una versione più recente di, si verificherà quanto segue: `aws-sam-translator`  
+ La versione più recente di `aws-sam-translator` will install.
+ La versione corrente `aws-sam-cli` e la versione più recente di `aws-sam-translator` potrebbero non essere compatibili.
+ Quando si utilizza il AWS SAMCLI, si verificherà l'errore del risolutore delle dipendenze.

**Soluzioni:**

1. Usa il programma di installazione del pacchetto AWS SAMCLI nativo.

   1. Disinstalla AWS SAMCLI usando pip. Per istruzioni, consulta [Disinstallazione di AWS SAMCLI](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall).

   1. Installa AWS SAMCLI utilizzando il programma di installazione del pacchetto nativo. Per istruzioni, consulta [Installa il AWS SAMCLI](install-sam-cli.md).

   1. Se necessario, esegui l'aggiornamento AWS SAMCLI utilizzando il programma di installazione del pacchetto nativo. Per istruzioni, consulta [Aggiornamento del AWS SAMCLI](manage-sam-cli-versions.md#manage-sam-cli-versions-upgrade).

1. Se è necessario utilizzarepip, si consiglia di installare la AWS SAM CLI in un ambiente virtuale. Ciò garantisce un ambiente di installazione pulito e un ambiente isolato in caso di errori. Per istruzioni, consulta [Installare il file AWS SAMCLI in un ambiente virtuale utilizzando pip](manage-sam-cli-versions.md#manage-sam-cli-versions-install-virtual).

### Errore: nessun comando di questo tipo «remoto»
<a name="sam-cli-troubleshoot-messages-command-remote"></a>

Quando si esegue il `sam remote invoke` comando, viene visualizzato il seguente errore:

```
$ 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'.
```

**Causa possibile: la tua versione di non AWS SAMCLI è aggiornata.**  
Il AWS SAMCLI `sam remote invoke` comando è stato rilasciato con la AWS SAMCLI versione 1.88.0. Puoi controllare la tua versione eseguendo il `sam --version` comando.

**Soluzione: aggiorna il tuo AWS SAMCLI alla versione più recente.**  
Per istruzioni, consulta [Aggiornamento del AWS SAMCLI](manage-sam-cli-versions.md#manage-sam-cli-versions-upgrade).

### Errore: l'esecuzione locale di progetti AWS SAM richiedeDocker. L'hai installato?
<a name="sam-cli-troubleshoot-messages-docker"></a>

Quando si esegue il **sam local start-api** comando, viene visualizzato il seguente errore:

```
Error: Running AWS SAM projects locally requires Docker. Have you got it installed?
```

Ciò significa che l'installazione non è stata Docker eseguita correttamente. Dockerè necessario per testare l'applicazione localmente. Per risolvere questo problema, segui le istruzioni per l'installazione di Docker per il tuo host di sviluppo. Per ulteriori informazioni, consulta [Installazione di Docker](install-docker.md).

### Errore: vincoli di sicurezza non soddisfatti
<a name="sam-cli-troubleshoot-messages-security-constraints"></a>

Durante l'esecuzione**sam deploy --guided**, ti viene posta la domanda. `Function may not have authorization defined, Is this okay? [y/N]` Se rispondi a questa richiesta con **N** (la risposta predefinita), viene visualizzato il seguente errore:

```
Error: Security Constraints Not Satisfied
```

Il messaggio ti informa che l'applicazione che stai per distribuire potrebbe avere un'API Amazon API Gateway accessibile pubblicamente configurata senza autorizzazione. Rispondendo **N** a questa richiesta, stai dicendo che non va bene.

Per risolvere questo problema, sono disponibili le seguenti opzioni:
+ Configura la tua applicazione con autorizzazione. Per informazioni sulla configurazione dell'autorizzazione, vedere[Controlla l'accesso alle API con il tuo AWS SAM modello](serverless-controlling-access-to-apis.md).
+ Se intendi avere un endpoint API accessibile pubblicamente senza autorizzazione, riavvia la distribuzione e rispondi a questa domanda indicando che sei d'accordo con la distribuzione. **Y**

### messaggio: Token di autenticazione mancante
<a name="sam-cli-troubleshoot-messages-auth-token"></a>

Quando si tenta di richiamare l'endpoint API Gateway, viene visualizzato il seguente errore:

```
{"message":"Missing Authentication Token"}
```

Ciò significa che hai tentato di inviare una richiesta al dominio corretto, ma l'URI non è riconoscibile. Per risolvere questo problema, verifica l'URL completo e aggiorna il **curl** comando con l'URL corretto.

## Messaggi di avviso
<a name="sam-cli-troubleshoot-warning"></a>

### Avviso:... AWS non manterrà più il Homebrew programma di installazione per AWS SAM ...
<a name="sam-cli-troubleshoot-warning-homebrew"></a>

Durante l'installazione di AWS SAMCLI UsingHomebrew, viene visualizzato il seguente messaggio di avviso:

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

**Causa potenziale: AWS non è più possibile mantenere Homebrew il supporto.**  
A partire da settembre 2023, AWS non manterrà più il Homebrew programma di installazione per. AWS SAMCLI  

**Soluzione: utilizzare un metodo di installazione AWS supportato.**
+ I metodi di installazione AWS supportati sono disponibili all'indirizzo[Installa il AWS SAMCLI](install-sam-cli.md).

**Soluzione: per continuare a utilizzareHomebrew, utilizzate il programma di installazione gestito dalla community.**
+ È possibile utilizzare il programma di Homebrew installazione gestito dalla community a propria discrezione. Per istruzioni, consulta [Gestire il AWS SAMCLI con Homebrew](manage-sam-cli-versions.md#manage-sam-cli-versions-homebrew).

# AWS SAM riferimento del connettore
<a name="reference-sam-connector"></a>

Questa sezione contiene informazioni di riferimento per il tipo di risorsa del connettore AWS Serverless Application Model (AWS SAM). Per un'introduzione ai connettori, vedere[Gestione delle autorizzazioni delle risorse con i connettori AWS SAM](managing-permissions-connectors.md).

## Tipi di risorse di origine e destinazione supportati per i connettori
<a name="supported-connector-resource-types"></a>

Il tipo di `AWS::Serverless::Connector` risorsa supporta un numero selezionato di connessioni tra le risorse di origine e di destinazione. Quando configurate i connettori nel AWS SAM modello, utilizzate la tabella seguente per fare riferimento alle connessioni supportate e alle proprietà che devono essere definite per ogni tipo di risorsa di origine e destinazione. Per ulteriori informazioni sulla configurazione dei connettori nel modello, vedere. [AWS::Serverless::Connector](sam-resource-connector.md)

Sia per le risorse di origine che per quelle di destinazione, se definite all'interno dello stesso modello, utilizzate la `Id` proprietà. Facoltativamente, `Qualifier` è possibile aggiungere un per restringere l'ambito della risorsa definita. Se la risorsa non si trova all'interno dello stesso modello, utilizzate una combinazione di proprietà supportate.

 Per richiedere nuove connessioni, [invia un nuovo problema](https://github.com/aws/serverless-application-model/issues/new?assignees=&labels=area%2Fconnectors,stage%2Fneeds-triage&template=other.md&title=%28New%20Connector%20Profile%29) al *serverless-application-model AWS GitHubrepository*.


| Source type (Tipo di origine) | Tipo di destinazione | Permissions | Proprietà della fonte | Proprietà di destinazione | 
| --- | --- | --- | --- | --- | 
| `AWS::ApiGateway::RestApi` | `AWS::Lambda::Function` | `Write` | `Id`oppure `Qualifier``ResourceId`, e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::ApiGateway::RestApi` | `AWS::Serverless::Function` | `Write` | `Id`oppure `Qualifier``ResourceId`, e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::ApiGatewayV2::Api` | `AWS::Lambda::Function` | `Write` | `Id`oppure `Qualifier``ResourceId`, e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::ApiGatewayV2::Api` | `AWS::Serverless::Function` | `Write` | `Id`oppure `Qualifier``ResourceId`, e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::AppSync::DataSource` | `AWS::DynamoDB::Table` | `Read` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::AppSync::DataSource` | `AWS::DynamoDB::Table` | `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::AppSync::DataSource` | `AWS::Events::EventBus` | `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::AppSync::DataSource` | `AWS::Lambda::Function` | `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::AppSync::DataSource` | `AWS::Serverless::Function` | `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::AppSync::DataSource` | `AWS::Serverless::SimpleTable` | `Read` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::AppSync::DataSource` | `AWS::Serverless::SimpleTable` | `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::AppSync::GraphQLApi` | `AWS::Lambda::Function` | `Write` | `Id`o `ResourceId` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::AppSync::GraphQLApi` | `AWS::Serverless::Function` | `Write` | `Id`o `ResourceId` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::DynamoDB::Table` | `AWS::Lambda::Function` | `Read` | `Id`o `Arn` e `Type` | `Id`o `RoleName` e `Type` | 
| `AWS::DynamoDB::Table` | `AWS::Serverless::Function` | `Read` | `Id`o `Arn` e `Type` | `Id`o `RoleName` e `Type` | 
| `AWS::Events::Rule` | `AWS::Events::EventBus` | `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Events::Rule` | `AWS::Lambda::Function` | `Write` | `Id`o `Arn` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Events::Rule` | `AWS::Serverless::Function` | `Write` | `Id`o `Arn` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Events::Rule` | `AWS::Serverless::StateMachine` | `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Events::Rule` | `AWS::SNS::Topic` | `Write` | `Id`o `Arn` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Events::Rule` | `AWS::SQS::Queue` | `Write` | `Id`o `Arn` e `Type` | `Id`oppure `Arn``QueueUrl`, e `Type` | 
| `AWS::Events::Rule` | `AWS::StepFunctions::StateMachine` | `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Lambda::Function` | `AWS::DynamoDB::Table` | `Read`, `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Lambda::Function` | `AWS::Events::EventBus` | `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Lambda::Function` | `AWS::Lambda::Function` | `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Lambda::Function` | `AWS::Location::PlaceIndex` | `Read` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Lambda::Function` | `AWS::S3::Bucket` | `Read`, `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Lambda::Function` | `AWS::Serverless::Function` | `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Lambda::Function` | `AWS::Serverless::SimpleTable` | `Read`, `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Lambda::Function` | `AWS::Serverless::StateMachine` | `Read`, `Write` | `Id`o `RoleName` e `Type` | `Id`oppure `Arn``Name`, e `Type` | 
| `AWS::Lambda::Function` | `AWS::SNS::Topic` | `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Lambda::Function` | `AWS::SQS::Queue` | `Read`, `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Lambda::Function` | `AWS::StepFunctions::StateMachine` | `Read`, `Write` | `Id`o `RoleName` e `Type` | `Id`oppure `Arn``Name`, e `Type` | 
| `AWS::S3::Bucket` | `AWS::Lambda::Function` | `Write` | `Id`o `Arn` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::S3::Bucket` | `AWS::Serverless::Function` | `Write` | `Id`o `Arn` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Serverless::Api` | `AWS::Lambda::Function` | `Write` | `Id`oppure `Qualifier``ResourceId`, e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Serverless::Api` | `AWS::Serverless::Function` | `Write` | `Id`oppure `Qualifier``ResourceId`, e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Serverless::Function` | `AWS::DynamoDB::Table` | `Read`, `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Serverless::Function` | `AWS::Events::EventBus` | `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Serverless::Function` | `AWS::Lambda::Function` | `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Serverless::Function` | `AWS::S3::Bucket` | `Read`, `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Serverless::Function` | `AWS::Serverless::Function` | `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Serverless::Function` | `AWS::Serverless::SimpleTable` | `Read`, `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Serverless::Function` | `AWS::Serverless::StateMachine` | `Read`, `Write` | `Id`o `RoleName` e `Type` | `Id`oppure `Arn``Name`, e `Type` | 
| `AWS::Serverless::Function` | `AWS::SNS::Topic` | `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Serverless::Function` | `AWS::SQS::Queue` | `Read`, `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Serverless::Function` | `AWS::StepFunctions::StateMachine` | `Read`, `Write` | `Id`o `RoleName` e `Type` | `Id`oppure `Arn``Name`, e `Type` | 
| `AWS::Serverless::HttpApi` | `AWS::Lambda::Function` | `Write` | `Id`oppure `Qualifier``ResourceId`, e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Serverless::HttpApi` | `AWS::Serverless::Function` | `Write` | `Id`oppure `Qualifier``ResourceId`, e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Serverless::SimpleTable` | `AWS::Lambda::Function` | `Read` | `Id`o `Arn` e `Type` | `Id`o `RoleName` e `Type` | 
| `AWS::Serverless::SimpleTable` | `AWS::Serverless::Function` | `Read` | `Id`o `Arn` e `Type` | `Id`o `RoleName` e `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::DynamoDB::Table` | `Read`, `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::Events::EventBus` | `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::Lambda::Function` | `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::S3::Bucket` | `Read`, `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::Serverless::Function` | `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::Serverless::SimpleTable` | `Read`, `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::Serverless::StateMachine` | `Read`, `Write` | `Id`o `RoleName` e `Type` | `Id`oppure `Arn``Name`, e `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::SNS::Topic` | `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::SQS::Queue` | `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::StepFunctions::StateMachine` | `Read`, `Write` | `Id`o `RoleName` e `Type` | `Id`oppure `Arn``Name`, e `Type` | 
| `AWS::SNS::Topic` | `AWS::Lambda::Function` | `Write` | `Id`o `Arn` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::SNS::Topic` | `AWS::Serverless::Function` | `Write` | `Id`o `Arn` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::SNS::Topic` | `AWS::SQS::Queue` | `Write` | `Id`o `Arn` e `Type` | `Id`oppure `Arn``QueueUrl`, e `Type` | 
| `AWS::SQS::Queue` | `AWS::Lambda::Function` | `Read`, `Write` | `Id`o `Arn` e `Type` | `Id`o `RoleName` e `Type` | 
| `AWS::SQS::Queue` | `AWS::Serverless::Function` | `Read`, `Write` | `Id`o `Arn` e `Type` | `Id`o `RoleName` e `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::DynamoDB::Table` | `Read`, `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::Events::EventBus` | `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::Lambda::Function` | `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::S3::Bucket` | `Read`, `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::Serverless::Function` | `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::Serverless::SimpleTable` | `Read`, `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::Serverless::StateMachine` | `Read`, `Write` | `Id`o `RoleName` e `Type` | `Id`oppure `Arn``Name`, e `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::SNS::Topic` | `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::SQS::Queue` | `Write` | `Id`o `RoleName` e `Type` | `Id`o `Arn` e `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::StepFunctions::StateMachine` | `Read`, `Write` | `Id`o `RoleName` e `Type` | `Id`oppure `Arn``Name`, e `Type` | 

## Politiche IAM create dai connettori
<a name="reference-sam-connector-policies"></a>

Questa sezione documenta le politiche AWS Identity and Access Management (IAM) create da AWS SAM quando si utilizzano i connettori.

`AWS::DynamoDB::Table` Da a `AWS::Lambda::Function`  
**Tipo di policy**  
[Politica gestita dal cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) allegata al `AWS::Lambda::Function` ruolo.  
**Categorie di accesso**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "dynamodb:DescribeStream",
        "dynamodb:GetRecords",
        "dynamodb:GetShardIterator",
        "dynamodb:ListStreams"
      ],
      "Resource": [
        "%{Source.Arn}/stream/*"
      ]
    }
  ]
}
```

`AWS::Events::Rule` Da a `AWS::SNS::Topic`  
**Tipo di politica**  
[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)allegato al`AWS::SNS::Topic`.  
**Categorie di accesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "events.amazonaws.com"
      },
      "Resource": "%{Destination.Arn}",
      "Action": "sns:Publish",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "%{Source.Arn}"
        }
      }
    }
  ]
}
```

`AWS::Events::Rule` Da a `AWS::Events::EventBus`  
**Tipo di politica**  
[Politica gestita dal cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) allegata al `AWS::Events::Rule` ruolo.  
**Categorie di accesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "events:PutEvents"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::Events::Rule` Da a `AWS::StepFunctions::StateMachine`  
**Tipo di politica**  
[Politica gestita dal cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) allegata al `AWS::Events::Rule` ruolo.   
**Categorie di accesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "states:StartExecution"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::Events::Rule` Da a `AWS::Lambda::Function`  
**Tipo di politica**  
`[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html)`allegato al`AWS::Lambda::Function`.  
**Categorie di accesso**  
`Write`  

```
{
  "Action": "lambda:InvokeFunction",
  "Principal": "events.amazonaws.com",
  "SourceArn": "%{Source.Arn}"
}
```

`AWS::Events::Rule` Da a `AWS::SQS::Queue`  
**Tipo di politica**  
`[AWS::SQS::QueuePolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sqs-queuepolicy.html)`allegato al`AWS::SQS::Queue`.  
**Categorie di accesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "events.amazonaws.com"
      },
      "Resource": "%{Destination.Arn}",
      "Action": "sqs:SendMessage",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "%{Source.Arn}"
        }
      }
    }
  ]
}
```

`AWS::Lambda::Function` Da a `AWS::Lambda::Function`  
**Tipo di politica**  
[Politica gestita dal cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) allegata al `AWS::Lambda::Function` ruolo.  
**Categorie di accesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "lambda:InvokeAsync",
        "lambda:InvokeFunction"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::Lambda::Function` Da a `AWS::S3::Bucket`  
**Tipo di politica**  
[Politica gestita dal cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) allegata al `AWS::Lambda::Function` ruolo.  
**Categorie di accesso**  
`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` Da a `AWS::DynamoDB::Table`  
**Tipo di politica**  
[Politica gestita dal cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) allegata al `AWS::Lambda::Function` ruolo.  
**Categorie di accesso**  
`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` Da a `AWS::SQS::Queue`  
**Tipo di politica**  
[Politica gestita dal cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) allegata al `AWS::Lambda::Function` ruolo.  
**Categorie di accesso**  
`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` Da a `AWS::SNS::Topic`  
**Tipo di politica**  
[Politica gestita dal cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) allegata al `AWS::Lambda::Function` ruolo.  
**Categorie di accesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "sns:Publish"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::Lambda::Function` Da a `AWS::StepFunctions::StateMachine`  
**Tipo di politica**  
[Politica gestita dal cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) allegata al `AWS::Lambda::Function` ruolo.  
**Categorie di accesso**  
`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` Da a `AWS::Events::EventBus`  
**Tipo di politica**  
[Politica gestita dal cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) allegata al `AWS::Lambda::Function` ruolo.  
**Categorie di accesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "events:PutEvents"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::Lambda::Function` Da a `AWS::Location::PlaceIndex`  
**Tipo di politica**  
[Politica gestita dal cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) allegata al `AWS::Lambda::Function` ruolo.  
**Categorie di accesso**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "geo:DescribePlaceIndex",
        "geo:GetPlace",
        "geo:SearchPlaceIndexForPosition",
        "geo:SearchPlaceIndexForSuggestions",
        "geo:SearchPlaceIndexForText"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::ApiGatewayV2::Api` Da a `AWS::Lambda::Function`  
**Tipo di politica**  
`[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html)`allegato al`AWS::Lambda::Function`.  
**Categorie di accesso**  
`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` Da a `AWS::Lambda::Function`  
**Tipo di politica**  
`[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html)`allegato al`AWS::Lambda::Function`.  
**Categorie di accesso**  
`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` Da a `AWS::SQS::Queue`  
**Tipo di politica**  
`[AWS::SQS::QueuePolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sqs-queuepolicy.html)`allegato al`AWS::SQS::Queue`.  
**Categorie di accesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "sns.amazonaws.com"
      },
      "Resource": "%{Destination.Arn}",
      "Action": "sqs:SendMessage",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "%{Source.Arn}"
        }
      }
    }
  ]
}
```

`AWS::SNS::Topic` Da a `AWS::Lambda::Function`  
**Tipo di politica**  
`[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html)`allegato al`AWS::Lambda::Function`.  
**Categorie di accesso**  
`Write`  

```
{
  "Action": "lambda:InvokeFunction",
  "Principal": "sns.amazonaws.com",
  "SourceArn": "%{Source.Arn}"
}
```

`AWS::SQS::Queue` Da a `AWS::Lambda::Function`  
**Tipo di politica**  
[Politica gestita dal cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) allegata al `AWS::Lambda::Function` ruolo.  
**Categorie di accesso**  
`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` Da a `AWS::Lambda::Function`  
**Tipo di politica**  
`[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html)`allegato al`AWS::Lambda::Function`.  
**Categorie di accesso**  
`Write`  

```
{
  "Action": "lambda:InvokeFunction",
  "Principal": "s3.amazonaws.com",
  "SourceArn": "%{Source.Arn}",
  "SourceAccount": "${AWS::AccountId}"
}
```

`AWS::StepFunctions::StateMachine` Da a `AWS::Lambda::Function`  
**Tipo di politica**  
[Politica gestita dal cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) allegata al `AWS::StepFunctions::StateMachine` ruolo.  
**Categorie di accesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "lambda:InvokeAsync",
        "lambda:InvokeFunction"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::StepFunctions::StateMachine` Da a `AWS::SNS::Topic`  
**Tipo di politica**  
[Politica gestita dal cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) allegata al `AWS::StepFunctions::StateMachine` ruolo.  
**Categorie di accesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "sns:Publish"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::StepFunctions::StateMachine` Da a `AWS::SQS::Queue`  
**Tipo di politica**  
[Politica gestita dal cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) allegata al `AWS::StepFunctions::StateMachine` ruolo.  
**Categorie di accesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "sqs:SendMessage"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::StepFunctions::StateMachine` Da a `AWS::S3::Bucket`  
**Tipo di politica**  
[Politica gestita dal cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) allegata al `AWS::StepFunctions::StateMachine` ruolo.  
**Categorie di accesso**  
`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` Da a `AWS::DynamoDB::Table`  
**Tipo di politica**  
[Politica gestita dal cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) allegata al `AWS::StepFunctions::StateMachine` ruolo.  
**Categorie di accesso**  
`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` Da a `AWS::StepFunctions::StateMachine`  
**Tipo di politica**  
[Politica gestita dal cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) allegata al `AWS::StepFunctions::StateMachine` ruolo.  
**Categorie di accesso**  
`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` Da a `AWS::Events::EventBus`  
**Tipo di politica**  
[Politica gestita dal cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) allegata al `AWS::StepFunctions::StateMachine` ruolo.  
**Categorie di accesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "events:PutEvents"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::AppSync::DataSource` Da a `AWS::DynamoDB::Table`  
**Tipo di politica**  
[Politica gestita dal cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) allegata al `AWS::AppSync::DataSource` ruolo.  
**Categorie di accesso**  
`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` Da a `AWS::Lambda::Function`  
**Tipo di politica**  
[Politica gestita dal cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) allegata al `AWS::AppSync::DataSource` ruolo.  
**Categorie di accesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "lambda:InvokeAsync",
        "lambda:InvokeFunction"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}:*"
      ]
    }
  ]
}
```

`AWS::AppSync::DataSource` Da a `AWS::Events::EventBus`  
**Tipo di politica**  
[Politica gestita dal cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) allegata al `AWS::AppSync::DataSource` ruolo.  
**Categorie di accesso**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "events:PutEvents"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::AppSync::GraphQLApi` Da a `AWS::Lambda::Function`  
**Tipo di politica**  
`[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html)`allegato al`AWS::Lambda::Function`.  
**Categorie di accesso**  
`Write`  

```
{
  "Action": "lambda:InvokeFunction",
  "Principal": "appsync.amazonaws.com",
  "SourceArn": "arn:${AWS::Partition}:appsync:${AWS::Region}:${AWS::AccountId}:apis/%{Source.ResourceId}"
}
```

# Installazione di Docker da utilizzare con AWS SAMCLI
<a name="install-docker"></a>

Dockerè un'applicazione che esegue contenitori sulla macchina. WithDocker, AWS SAM può fornire un ambiente locale simile a AWS Lambda un contenitore per creare, testare ed eseguire il debug delle applicazioni serverless.

**Nota**  
Dockerè necessario solo per testare le applicazioni localmente e per creare pacchetti di distribuzione utilizzando l'`--use-container`opzione.

**Topics**
+ [

## Installazione di Docker
](#install-docker-instructions)
+ [

## Fasi successive
](#install-docker-next-steps)

## Installazione di Docker
<a name="install-docker-instructions"></a>

Segui queste istruzioni per l'installazione Docker sul tuo sistema operativo.

### Linux
<a name="install-docker-instructions-linux"></a>

Docker è disponibile su molti sistemi operativi diversi, incluse le più moderne distribuzioni Linux, come CentOSDebian, e. Ubuntu Per informazioni sull'installazione Docker su un particolare sistema operativo, consulta [Get Docker sul sito Web di Docker](https://docs.docker.com/get-docker/) Docs.

**Per l'installazione Docker su Amazon Linux 2 o Amazon Linux 2023**

1. Aggiorna i pacchetti installati e la cache dei pacchetti sulla tua istanza.

   ```
   $ sudo yum update -y
   ```

1. Installa il pacchetto Docker Community Edition più recente.
   + Per Amazon Linux 2, esegui quanto segue:

     ```
     $ sudo amazon-linux-extras install docker
     ```
   + Per Amazon Linux 2023, esegui quanto segue:

     ```
     $ sudo yum install -y docker
     ```

1. Avviare il servizio Docker.

   ```
   $ sudo service docker start
   ```

1. Aggiungi il `ec2-user` file al `docker` gruppo in modo da poter eseguire Docker i comandi senza utilizzarli**sudo**.

   ```
   $ sudo usermod -a -G docker ec2-user
   ```

1. Ottieni le nuove autorizzazioni di `docker` gruppo disconnettendoti e riconnetterti. Per fare ciò, chiudi la finestra corrente del terminale SSH e riconnettiti all'istanza in una nuova. La tua nuova sessione SSH dovrebbe avere le autorizzazioni di gruppo appropriate`docker`.

1. Verifica che `ec2-user` possa eseguire i comandi Docker senza utilizzarli. **sudo**

   ```
   $ docker ps
   ```

   Dovresti vedere il seguente output, che conferma che Docker è installato e in esecuzione:

   ```
    CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
   ```

**Nota**  
Su Linux, per creare ed eseguire funzioni Lambda con un'architettura di set di istruzioni diversa rispetto alla macchina host, è necessario configurare ulteriori passaggi. Docker Ad esempio, per eseguire `arm64` funzioni su una `x86_64` macchina, puoi eseguire il seguente comando per configurare il Docker demone:. `docker run --rm --privileged multiarch/qemu-user-static --reset -p yes`

Se riscontri problemi di installazioneDocker, vedi. [Risoluzione degli errori di installazione](install-sam-cli.md#sam-cli-troubleshoot-install) In alternativa, consulta la sezione [Risoluzione dei problemi](https://docs.docker.com/engine/install/linux-postinstall/#troubleshooting) della **procedura successiva all'installazione per Linux** sul sito Web Docker Docs.

### macOS
<a name="install-docker-instructions-macos"></a>

**Nota**  
DockerIl desktop è ufficialmente supportato, ma a partire dalla AWS SAMCLI versione 1.47.0, puoi utilizzare alternative purché utilizzino il runtime. Docker

1. Installazione di Docker

    AWS SAMCLISupporta l'Dockeresecuzione su macOS Sierra 10.12 o versioni successive. Per informazioni sull'installazioneDocker, consulta [Install Docker Desktop for Mac sul sito](https://docs.docker.com/docker-for-mac/install/) Web di Docker Docs.

1. Configura le unità condivise

    AWS SAMCLIRichiede che la directory del progetto, o qualsiasi directory principale, sia elencata in un'unità condivisa. Ciò potrebbe richiedere la condivisione di file. Per ulteriori informazioni, consulta l'argomento sulla risoluzione dei problemi relativi al [montaggio di volumi che richiede la condivisione dei file](https://docs.docker.com/desktop/troubleshoot-and-support/troubleshoot/topics/#volume-mounting-requires-file-sharing-for-any-project-directories-outside-of-home) nella *Dockerdocumentazione.*

1. Verifica dell'installazione

   Dopo Docker l'installazione, verifica che funzioni. Verifica inoltre che sia possibile eseguire Docker comandi dalla riga di comando (ad esempio,`docker ps`). Non è necessario installare, recuperare o scaricare alcun contenitore: lo AWS SAMCLI fa automaticamente come richiesto.

In caso di problemi durante l'installazioneDocker, per ulteriori suggerimenti sulla risoluzione dei problemi, consulta la sezione [Risoluzione dei problemi e diagnosi](https://docs.docker.com/docker-for-mac/troubleshoot/) del sito Web di Docs. Docker

### Windows
<a name="install-docker-instructions-windows"></a>

**Nota**  
AWS SAM supporta ufficialmente Desktop. Docker Tuttavia, a partire dalla AWS SAMCLI versione 1.47.0, è possibile utilizzare alternative purché utilizzino il Docker runtime.

1. Installare Docker.

   DockerDesktop supporta il sistema operativo Windows più recente. Per le versioni precedenti di Windows, è disponibile il Docker Toolbox. Scegli la tua versione di Windows per i passaggi di Docker installazione corretti:
   + Per l'installazione Docker per Windows 10, vedi [Installare Docker Desktop per Windows](https://docs.docker.com/docker-for-windows/install/) sul sito Web di Docker Docs.
   + Per l'installazione Docker per le versioni precedenti di Windows, consulta [The Docker Toolbox](https://github.com/docker-archive/toolbox) nell'archivio Docker GitHub Toolbox.

1. Configura le tue unità condivise.

    AWS SAMCLIRichiede che la directory del progetto, o qualsiasi directory principale, sia elencata in un'unità condivisa. In alcuni casi, è necessario condividere l'unità Docker per funzionare correttamente.

1. Verifica l'installazione.

   Dopo Docker l'installazione, verifica che funzioni. Verifica inoltre che sia possibile eseguire Docker comandi dalla riga di comando (ad esempio,**docker ps**). Non è necessario installare, recuperare o scaricare alcun contenitore: lo AWS SAMCLI fa automaticamente come richiesto.

In caso di problemi durante l'installazioneDocker, per ulteriori suggerimenti sulla risoluzione dei problemi, consulta la sezione [Risoluzione dei problemi e diagnosi](https://docs.docker.com/docker-for-mac/troubleshoot/) del sito Web di Docs. Docker

## Fasi successive
<a name="install-docker-next-steps"></a>

Per informazioni su come installare, consulta. AWS SAMCLI [Installa il AWS SAMCLI](install-sam-cli.md)

# Installazione Finch per l'uso con la AWS SAM CLI
<a name="install-finch"></a>

Finch AWSè lo strumento di sviluppo di container che fornisce un'alternativaDocker, particolarmente utile, sui sistemi macOS e Linux. Per ulteriori informazioni, vedere [Finch on. GitHub](https://github.com/runfinch) ConFinch, AWS SAM può fornire un ambiente locale simile a AWS Lambda un contenitore per creare, testare ed eseguire il debug delle applicazioni serverless.

**Nota**  
È necessario testare Finch le applicazioni localmente, creare pacchetti di distribuzione utilizzando l'`--use-container`opzione e creare funzioni di immagine OCI. A partire dalla versione AWS SAM CLI 1.145.0, AWS SAM CLI Finch supporta come alternativa il runtime del contenitore a. Docker

**Topics**
+ [

## Installazione di Finch
](#install-finch-instructions)
+ [

## Configurazione Finch con CLI AWS SAM
](#install-finch-configuration)
+ [

## Verifica dell'installazione
](#install-finch-verification)
+ [

## Interrompere Finch
](#install-finch-stopping)
+ [

## Risoluzione dei problemi
](#install-finch-troubleshooting)
+ [

## Fasi successive
](#install-finch-next-steps)

## Installazione di Finch
<a name="install-finch-instructions"></a>

Segui queste istruzioni per l'installazione Finch sul tuo sistema operativo.

### Prerequisiti
<a name="install-finch-prerequisites"></a>

**Nota**  
Finchl'integrazione nella AWS SAM CLI è disponibile su sistemi macOS e Linux. Per gli utenti Windows, valuta la possibilità di utilizzare una macchina virtuale o un ambiente Linux per Finch motivi di funzionalità.

**Versioni macOS:**
+ macOS 15 Sequoia
+ macOS 14 Sonoma

**Nota**  
Finchsupporta le ultime due versioni di macOS.

**Linux**:
+ Linux Kernel v4.x\$1

### Installazione di Finch
<a name="install-finch"></a>

#### macOS
<a name="install-finch-instructions-macos"></a>

**Per installare Finch su macOS**

1. Installa Finch utilizzando la `brew` CLI. Se richiesto, inserisci la password di macOS.

   ```
   $ brew install finch
   ```

1. Controlla la versione installata. Finch

   ```
   $ finch --version
   ```

1. Inizializza la macchina Finch virtuale (prima configurazione).

   ```
   $ finch vm init
   ```

1. Avvia la macchina Finch virtuale.

   ```
   $ finch vm start
   ```

1. Controlla lo stato della macchina Finch virtuale.

   ```
   $ finch vm status
   ```

1. Verifica che Finch funzioni correttamente.

   ```
   $ finch --info
   $ finch ps
   ```

Per ulteriori informazioni, consulta [Installazione di Finch su macOS](https://runfinch.com/docs/managing-finch/macos/installation/).

#### Linux
<a name="install-finch-instructions-linux"></a>

Puoi eseguire l'installazione Finch su Amazon Linux, Ubuntu o utilizzando un metodo di installazione generico. Per ulteriori informazioni, consulta [Installazione di Finch su Linux](https://runfinch.com/docs/managing-finch/linux/installation/).

## Configurazione Finch con CLI AWS SAM
<a name="install-finch-configuration"></a>

Dopo l'installazioneFinch, la AWS SAM CLI rileva e utilizza automaticamente Finch come runtime del contenitore quando Docker non viene eseguita.

**Nota**  
Finchfunge da riserva a. Docker Se le hai entrambe Finch installate Docker e funzionanti, la AWS SAM CLI dà la priorità Docker per impostazione predefinita.

### Configurazione delle preferenze dell'amministratore (macOS)
<a name="install-finch-configuration-preference"></a>

È possibile configurare la AWS SAM CLI per utilizzare un runtime di contenitore specifico come predefinito creando un file delle preferenze dell'amministratore. Questa preferenza a livello di sistema sostituisce il comportamento di fallback predefinito.

**Opzioni di configurazione disponibili**
+ **Imposta Finch come runtime preferito del contenitore:**

  ```
  $ sudo /usr/libexec/PlistBuddy -c "Add :DefaultContainerRuntime string finch" /Library/Preferences/com.amazon.samcli.plist
  ```
+ **Imposta Docker come runtime preferito del contenitore:**

  ```
  $ sudo /usr/libexec/PlistBuddy -c "Add :DefaultContainerRuntime string docker" /Library/Preferences/com.amazon.samcli.plist
  ```
+ **Rimuovi preferenza (ritorno al comportamento predefinito):**

  ```
  $ sudo /usr/libexec/PlistBuddy -c "Remove :DefaultContainerRuntime" /Library/Preferences/com.amazon.samcli.plist
  ```

**Nota**  
Quando non è impostata alcuna preferenza dell'amministratore, la AWS SAM CLI utilizza Docker per impostazione predefinita quando disponibile, Finch mentre come riserva quando non Docker è in esecuzione.

### Differenze di montaggio delle directory (macOS)
<a name="install-finch-differences"></a>

Su macOS, i comandi AWS SAM locali falliscono se localizzi il progetto fuori dalla tua home directory (`~`) o. `/Volumes` Questo design limita il montaggio automatico delle directory per motivi di sicurezza a tua insaputa.

**Opzioni di mitigazione**
+ **Opzione 1:** apri la configurazione di Finch in un editor di testo `~/.finch/finch.yaml` e aggiungi il percorso del progetto nella `additional_directories` sezione, quindi riavvia la Finch macchina virtuale. Per ulteriori informazioni, consultate la documentazione di [Finch.](https://runfinch.com/docs/managing-finch/macos/disk-management/#adding-additional-disk-mounts)

  ```
  $ finch vm stop
  $ finch vm start
  ```
+ **Opzione 2:** spostate il progetto nella vostra home directory.

## Verifica dell'installazione
<a name="install-finch-verification"></a>

Dopo l'installazione e l'avvioFinch, verifica che funzioni con la AWS SAM CLI.

### Verifica di base
<a name="install-finch-verification-basic"></a>

Esegui il comando seguente per verificare che la AWS SAM CLI possa utilizzare: Finch

```
$ sam build --use-container
```

Dovresti vedere l'uso della AWS SAM CLI Finch per creare la tua applicazione in un ambiente container.

**Nota**  
Finchfunge da riserva a. Docker Se Docker è in esecuzione, la AWS SAM CLI assegnerà la priorità Docker per impostazione predefinita.

### Test Finch come fallback
<a name="install-finch-verification-fallback"></a>

Per eseguire Finch il test come fallback quando Docker è in esecuzione, devi prima Docker fermarti.

**Per testare la funzionalità di Finch fallback**

1. Smetti Docker di usare i comandi appropriati per il tuo sistema operativo.

   **macOS:**

   ```
   $ docker stop $(docker ps -q)
   $ pkill -f "Docker Desktop"
   ```

   DockerLa verifica è stata interrotta.

   ```
   $ docker ps
   ```

   **Linux**:

   ```
   $ docker stop $(docker ps -q)
   $ sudo systemctl stop docker
   ```

   DockerLa verifica è stata interrotta.

   ```
   $ sudo systemctl status docker
   ```

1. Esegui il `sam build --use-container` comando per verificare che la AWS SAM CLI venga utilizzata automaticamente Finch come fallback.

## Interrompere Finch
<a name="install-finch-stopping"></a>

Se devi fermartiFinch, usa i seguenti comandi:

**macOS:**

```
$ finch vm stop
$ sudo pkill -f finch
```

FinchLa verifica è stata interrotta.

```
$ finch vm status
```

**Linux**:

```
$ sudo systemctl stop finch
$ sudo pkill -f finch
```

FinchLa verifica è stata interrotta.

```
$ sudo systemctl status finch
```

## Risoluzione dei problemi
<a name="install-finch-troubleshooting"></a>

Se riscontri problemi conFinch:
+ Verifica che il tuo sistema operativo soddisfi i prerequisiti.
+ Verifica di aver abilitato la virtualizzazione sul tuo sistema.
+ Per macOS, verifica di disporre di spazio su disco sufficiente per la macchina virtuale.
+ Per Linux, verifica di disporre delle autorizzazioni appropriate per eseguire `systemctl` i comandi.
+ Se riscontri errori di CloudFormation distribuzione con errori «tipo di supporto non supportato» quando invii immagini multiarchitettura ad Amazon Elastic Container Registry (Amazon ECR), crea un singolo elemento di immagine anziché utilizzare immagini multiarchitettura. Ciò si verifica perché Finch invia sia l'indice dell'immagine che l'immagine ad Amazon ECR, mentre Docker invia solo l'immagine.
+ Se la creazione multipiattaforma fallisce quando l'architettura della funzione di destinazione non corrisponde all'architettura della macchina host su Linux, abilita l'emulazione multipiattaforma eseguendo. `sudo finch run --privileged --rm tonistiigi/binfmt:master --install all`

Per ulteriori informazioni sulla risoluzione dei problemi, consulta la documentazione di [Finch o](https://runfinch.com/docs/) il. [AWS SAMCLIrisoluzione dei problemi](sam-cli-troubleshooting.md)

## Fasi successive
<a name="install-finch-next-steps"></a>

Ora che hai Finch installato, puoi usarlo con la AWS SAM CLI per:
+ Crea applicazioni serverless utilizzando contenitori con. `sam build --use-container` Per ulteriori informazioni, consulta [sam build](sam-cli-command-reference-sam-build.md).
+ Testa le funzioni Lambda localmente con. `sam local invoke` Per ulteriori informazioni, consulta [sam local invoke](sam-cli-command-reference-sam-local-invoke.md).
+ Avvia un API Gateway locale con`sam local start-api`. Per ulteriori informazioni, consulta [sam local start-api](sam-cli-command-reference-sam-local-start-api.md).
+ Avvia un endpoint Lambda locale con. `sam local start-lambda` Per ulteriori informazioni, consulta [sam local start-lambda](sam-cli-command-reference-sam-local-start-lambda.md).

Per ulteriori informazioni sull'utilizzo della AWS SAM CLI con i contenitori, consulta. [Compilazione predefinita con AWS SAM](serverless-sam-cli-using-build.md)

# Archivi di immagini per AWS SAM
<a name="serverless-image-repositories"></a>

AWS SAM semplifica le attività di integrazione continua e distribuzione continua (CI/CD) per applicazioni serverless con l'aiuto della creazione di immagini di container. Le immagini AWS SAM fornite includono l'interfaccia a riga di AWS SAM comando (CLI) e gli strumenti di compilazione per una serie di runtime supportati AWS Lambda . Ciò semplifica la creazione e il confezionamento di applicazioni serverless utilizzando. AWS SAMCLI È possibile utilizzare queste immagini con CI/CD i sistemi per automatizzare la creazione e la distribuzione di AWS SAM applicazioni. Per alcuni esempi, consulta [Implementa con CI/CD sistemi e pipeline](deploying-options.md#serverless-deploying-ci-cd).

AWS SAM URIs le immagini del contenitore di build sono contrassegnate con la versione AWS SAMCLI inclusa in quell'immagine. Se si specifica l'URI senza tag, viene utilizzata la versione più recente. Ad esempio, `public.ecr.aws/sam/build-nodejs20.x` utilizza l'immagine più recente. Tuttavia, `public.ecr.aws/sam/build-nodejs20.x:1.24.1` utilizza l'immagine contenente la versione AWS SAM CLI 1.24.1.

A partire dalla versione 1.33.0 di AWS SAMCLI, entrambe le immagini `x86_64` e quelle del `arm64` contenitore sono disponibili per i runtime supportati. *Per ulteriori informazioni, consulta [Lambda runtimes](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html) nella Developer Guide.AWS Lambda *

**Nota**  
Prima della versione 1.22.0 di AWS SAMCLI, DockerHub era il repository predefinito da cui AWS SAMCLI estraevano l'immagine del contenitore. A partire dalla versione 1.22.0, l'archivio predefinito è cambiato in Amazon Elastic Container Registry Public (Amazon ECR Public). Per estrarre l'immagine di un contenitore da un repository diverso da quello predefinito corrente, puoi utilizzare il comando con l'**[sam build](sam-cli-command-reference-sam-build.md)**opzione. **--build-image** Gli esempi alla fine di questo argomento mostrano come creare applicazioni utilizzando immagini di DockerHub repository.

## Archivio di immagini URIs
<a name="serverless-image-repository-uris"></a>

La tabella seguente elenca le immagini URIs dei container di build [Amazon ECR Public](https://docs.aws.amazon.com/AmazonECR/latest/public/what-is-ecr.html) che puoi usare per creare e impacchettare applicazioni serverless. AWS SAM

**Nota**  
Amazon ECR Public è stato sostituito DockerHub a partire dalla AWS SAMCLI versione 1.22.0. Se utilizzi una versione precedente di AWS SAMCLI, ti consigliamo di effettuare l'aggiornamento.


| Runtime |  Amazon ECR Public | 
| --- | --- | 
| Runtime personalizzato (AL2023) | [public.ecr. aws/sam/build- fornito dal 2023](https://gallery.ecr.aws/sam/build-provided.al2023) | 
| Runtime personalizzato (AL2) | [public.ecr. aws/sam/build- fornito.al2](https://gallery.ecr.aws/sam/build-provided.al2) | 
| Runtime personalizzato | [pubblico.ecr. aws/sam/build-fornito](https://gallery.ecr.aws/sam/build-provided) | 
| Java 25 | [pubblico.ecr. aws/sam/build-java25](https://gallery.ecr.aws/sam/build-java25) | 
| Java 21 | [public.ecr. aws/sam/build-java21](https://gallery.ecr.aws/sam/build-java21) | 
| Java 17 | [public.ecr. aws/sam/build-java17](https://gallery.ecr.aws/sam/build-java17) | 
| Java 11 | [public.ecr. aws/sam/build-java11](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 | [pubblico.ecr. aws/sam/build-dotnet9](https://gallery.ecr.aws/sam/build-dotnet9) | 
| .NET 8 | [public.ecr. aws/sam/build-dotnet8](https://gallery.ecr.aws/sam/build-dotnet8) | 
| .NET 7 | [public.ecr. aws/sam/build-dotnet7](https://gallery.ecr.aws/sam/build-dotnet7) | 
| .NET 6 | [public.ecr. aws/sam/build-dotnet6](https://gallery.ecr.aws/sam/build-dotnet6) | 
| Node.js 24 | [pubblico.ecr. aws/sam/build-nodejs24.x](https://gallery.ecr.aws/sam/build-nodejs24.x) | 
| Node.js 22 | [public.ecr. aws/sam/build-nodejs 22.x](https://gallery.ecr.aws/sam/build-nodejs22.x) | 
| Node.js 20 | [public.ecr. aws/sam/build-nodejs 20.x](https://gallery.ecr.aws/sam/build-nodejs20.x) | 
| Node.js 18 | [public.ecr. aws/sam/build-nodejs 18.x](https://gallery.ecr.aws/sam/build-nodejs18.x) | 
| Node.js 16 | [public.ecr. aws/sam/build-nodejs 16.x](https://gallery.ecr.aws/sam/build-nodejs16.x) | 
| Python 3.14 | [public.ecr. aws/sam/build-python3.14](https://gallery.ecr.aws/sam/build-python3.14) | 
| Python 3.13 | [public.ecr. aws/sam/build-python3.13](https://gallery.ecr.aws/sam/build-python3.13) | 
| Python 3.12 | [public.ecr. aws/sam/build-python3.12](https://gallery.ecr.aws/sam/build-python3.12) | 
| Python 3.11 | [pubblico.ecr. aws/sam/build-python3.11](https://gallery.ecr.aws/sam/build-python3.11) | 
| Python 3.10 | [pubblico.ecr. aws/sam/build-python 3.10](https://gallery.ecr.aws/sam/build-python3.10) | 
| Python 3.9 | [pubblico.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-python3.9)-python3.9 | 
| Python 3.8 | [pubblico.ecr. aws/sam/build](https://gallery.ecr.aws/sam/build-python3.8)-python3.8 | 
| Rubino 3.4 | [public.ecr. aws/sam/build- rubino 3.4](https://gallery.ecr.aws/sam/build-ruby3.4) | 
| Ruby 3.3 | [public.ecr. aws/sam/build- ruby 3.3](https://gallery.ecr.aws/sam/build-ruby3.3) | 
| Ruby 3.2 | [public.ecr. aws/sam/build- rubino 3.2](https://gallery.ecr.aws/sam/build-ruby3.2) | 

## Esempi
<a name="serverless-image-repository-example-commands"></a>

I due comandi di esempio seguenti creano applicazioni utilizzando immagini di contenitori dal repository di immagini:

**Crea un'Node.js 24applicazione utilizzando un'immagine del contenitore estratta da Amazon ECR**:

```
$ sam build --use-container --build-image public.ecr.aws/sam/build-nodejs24.x
```

**Crea una risorsa funzionale utilizzando l'immagine del Python 3.14 contenitore estratta da Amazon ECR**:

```
$ sam build --use-container --build-image Function1=public.ecr.aws/sam/build-python3.14
```

# Implementazione graduale di applicazioni serverless con AWS SAM
<a name="automating-updates-to-serverless-apps"></a>

AWS Serverless Application Model (AWS SAM) è integrato [CodeDeploy](https://docs.aws.amazon.com/codedeploy/latest/userguide/welcome.html)per fornire implementazioni graduali AWS Lambda . Con solo poche righe di configurazione, AWS SAM esegue le seguenti operazioni per te:
+ Implementa nuove versioni della funzione Lambda e crea automaticamente alias che rimandano alla nuova versione.
+ Sposta gradualmente il traffico dei clienti verso la nuova versione fino a quando non sei sicuro che funzioni come previsto. Se un aggiornamento non funziona correttamente, puoi ripristinare le modifiche.
+ Definisce le funzioni di test precedenti e successivi al traffico per verificare che il codice appena distribuito sia configurato correttamente e che l'applicazione funzioni come previsto.
+ Ripristina automaticamente la distribuzione se vengono attivati degli CloudWatch allarmi.

**Nota**  
Se abiliti le distribuzioni graduali tramite il tuo AWS SAM modello, viene creata automaticamente una CodeDeploy risorsa per te. È possibile visualizzare la CodeDeploy risorsa direttamente tramite. Console di gestione AWS

**Esempio**

L'esempio seguente dimostra l'utilizzo della funzione CodeDeploy Lambda per spostare gradualmente i clienti verso la versione appena distribuita della funzione 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
```

Queste revisioni del AWS SAM modello eseguono le seguenti operazioni:
+ `AutoPublishAlias`: Aggiungendo questa proprietà e specificando un nome alias,: AWS SAM
  + Rileva quando viene distribuito un nuovo codice, in base alle modifiche all'URI Amazon S3 della funzione Lambda.
  + Crea e pubblica una versione aggiornata di quella funzione con il codice più recente.
  + Crea un alias con un nome fornito dall'utente (a meno che non esista già un alias) e punta alla versione aggiornata della funzione Lambda. Per sfruttare questa funzionalità, le invocazioni della funzione devono utilizzare il qualificatore dell'alias. Se non conosci il controllo delle versioni e gli alias delle funzioni Lambda, consulta Versionamento e alias delle [AWS Lambda funzioni](https://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html).
+ `Deployment Preference Type`: Nell'esempio precedente, il 10% del traffico dei clienti viene immediatamente spostato sulla nuova versione. Dopo 10 minuti, tutto il traffico viene spostato sulla nuova versione. Tuttavia, se i test pre-traffico o post-traffico falliscono o se viene attivato un CloudWatch allarme, ripristina la distribuzione CodeDeploy . Puoi specificare in che modo il traffico deve essere spostato tra le versioni nei seguenti modi:
  + `Canary`: il traffico viene trasferito in due incrementi. Puoi scegliere tra opzioni canarie predefinite. Le opzioni specificano la percentuale di traffico che viene trasferita alla versione aggiornata della funzione Lambda nel primo incremento e l'intervallo, in minuti, prima che il traffico rimanente venga spostato nel secondo incremento. 
  + `Linear`: il traffico viene trasferito in incrementi uguali con lo stesso intervallo di tempo, in minuti, tra ciascun incremento. Puoi scegliere tra opzioni lineari predefinite che specificano la percentuale di traffico che viene spostata in ogni incremento e il numero di minuti tra ogni incremento. 
  + `AllAtOnce`: tutto il traffico viene spostato contemporaneamente dalla funzione Lambda originale alla versione aggiornata della funzione Lambda. 

  La tabella seguente descrive altre opzioni di spostamento del traffico disponibili oltre a quella utilizzata nell'esempio.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/serverless-application-model/latest/developerguide/automating-updates-to-serverless-apps.html)
+ `Alarms`: Si tratta di CloudWatch allarmi che vengono attivati da eventuali errori generati dalla distribuzione. Quando vengono rilevati, ripristinano automaticamente la distribuzione. Ad esempio, se il codice aggiornato che stai distribuendo causa errori all'interno dell'applicazione. Un altro esempio è se alcune [AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/monitoring-functions-metrics.html) CloudWatch metriche personalizzate che hai specificato hanno superato la soglia di allarme.
+ `Hooks`: Si tratta di funzioni di test prima e dopo il traffico che eseguono controlli prima che il cambio di traffico inizi a passare alla nuova versione e dopo il completamento del cambio di traffico.
  + `PreTraffic`: prima che inizi lo spostamento del traffico, CodeDeploy richiama la funzione Lambda pre-traffic hook. Questa funzione Lambda deve richiamare CodeDeploy e indicare l'esito positivo o negativo. Se la funzione fallisce, si interrompe e riporta un errore a. CloudFormation Se la funzione ha esito positivo, si CodeDeploy procede allo spostamento del traffico.
  + `PostTraffic`: una volta completato lo spostamento del traffico, CodeDeploy richiama la funzione Lambda post-traffic hook. È simile al pre-traffic hook, in cui la funzione deve richiamare a per segnalare CodeDeploy un esito positivo o negativo. Utilizzare gli hook post-traffico per eseguire i test di integrazione o altre operazioni di convalida.

  Per ulteriori informazioni, consultare la [documentazione di riferimento delle SAM per distribuzioni sicure](https://github.com/aws/serverless-application-model/blob/master/docs/safe_lambda_deployments.rst). 

## Implementazione graduale di una funzione Lambda per la prima volta
<a name="automating-updates-to-serverless-apps-first-time"></a>

 Quando si implementa gradualmente una funzione Lambda CodeDeploy , è necessaria una versione della funzione precedentemente distribuita da cui spostare il traffico. Pertanto, la prima implementazione deve essere eseguita in due fasi: 
+ **Passaggio 1**: implementa la funzione Lambda e crea automaticamente alias con. `AutoPublishAlias`
+ **Fase 2**: Esegui la distribuzione graduale con. `DeploymentPreference`

Eseguendo la prima implementazione graduale in due fasi si ottiene CodeDeploy una versione precedente della funzione Lambda da cui spostare il traffico.

### Fase 1: Implementa la funzione 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
```

### Fase 2: Esegui la distribuzione graduale
<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
```

## Ulteriori informazioni
<a name="automating-updates-to-serverless-apps-learn"></a>

*Per un esempio pratico di configurazione di una distribuzione graduale, consulta il [Modulo 5 - Canary Deployments](https://s12d.com/sam-ws-en-canaries) in The Complete Workshop. AWS SAM *

# Note di riferimento importanti per AWS SAM
<a name="important-notes"></a>

Questa sezione contiene note e annunci importanti per AWS Serverless Application Model ()AWS SAM.

**Topics**
+ [

## Note importanti per il 2023
](#important-notes-2023)

## Note importanti per il 2023
<a name="important-notes-2023"></a>

### Ottobre 2023
<a name="important-notes-2023-10"></a>

#### AWS SAMCLIinterruzione del supporto per Python 3.7
<a name="important-notes-2023-10-python"></a>

*Pubblicato il 2023-10-20*

Python 3.7ha ricevuto end-of-life lo status nel giugno del 2023. Il supporto AWS SAM CLI interromperà Python 3.7 il 24 ottobre 2023. Per ulteriori informazioni, consulta l'[annuncio pubblicato](https://github.com/aws/aws-sam-cli/issues/5889) nel *aws-sam-cli GitHubrepository*.

Questa modifica riguarda i seguenti utenti:
+ Se si utilizza Python 3.7 e si installa il AWS SAM CLI through`pip`.
+ Se lo usi `aws-sam-cli` come libreria e crei la tua applicazione conPython 3.7.

Se la installate e la AWS SAM CLI gestite con un altro metodo, non ne risentite.

Agli utenti interessati, consigliamo di aggiornare l'ambiente di sviluppo a Python 3.8 o a una versione più recente.

Questa modifica non influisce sul supporto per l'ambiente Python 3.7 AWS Lambda di runtime. *Per ulteriori informazioni, consulta la [politica di deprecazione del Runtime](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy) nella Developer Guide.AWS Lambda *