As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

Esta página fornece informações de referência para o AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam init`.
+ Para obter uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Para obter a documentação sobre o uso do AWS SAMCLI `sam init` comando, consulte[Crie seu aplicativo em AWS SAM](using-sam-cli-init.md).

O comando `sam init` fornece opções para inicializar um novo aplicativo sem servidor.

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

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

## Opções
<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>
O identificador do modelo de aplicativo gerenciado que você deseja usar. Se você não tiver certeza, chame `sam init` sem opções para um fluxo de trabalho interativo.  
Esse parâmetro é obrigatório se `--no-interactive` for especificado e `--location` não for fornecido.  
Esse parâmetro só está disponível na versão 0.30.0 e posterior do AWS SAM CLI. A especificação desse parâmetro com uma versão anterior resulta em um erro.

`--application-insights | --no-application-insights`  <a name="sam-cli-command-reference-sam-init-options-application-insights"></a>
 Ative o monitoramento CloudWatch do Amazon Application Insights para seu aplicativo. Para saber mais, consulte [Usando o CloudWatch Application Insights para monitorar seus aplicativos AWS SAM sem servidor](monitor-app-insights.md).   
 A opção padrão é `--no-application-insights`. 

`--architecture, -a [ x86_64 | arm64 ]`  <a name="sam-cli-command-reference-sam-init-options-architecture"></a>
A arquitetura do conjunto de instruções para as funções do Lambda do seu aplicativo. Especifique um dos `x86_64` ou `arm64`.

`--base-image [ amazon/dotnet8-base | amazon/dotnet6-base | amazon/java25-base | amazon/java21-base | amazon/java17-base | amazon/java11-base | amazon/nodejs24.x-base | amazon/nodejs22.x-base | amazon/nodejs20.x-base | amazon/nodejs18.x-base | amazon/nodejs16.x-base | amazon/python3.14-base | amazon/python3.13-base | amazon/python3.12-base | amazon/python3.11-base | amazon/python3.10-base | amazon/python3.9-base | amazon/python3.8-base | amazon/ruby3.4-base | amazon/ruby3.3-base | amazon/ruby3.2-base ]`  <a name="sam-cli-command-reference-sam-init-options-base-image"></a>
A imagem base do seu aplicativo. Essa opção se aplica somente quando o tipo de pacote é `Image`.  
Esse parâmetro é necessário se `--no-interactive` for especificado, `--package-type` for especificado como `Image` e `--location` não for especificado.

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-init-options-config-env"></a>
O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados. O valor padrão é “padrão”. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-init-options-config-file"></a>
O caminho e o nome do arquivo de configuração contendo valores de parâmetros padrão a serem usados. O valor padrão é “samconfig.toml” na raiz do diretório do projeto. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-init-options-debug"></a>
Ativa o registro de depuração para imprimir as mensagens de depuração que o AWS SAM CLI gera e para exibir timestamps.

`--dependency-manager, -d [ gradle | mod | maven | bundler | npm | cli-package | pip ]`  <a name="sam-cli-command-reference-sam-init-options-dependency-manager"></a>
O gerenciador de dependências do seu tempo de execução do Lambda.

`--extra-content`  <a name="sam-cli-command-reference-sam-init-options-extra-content"></a>
Substitua quaisquer parâmetros personalizados na configuração `cookiecutter.json` do modelo, por exemplo, `{"customParam1": "customValue1", "customParam2":"customValue2"}`.

`--help, -h`  <a name="sam-cli-command-reference-sam-init-options-help"></a>
Mostra esta mensagem e sai.

`--location, -l TEXT`  <a name="sam-cli-command-reference-sam-init-options-location"></a>
O local doo modelo ou aplicativo (Git, Mercurial, HTTP/HTTPS, arquivo.zip, caminho).  
Esse parâmetro é necessário se `--no-interactive` for especificado e `--runtime`,`--name`, e `--app-template` não for fornecido.  
Para repositórios Git, você deve usar a localização da raiz do repositório.  
Para caminhos locais, o modelo deve estar no formato de arquivo.zip ou [Cookiecutter](https://cookiecutter.readthedocs.io/en/latest/README.html).

`--name, -n TEXT`  <a name="sam-cli-command-reference-sam-init-options-name"></a>
O nome do seu projeto a ser gerado como um diretório.  
Esse parâmetro é obrigatório se `--no-interactive` for especificado e `--location` não for fornecido.

`--no-input`  <a name="sam-cli-command-reference-sam-init-options-no-input"></a>
Desativa a solicitação do Cookiecutter e aceita os valores vcfdefault que são definidos na configuração do modelo.

`--no-interactive`  <a name="sam-cli-command-reference-sam-init-options-no-interactive"></a>
Desative a solicitação interativa para os parâmetros de inicialização e falha se algum valor necessário estiver ausente.

`--output-dir, -o PATH`  <a name="sam-cli-command-reference-sam-init-options-output-dir"></a>
O local em que o aplicativo inicializado é gerado.

`--package-type [ Zip | Image ]`  <a name="sam-cli-command-reference-sam-init-options-package-type"></a>
O tipo de pacote do aplicativo de exemplo. `Zip` cria um arquivo .zip e `Image` cria uma imagem de contêiner.

`--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>
O tempo de execução do Lambda do seu aplicativo. Essa opção se aplica somente quando o tipo de pacote é `Zip`.  
Esse parâmetro é necessário se `--no-interactive` for especificado, `--package-type` for especificado como `Zip` e `--location` não for especificado.

`--save-params`  <a name="sam-cli-command-reference-sam-init-options-save-params"></a>
Salve os parâmetros que você fornece na linha de comando no arquivo AWS SAM de configuração.

`--tracing | --no-tracing`  <a name="sam-cli-command-reference-sam-init-options-tracing"></a>
Ative o AWS X-Ray rastreamento para suas funções do Lambda.

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

Para obter um exemplo detalhado e uma explicação aprofundada sobre o uso do subcomando `sam init`, consulte [Crie seu aplicativo em AWS SAM](using-sam-cli-init.md).