

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à.

# sam init

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

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

**Importante**  
Non usare `sam init` con modelli provenienti da fonti non attendibili. Un modello personalizzato, ad esempio quello specificato con `--location`, può eseguire hook nell'ambiente locale durante la generazione del progetto.

## 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 `--location` non è fornito.  
Questo parametro è disponibile solo in AWS SAM CLI 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 Amazon CloudWatch Monitoraggio di 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 Lambda Event Functions della tua applicazione. Specifica uno dei `x86_64` o `arm64`.

`--base-image {{[ amazon/dotnet8-base | amazon/dotnet6-base | amazon/java25-base | amazon/java21-base | amazon/java17-base | amazon/java17.al2023-base | amazon/java11-base | amazon/java11.al2023-base | amazon/java8.al2023-base | amazon/nodejs26.x-base | amazon/nodejs24.x-base | amazon/nodejs22.x-base | amazon/nodejs20.x-base | amazon/nodejs18.x-base | amazon/nodejs16.x-base | amazon/python3.15-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/ruby4.0-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 della tua 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 `--location` non è 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 che AWS SAM CLI genera e visualizza i 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>
Sostituisci qualsiasi parametro personalizzato nel modello `cookiecutter.json` configurazione, 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 sono forniti.  
Per i repository Git, è necessario utilizzare la posizione della radice del repository.  
Per i percorsi locali, il modello deve essere contenuto in un file .zip o [Tagliabiscotti](https://cookiecutter.readthedocs.io/en/latest/README.html) formato.

`--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 `--location` non è 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>
Disattiva la richiesta interattiva per i parametri di inizializzazione e fallisce se mancano i valori richiesti.

`--output {{[ text | json ]}}`  <a name="sam-cli-command-reference-sam-init-options-output"></a>
Il formato dell'output del comando:  
+ `text` — Stampa un output regolare e leggibile dall'uomo. Si tratta del valore di default.
+ `json` — Stampa un output strutturato e leggibile dalla macchina. Utilizza questo formato quando desideri utilizzare l'output a livello di programmazione, ad esempio in CI/CD pipeline, estensioni IDE e AI-assisted strumenti.
Quando si specifica `--output json`, il AWS SAM CLI stampa un singolo oggetto JSON dopo il completamento del comando. In caso di successo, questo oggetto include campi come la directory del progetto e il file modello. È possibile concatenare l'output in comandi successivi come `sam build`. In caso di fallimento, include un `error` oggetto che descrive cosa è andato storto.  
La `--output json` l'opzione non è compatibile con il flusso di lavoro interattivo. Per utilizzarla, specifica un'esecuzione completamente non interattiva fornendo tutte le opzioni richieste.

`--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 contenitore.

`--runtime, -r {{[ dotnet8 | dotnet6 | java25 | java21 | java17 | java17.al2023 | java11 | java11.al2023 | java8.al2023 | nodejs26.x | nodejs24.x | nodejs22.x | nodejs20.x | nodejs18.x | nodejs16.x | python3.15 | python3.14 | python3.13 | python3.12 | python3.11 | python3.10 | python3.9 | python3.8 | ruby4.0 | 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 `--location` non è specificato.

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

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

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

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