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 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)