Este é o Guia do desenvolvedor do AWS CDK v2. O CDK v1 antigo entrou em manutenção em 1º de junho de 2022 e encerrou o suporte em 1º de junho de 2023.

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

# Referência de comandos da CLI do AWS CDK
<a name="ref-cli-cmd"></a>

Esta seção contém informações de referência para a interface de linha de comandos (CLI) do kit de desenvolvimento em nuvem da AWS (CDK da AWS). A CLI do CDK também é conhecida como Kit de Ferramentas CDK.

## Uso
<a name="ref-cli-cmd-usage"></a>

```
$ cdk <command> <arguments> <options>
```

## Comandos
<a name="ref-cli-cmd-commands"></a><a name="ref-cli-cmd-commands-acknowledge"></a>

 ` acknowledge ack `   
Reconheça um aviso pelo número do problema e oculte-o de ser exibido novamente.<a name="ref-cli-cmd-commands-bootstrap"></a>

 ` bootstrap `   
Prepare um ambiente da AWS para implantações do CDK implantando a pilha de bootstrapping do CDK, chamada `CDKToolkit`, no ambiente da AWS.<a name="ref-cli-cmd-commands-context"></a>

 ` context `   
Gerenciar valores de contexto em cache para sua aplicação CDK.<a name="ref-cli-cmd-commands-deploy"></a>

 ` deploy `   
Implantar uma ou mais pilhas CDK em seu ambiente AWS.<a name="ref-cli-cmd-commands-destroy"></a>

 ` destroy `   
Excluir uma ou mais pilhas CDK do seu ambiente AWS.<a name="ref-cli-cmd-commands-diff"></a>

 ` diff `   
Fazer uma comparação para ver as mudanças na infraestrutura entre as pilhas CDK.<a name="ref-cli-cmd-commands-docs"></a>

 ` docs doc `   
Abrir a documentação CDK no seu navegador.<a name="ref-cli-cmd-commands-doctor"></a>

 ` doctor `   
Inspecionar e exibir informações úteis sobre seu projeto do CDK local e ambiente de desenvolvimento.<a name="ref-cli-cmd-commands-drift"></a>

 ` drift `   
Detecte o desvio de configuração dos recursos que você define, gerencia e implanta usando o CDK.<a name="ref-cli-cmd-commands-flags"></a>

 ` flags `   
Visualize e modifique suas configurações de sinalizadores de atributos para a CLI do CDK.<a name="ref-cli-cmd-commands-import"></a>

 ` import `   
Use as importações de recursos do AWS CloudFormation para importar recursos da AWS existentes em uma pilha do CDK.<a name="ref-cli-cmd-commands-init"></a>

 ` init `   
Criar um novo projeto do CDK a partir de um modelo.<a name="ref-cli-cmd-commands-list"></a>

 ` list, ls `   
Listar todas as pilhas CDK e suas dependências em uma aplicação CDK.<a name="ref-cli-cmd-commands-metadata"></a>

 ` metadata `   
Exibir metadados associados a uma pilha do CDK.<a name="ref-cli-cmd-commands-migrate"></a>

 ` migrate `   
Migre os recursos da AWS, pilhas do AWS CloudFormation e modelos do AWS CloudFormation para um novo projeto do CDK.<a name="ref-cli-cmd-commands-notices"></a>

 ` notices `   
Exibir avisos para sua aplicação CDK.<a name="ref-cli-cmd-commands-refactor"></a>

 ` refactor `   
Preserve os recursos implantados ao refatorar o código em sua aplicação do CDK.<a name="ref-cli-cmd-commands-synthesize"></a>

 ` synthesize, synth `   
Sintetize uma aplicação do CDK para produzir um conjunto de nuvem, incluindo um modelo do AWS CloudFormation para cada pilha.<a name="ref-cli-cmd-commands-watch"></a>

 ` watch `   
Observar continuamente um projeto local do CDK em busca de mudanças na realização de implantações e hotswaps.

## Opções globais
<a name="ref-cli-cmd-options"></a>

As opções a seguir são compatíveis com todos os comandos da CLI do CDK.<a name="ref-cli-cmd-options-app"></a>

 `--app, -a <STRING>`   
Fornecer o comando para executar sua aplicação ou diretório do conjunto de nuvem.  
 *Obrigatório*: Sim<a name="ref-cli-cmd-options-asset-metadata"></a>

 `--asset-metadata <BOOLEAN>`   
Incluir metadados `aws:asset:*` do AWS CloudFormation para recursos que usam ativos.  
 *Obrigatório*: não  
 *Valor padrão*: `true` <a name="ref-cli-cmd-options-build"></a>

 `--build <STRING>`   
Comando para executar uma compilação de pré-síntese.  
 *Obrigatório*: não<a name="ref-cli-cmd-options-ca-bundle-path"></a>

 `--ca-bundle-path <STRING>`   
Caminho para um certificado CA a ser usado ao validar solicitações HTTPS.  
Se essa opção não for fornecida, a CLI do CDK lerá da variável do ambiente `AWS_CA_BUNDLE`.  
 *Obrigatório*: Sim<a name="ref-cli-cmd-options-ci"></a>

 `--ci <BOOLEAN>`   
Indicar que os comandos da CLI do CDK estão sendo executados em um ambiente de integração contínua (CI).  
Essa opção modifica o comportamento da CLI do CDK para melhor se adequar às operações automatizadas típicas dos pipelines de CI.  
Quando você fornece essa opção, os logs são enviados para `stdout` em vez de `stderr`.  
 *Obrigatório*: não  
 *Valor padrão*: `false` <a name="ref-cli-cmd-options-context"></a>

 `--context, -c <ARRAY>`   
Adicionar parâmetros de string contextuais como pares chave-valor.<a name="ref-cli-cmd-options-debug"></a>

 `--debug <BOOLEAN>`   
Ativar informações detalhadas de depuração. Essa opção produz uma saída detalhada que inclui muito mais detalhes sobre o que a CLI do CDK está fazendo nos bastidores.  
 *Obrigatório*: não  
 *Valor padrão*: `false` <a name="ref-cli-cmd-options-ec2creds"></a>

 `--ec2creds, -i <BOOLEAN>`   
Forçar a CLI do CDK a tentar obter as credenciais da instância do Amazon EC2.  
Por padrão, a CLI do CDK adivinha o status da instância do Amazon EC2.  
 *Obrigatório*: não  
 *Valor padrão*: `false` <a name="ref-cli-cmd-options-help"></a>

 `--help, -h <BOOLEAN>`   
Mostrar as informações de referência de comando para a CLI do CDK.  
 *Obrigatório*: não  
 *Valor padrão*: `false` <a name="ref-cli-cmd-options-ignore-errors"></a>

 `--ignore-errors <BOOLEAN>`   
Ignorar os erros de síntese, que provavelmente produzirão uma saída inválida.  
 *Obrigatório*: não  
 *Valor padrão*: `false` <a name="ref-cli-cmd-options-json"></a>

 `--json, -j <BOOLEAN>`   
Usar JSON em vez de YAML para modelos do AWS CloudFormation impressos na saída padrão (`stdout`).  
 *Obrigatório*: não  
 *Valor padrão*: `false` <a name="ref-cli-cmd-options-lookups"></a>

 `--lookups <BOOLEAN>`   
Realizar pesquisas de contexto.  
A síntese falhará se esse valor for `false` e as pesquisas de contexto precisarem ser realizadas.  
 *Obrigatório*: não  
 *Valor padrão*: `true` <a name="ref-cli-cmd-options-no-color"></a>

 `--no-color <BOOLEAN>`   
Remover a cor e outros estilos da saída do console.  
 *Obrigatório*: não  
 *Valor padrão*: `false` <a name="ref-cli-cmd-options-notices"></a>

 `--notices <BOOLEAN>`   
Mostrar avisos relevantes.  
 *Obrigatório*: não  
 *Valor padrão*: `false` <a name="ref-cli-cmd-options-output"></a>

 `--output, -o <STRING>`   
Especificar o diretório para o qual enviar o conjunto de nuvem sintetizado.  
 *Obrigatório*: Sim  
 *Valor padrão*: `cdk.out` <a name="ref-cli-cmd-options-path-metadata"></a>

 `--path-metadata <BOOLEAN>`   
Incluir os metadados `aws::cdk::path` do AWS CloudFormation para cada recurso.  
 *Obrigatório*: não  
 *Valor padrão*: `true` <a name="ref-cli-cmd-options-plugin"></a>

 `--plugin, -p <ARRAY>`   
Nome ou caminho de um pacote de nó que estende os recursos do CDK. Essa opção pode ser fornecida várias vezes em um único comando.  
É possível configurar essa opção no arquivo `cdk.json` do projeto ou no `~/.cdk.json` em sua máquina de desenvolvimento local:  

```
{
   // ...
   "plugin": [
      "module_1",
      "module_2"
   ],
   // ...
}
```
 *Obrigatório*: não<a name="ref-cli-cmd-options-profile"></a>

 `--profile <STRING>`   
Especifique o nome do perfil AWS, contendo as informações do seu ambiente da AWS, para usar com a CLI do CDK.  
 *Obrigatório*: Sim<a name="ref-cli-cmd-options-proxy"></a>

 `--proxy <STRING>`   
Usar o proxy indicado.  
Se essa opção não for fornecida, a CLI do CDK lerá da variável do ambiente `HTTPS_PROXY`.  
 *Obrigatório*: Sim  
 *Valor padrão*: lido da variável de ambiente `HTTPS_PROXY`.<a name="ref-cli-cmd-options-role-arn"></a>

 `--role-arn, -r <STRING>`   
O ARN do perfil do IAM que a CLI do CDK assumirá ao interagir com o AWS CloudFormation.  
 *Obrigatório*: não<a name="ref-cli-cmd-options-staging"></a>

 `--staging <BOOLEAN>`   
Copiar os ativos para o diretório de saída.  
Especificar `false` para evitar a cópia de ativos para o diretório de saída. Isso permite à CLI do AWS SAM referenciar os arquivos de origem originais ao realizar a depuração local.  
 *Obrigatório*: não  
 *Valor padrão*: `true` <a name="ref-cli-cmd-options-strict"></a>

 `--strict <BOOLEAN>`   
Não construir pilhas que contenham avisos.  
 *Obrigatório*: não  
 *Valor padrão*: `false` <a name="ref-cli-cmd-options-trace"></a>

 `--trace <BOOLEAN>`   
Imprimir o rastreamento para avisos de pilha.  
 *Obrigatório*: não  
 *Valor padrão*: `false` <a name="ref-cli-cmd-options-verbose"></a>

 `--verbose, -v <COUNT>`   
Mostrar logs de depuração. Especifique essa opção várias vezes para aumentar o detalhamento.  
 *Obrigatório*: não<a name="ref-cli-cmd-options-version"></a>

 `--version <BOOLEAN>`   
Mostrar o número da versão da CLI do CDK.  
 *Obrigatório*: não  
 *Valor padrão*: `false` <a name="ref-cli-cmd-options-version-reporting"></a>

 `--version-reporting <BOOLEAN>`   
Incluir o recurso ` AWS::CDK::Metadata` em modelos sintetizados do AWS CloudFormation.  
 *Obrigatório*: não  
 *Valor padrão*: `true` 

## Fornecendo e configurando opções
<a name="ref-cli-cmd-configure"></a>

É possível passar opções por meio de argumentos de linha de comando. Para a maioria das opções, você pode configurá-las em um arquivo de configuração `cdk.json`. Quando você usa várias fontes de configuração, a CLI do CDK segue a precedência a seguir:

1.  **Valores da linha de comando** — Qualquer opção fornecida na linha de comando substitui as opções configuradas nos arquivos `cdk.json`.

1.  **Arquivo de configuração do projeto** — O arquivo `cdk.json` no diretório do seu projeto do CDK.

1.  **Arquivo de configuração do usuário** — O arquivo `cdk.json` localizado em `~/.cdk.json` na sua máquina local.

## Passando opções na linha de comando
<a name="ref-cli-cmd-pass"></a><a name="ref-cli-cmd-pass-bool"></a>

 **Passando valores boolianos**   
Para opções que aceitam um valor booliano, você pode especificá-las destas duas formas:  
+ Usar valores `true` e `false` — Forneça o valor booleano com o comando. Veja um exemplo a seguir:

  ```
  $ cdk deploy --watch=true
  $ cdk deploy --watch=false
  ```
+ Fornecer a contrapartida da opção — Modifique o nome da opção adicionando `no` para especificar um valor `false`. Veja um exemplo a seguir:

  ```
  $ cdk deploy --watch
  $ cdk deploy --no-watch
  ```
+ Para opções cujo padrão é `true` ou `false`, você não precisa fornecer a opção, a menos que queira mudar do padrão.

# `cdk acknowledge`
<a name="ref-cli-cmd-ack"></a>

Reconheça um aviso pelo número do problema e oculte-o de ser exibido novamente.

Isso é útil para ocultar avisos que foram endereçados ou que não se aplicam a você.

As confirmações são salvas no nível do projeto do CDK. Se você reconhecer um aviso em um projeto do CDK, ele ainda será exibido em outros projetos até que seja reconhecido lá.

## Uso
<a name="ref-cli-cmd-ack-usage"></a>

```
$ cdk acknowledge <arguments> <options>
```

## Argumentos
<a name="ref-cli-cmd-ack-args"></a><a name="ref-cli-cmd-ack-args-notice-id"></a>

 **ID do aviso**   
O ID do aviso.  
 *Tipo:* string  
 *Obrigatório*: não

## Opções
<a name="ref-cli-cmd-ack-options"></a>

Para obter uma lista das opções globais que funcionam com todos os comandos da CLI do CDK, consulte [Opções globais](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-ack-options-help"></a>

 `--help, -h <BOOLEAN>`   
Mostrar as informações de referência do comando `cdk acknowledge`.

## Exemplos
<a name="ref-cli-cmd-ack-examples"></a>

### Reconhecimento e ocultação de um aviso exibido ao executar outro comando da CLI do CDK
<a name="ref-cli-cmd-ack-examples-1"></a>

```
$ cdk deploy
... # Normal output of the command

NOTICES

16603   Toggling off auto_delete_objects for Bucket empties the bucket

        Overview: If a stack is deployed with an S3 bucket with
                  auto_delete_objects=True, and then re-deployed with
                  auto_delete_objects=False, all the objects in the bucket
                  will be deleted.

        Affected versions: <1.126.0.

        More information at: https://github.com/aws/aws-cdk/issues/16603


17061   Error when building EKS cluster with monocdk import

        Overview: When using monocdk/aws-eks to build a stack containing
                  an EKS cluster, error is thrown about missing
                  lambda-layer-node-proxy-agent/layer/package.json.

        Affected versions: >=1.126.0 <=1.130.0.

        More information at: https://github.com/aws/aws-cdk/issues/17061

$ cdk acknowledge 16603
```

# `cdk bootstrap`
<a name="ref-cli-cmd-bootstrap"></a>

Prepare um ambiente da AWS para implantações do CDK implantando a pilha de bootstrapping do CDK, chamada `CDKToolkit`, no ambiente da AWS.

A pilha de bootstrapping é uma pilha do CloudFormation que provisiona um bucket Amazon S3 e um repositório Amazon ECR no ambiente AWS. A CLI do AWS CDK usa esses recursos para armazenar modelos sintetizados e ativos relacionados durante a implantação.

## Uso
<a name="ref-cli-cmd-bootstrap-usage"></a>

```
$ cdk bootstrap <arguments> <options>
```

## Argumentos
<a name="ref-cli-cmd-bootstrap-args"></a><a name="ref-cli-cmd-bootstrap-args-env"></a>

 ** AWS Ambiente do**   
O ambiente de destino AWS implanta a pilha de bootstrapping no seguinte formato: `aws://<account-id>/<region>`.  
Exemplo: `aws://123456789012/us-east-1`   
Esse argumento pode ser fornecido várias vezes em um único comando para implantar a pilha de bootstrapping em vários ambientes.  
Por padrão, a CLI do CDK fará o bootstrapping de todos os ambientes referenciados na aplicação do CDK ou determinará um ambiente a partir de fontes padrão. Isso pode ser um ambiente especificado usando a opção `--profile`, de variáveis de ambiente ou fontes da AWS CLI padrão.

## Opções
<a name="ref-cli-cmd-bootstrap-options"></a>

Para obter uma lista das opções globais que funcionam com todos os comandos da CLI do CDK, consulte [Opções globais](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-bootstrap-options-bootstrap-bucket-name"></a>

 `--bootstrap-bucket-name, --toolkit-bucket-name, -b <STRING>`   
O nome do bucket do Amazon S3 que será usado pela CLI do CDK. Esse bucket será criado e não deve existir no momento.  
Forneça essa opção para substituir o nome padrão do bucket do Amazon S3.  
Ao usar essa opção, talvez seja necessário personalizar a síntese. Para saber mais, consulte [Personalização da síntese de pilhas do CDK](configure-synth.md#bootstrapping-custom-synth).  
 *Valor padrão*: Indefinido<a name="ref-cli-cmd-bootstrap-options-bootstrap-customer-key"></a>

 `--bootstrap-customer-key <BOOLEAN>`   
Crie uma chave mestra de cliente (CMK) para o bucket de apenas (será feita uma cobrança, mas será possível personalizar as permissões, somente no bootstrapping moderno).  
Essa opção não é compatível com o `--bootstrap-kms-key-id`.  
 *Valor padrão*: Indefinido<a name="ref-cli-cmd-bootstrap-options-bootstrap-kms-key-id"></a>

 `--bootstrap-kms-key-id <STRING>`   
ID da chave mestra do AWS KMS a ser usada para a criptografia `SSE-KMS`.  
Forneça essa opção para substituir a chave do AWS KMS padrão usada para criptografar o bucket do Amazon S3.  
Essa opção não é compatível com o `--bootstrap-customer-key`.  
 *Valor padrão*: Indefinido<a name="ref-cli-cmd-bootstrap-options-cloudformation-execution-policies"></a>

 `--cloudformation-execution-policies <ARRAY>`   
Os ARNs da política do IAM gerenciada que devem ser anexados ao perfil de implantação assumido pelo AWS CloudFormation durante a implantação de suas pilhas.  
Por padrão, as pilhas são implantadas com permissões totais de administrador usando a política `AdministratorAccess`.  
É possível fornecer essa opção várias vezes em um único comando. Você também pode fornecer vários ARNs como uma única string, com os ARNs individuais separados por vírgulas. Veja um exemplo a seguir:  

```
$ cdk bootstrap --cloudformation-execution-policies "arn:aws:iam::aws:policy/AWSLambda_FullAccess,arn:aws:iam::aws:policy/AWSCodeDeployFullAccess"
```
Para evitar falhas na implantação, verifique se as políticas especificadas são suficientes para qualquer implantação que você executará no ambiente que está sendo inicializado.  
Essa opção se aplica somente à inicialização moderna.  
O modelo de bootstrapping moderno concede efetivamente as permissões implícitas no `--cloudformation-execution-policies` para qualquer conta AWS na lista `--trust`. Por padrão, isso estende as permissões de leitura e gravação em qualquer recurso na conta inicializada. Certifique-se de [configurar a pilha de bootstrapping](bootstrapping-customizing.md) com políticas e contas confiáveis com as quais você se sinta confortável.
 *Valor padrão*: `[]` <a name="ref-cli-cmd-bootstrap-options-custom-permissions-boundary"></a>

 `--custom-permissions-boundary, -cpb <STRING>`   
Especifique o nome de um limite de permissões a ser usado.  
Essa opção não é compatível com o `--example-permissions-boundary`.  
 *Valor padrão*: Indefinido<a name="ref-cli-cmd-bootstrap-options-example-permissions-boundary"></a>

 `--example-permissions-boundary, -epb <BOOLEAN>`   
Use o exemplo de limite de permissões, fornecido pelo AWS CDK.  
Essa opção não é compatível com o `--custom-permissions-boundary`.  
A política de limite de permissões fornecida pelo CDK deve ser considerada um exemplo. Edite o conteúdo e faça referência ao exemplo de política se você estiver testando o atributo. Converta-a em uma nova política para implantações reais, caso ainda não exista. A preocupação é evitar o desvio. Provavelmente, um limite de permissões é mantido e tem convenções dedicadas, incluindo de nomenclatura.  
Para obter mais informações sobre a configuração de permissões, incluindo o uso de limites de permissões, consulte o [Guia do desenvolvedor de segurança e proteção](https://github.com/aws/aws-cdk/wiki/Security-And-Safety-Dev-Guide).  
 *Valor padrão*: Indefinido<a name="ref-cli-cmd-bootstrap-options-execute"></a>

 `--execute <BOOLEAN>`   
Configure se o conjunto de alterações deve ser executado.  
 *Valor padrão*: `true` <a name="ref-cli-cmd-bootstrap-options-force"></a>

 `--force, -f <BOOLEAN>`   
Sempre inicialize, mesmo que isso faça o downgrade da versão do modelo de inicialização.  
 *Valor padrão*: `false` <a name="ref-cli-cmd-bootstrap-options-help"></a>

 `--help, -h <BOOLEAN>`   
Mostrar as informações de referência do comando `cdk bootstrap`.<a name="ref-cli-cmd-bootstrap-options-previous-parameters"></a>

 `--previous-parameters <BOOLEAN>`   
Use valores anteriores para os parâmetros existentes.  
Depois que um modelo de inicialização é implantado com um conjunto de parâmetros, você deve definir essa opção como `false` para alterar quaisquer parâmetros em futuras implantações. Quando `false`, você deve fornecer novamente todos os parâmetros fornecidos anteriormente.  
 *Valor padrão*: `true` <a name="ref-cli-cmd-bootstrap-options-public-access-block-configuration"></a>

 `--public-access-block-configuration <BOOLEAN>`   
Bloqueie a configuração de acesso público no bucket do Amazon S3 que é criado e usado pela CLI do CDK.  
 *Valor padrão*: `true` <a name="ref-cli-cmd-bootstrap-options-qualifier"></a>

 `--qualifier <STRING>`   
Valor de string de nove dígitos que é exclusiva para cada pilha de bootstrapping. Esse valor é adicionado ao ID físico dos recursos na pilha de bootstrapping.  
Ao fornecer um qualificador, você evita conflitos de nomes de recursos ao provisionar várias pilhas de inicialização no mesmo ambiente.  
Quando você altera o qualificador, sua aplicação CDK deve passar o valor alterado para o sintetizador de pilha. Para obter mais informações, consulte [Personalização da síntese de pilhas do CDK](configure-synth.md#bootstrapping-custom-synth).  
 *Valor padrão*: `hnb659fds`. Esse valor não tem significado.<a name="ref-cli-cmd-bootstrap-options-show-template"></a>

 `--show-template <BOOLEAN>`   
Em vez de inicializar, imprima o modelo de inicialização atual na saída padrão (`stdout`). Em seguida, você pode copiar e personalizar o modelo conforme necessário.  
 *Valor padrão*: `false` <a name="ref-cli-cmd-bootstrap-options-tags"></a>

 `--tags, -t <ARRAY>`   
Tags a serem adicionadas à pilha de bootstrapping no formato de `KEY=VALUE`.  
 *Valor padrão*: `[]` <a name="ref-cli-cmd-bootstrap-options-template"></a>

 `--template <STRING>`   
Use o modelo do arquivo fornecido em vez do embutido.<a name="ref-cli-cmd-bootstrap-options-termination-protection"></a>

 `--termination-protection <BOOLEAN>`   
Ative a proteção contra encerramento do AWS CloudFormation na pilha de bootstrapping.  
Quando `true`, a proteção contra encerramento é habilitada. Isso impede que uma pilha de bootstrapping seja excluída acidentalmente.  
Para saber mais sobre a proteção contra encerramento, consulte [Proteção contra exclusão de uma pilha](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-protect-stacks.html) no *Guia do usuário do AWS CloudFormation*.  
 *Valor padrão*: Indefinido<a name="ref-cli-cmd-bootstrap-options-toolkit-stack-name"></a>

 `--toolkit-stack-name <STRING>`   
O nome da pilha de bootstrapping a ser criada.  
Por padrão, o `cdk bootstrap` implanta uma pilha chamada `CDKToolkit` no ambiente AWS especificado. Use essa opção para fornecer um nome diferente para sua pilha de bootstrapping.  
A CLI do CDK usa esse valor para verificar a versão da pilha de bootstrapping.  
 *Valor padrão*: `CDKToolkit`   
 *Obrigatório*: Sim<a name="ref-cli-cmd-bootstrap-options-trust"></a>

 `--trust <ARRAY>`   
As IDs da conta da AWS que devem ser confiáveis para realizar implantações nesse ambiente.  
A conta que executa a inicialização sempre será confiável.  
Essa opção exige que você também forneça `--cloudformation-execution-policies`.  
É possível fornecer essa opção várias vezes em um único comando.  
Essa opção se aplica somente à inicialização moderna.  
Para adicionar contas confiáveis a uma pilha de bootstrapping existente, é necessário especificar todas as contas confiáveis, incluindo aquelas que podem ter sido fornecidas anteriormente. Se você fornecer apenas novas contas confiáveis, as contas anteriormente confiáveis serão removidas.  
Veja a seguir um exemplo que confia em duas contas:  

```
$ cdk bootstrap aws://123456789012/us-west-2 --trust 234567890123 --trust 987654321098 --cloudformation-execution-policies arn:aws:iam::aws:policy/AdministratorAccess
 ⏳  Bootstrapping environment aws://123456789012/us-west-2...
Trusted accounts for deployment: 234567890123, 987654321098
Trusted accounts for lookup: (none)
Execution policies: arn:aws:iam::aws:policy/AdministratorAccess
CDKToolkit: creating CloudFormation changeset...
 ✅  Environment aws://123456789012/us-west-2 bootstrapped.
```
O modelo de inicialização moderna concede efetivamente as permissões implícitas no `--cloudformation-execution-policies` para qualquer conta AWS na lista `--trust`. Por padrão, isso estende as permissões de leitura e gravação em qualquer recurso na conta inicializada. Certifique-se de [configurar a pilha de bootstrapping](bootstrapping-customizing.md) com políticas e contas confiáveis com as quais você se sinta confortável.
 *Valor padrão*: `[]` <a name="ref-cli-cmd-bootstrap-options-trust-for-lookup"></a>

 `--trust-for-lookup <ARRAY>`   
As IDs da conta da AWS que devem ser confiáveis para pesquisar valores nesse ambiente.  
Use essa opção para dar permissão às contas para sintetizar pilhas que serão implantadas no ambiente, sem realmente dar a elas permissão para implantar essas pilhas diretamente.  
É possível fornecer essa opção várias vezes em um único comando.  
Essa opção se aplica somente à inicialização moderna.  
 *Valor padrão*: `[]` 

## Exemplos
<a name="ref-cli-cmd-bootstrap-examples"></a>

### Inicialize o ambiente AWS especificado no perfil de produção
<a name="ref-cli-cmd-bootstrap-examples-1"></a>

```
$ cdk bootstrap --profile prod
```

### Implante a pilha de bootstrapping nos ambientes foo e bar
<a name="ref-cli-cmd-bootstrap-examples-2"></a>

```
$ cdk bootstrap --app='node bin/main.js' foo bar
```

### Exporte o modelo de inicialização para personalizá-lo
<a name="ref-cli-cmd-bootstrap-examples-3"></a>

Se você tiver requisitos específicos que não são atendidos pelo modelo de inicialização, você pode personalizá-lo para atender às suas necessidades.

É possível exportar o modelo de bootstrapping, modificá-lo e implantá-lo usando o AWS CloudFormation. Veja a seguir um exemplo de como exportar o modelo existente:

```
$ cdk bootstrap --show-template > bootstrap-template.yaml
```

Você também pode pedir para a CLI do CDK usar um modelo personalizado. Veja um exemplo a seguir:

```
$ cdk bootstrap --template my-bootstrap-template.yaml
```

### Bootstrapping com limite de permissões. Em seguida, remova esse limite de permissões
<a name="ref-cli-cmd-bootstrap-examples-4"></a>

Para fazer o bootstrapping com um limite de permissões personalizado, executamos o seguinte:

```
$ cdk bootstrap --custom-permissions-boundary my-permissions-boundary
```

Para remover o limite de permissões, executamos o seguinte:

```
$ cdk bootstrap --no-previous-parameters
```

### Use um qualificador para distinguir os recursos criados para um ambiente de desenvolvimento
<a name="ref-cli-cmd-bootstrap-examples-5"></a>

```
$ cdk bootstrap --qualifier dev2024
```

# `cdk context`
<a name="ref-cli-cmd-context"></a>

Gerencie valores de contexto em cache para sua aplicação do AWS CDK.

 O *contexto* representa as informações de configuração e ambiente que podem influenciar a forma como suas pilhas são sintetizadas e implantadas. Use o `cdk context` para fazer o seguinte:
+ Visualize seus valores de contexto configurados.
+ Defina e gerencie valores de contexto.
+ Remova os valores do contexto.

## Uso
<a name="ref-cli-cmd-context-usage"></a>

```
$ cdk context <options>
```

## Opções
<a name="ref-cli-cmd-context-options"></a>

Para obter uma lista das opções globais que funcionam com todos os comandos da CLI do CDK, consulte [Opções globais](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-context-options-clear"></a>

 `--clear <BOOLEAN>`   
Limpe todo o contexto.<a name="ref-cli-cmd-context-options-force"></a>

 `--force, -f <BOOLEAN>`   
Ignore o erro de chave ausente.  
 *Valor padrão*: `false` <a name="ref-cli-cmd-context-options-help"></a>

 `--help, -h <BOOLEAN>`   
Mostrar as informações de referência do comando `cdk context`.<a name="ref-cli-cmd-context-options-reset"></a>

 `--reset, -e <STRING>`   
A chave de contexto, ou seu índice, deve ser redefinida.

# `cdk deploy`
<a name="ref-cli-cmd-deploy"></a>

Implantação de uma ou mais pilhas do AWS CDK em seu ambiente da AWS.

Durante a implantação, a CLI do CDK produzirá indicadores de andamento, semelhantes aos que podem ser observados no console do AWS CloudFormation.

Se o ambiente AWS não tiver sofrido bootstrapping, somente pilhas sem ativos e com modelos sintetizados abaixo de 51.200 bytes serão implantadas com sucesso.

## Uso
<a name="ref-cli-cmd-deploy-usage"></a>

```
$ cdk deploy <arguments> <options>
```

## Argumentos
<a name="ref-cli-cmd-deploy-args"></a><a name="ref-cli-cmd-deploy-args-stack-name"></a>

 **ID da pilha CDK**   
O ID de constructo da pilha CDK da sua aplicação a ser implantado.  
 *Tipo:* string  
 *Obrigatório*: não

## Opções
<a name="ref-cli-cmd-deploy-options"></a>

Para obter uma lista das opções globais que funcionam com todos os comandos da CLI do CDK, consulte [Opções globais](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-deploy-options-all"></a>

 `--all <BOOLEAN>`   
Implantar todas as pilhas em sua aplicação CDK.  
 *Valor padrão*: `false` <a name="ref-cli-cmd-deploy-options-asset-parallelism"></a>

 `--asset-parallelism <BOOLEAN>`   
Especificar se deseja compilar e publicar ativos em paralelo.<a name="ref-cli-cmd-deploy-options-asset-prebuild"></a>

 `--asset-prebuild <BOOLEAN>`   
Especificar se deseja compilar todos os ativos antes de implantar a primeira pilha. Essa opção é útil para compilações do Docker com falha.  
 *Valor padrão*: `true` <a name="ref-cli-cmd-deploy-options-build-exclude"></a>

 `--build-exclude, -E <ARRAY>`   
Não recompile o ativo com o ID fornecido.  
Esta opção pode ser especificada várias vezes em um único comando.  
 *Valor padrão*: `[]` <a name="ref-cli-cmd-deploy-options-change-set-name"></a>

 `--change-set-name <STRING>`   
O nome do conjunto de alterações do AWS CloudFormation a ser criado.  
Essa opção não é compatível com o `--method='direct'`.<a name="ref-cli-cmd-deploy-options-concurrency"></a>

 `--concurrency <NUMBER>`   
Implante várias pilhas em paralelo enquanto contabiliza as dependências entre pilhas. Use essa opção para acelerar as implantações. Você ainda deve considerar o AWS CloudFormation e outras limitações de taxa da conta da AWS.  
Forneça um número para especificar o número máximo de implantações simultâneas (se a dependência permitir) a serem executadas.  
 *Valor padrão*: `1` <a name="ref-cli-cmd-deploy-options-exclusively"></a>

 `--exclusively, -e <BOOLEAN>`   
Implante somente as pilhas solicitadas e não inclua dependências.<a name="ref-cli-cmd-deploy-options-force"></a>

 `--force, -f <BOOLEAN>`   
Quando você implanta para atualizar uma pilha existente, a CLI do CDK compara o modelo e as tags da pilha implantada com a pilha prestes a ser implantada. Se nenhuma alteração for detectada, a CLI do CDK pulará a implantação.  
Para ignorar esse comportamento e sempre implantar pilhas, mesmo que nenhuma alteração seja detectada, use essa opção.  
 *Valor padrão*: `false` <a name="ref-cli-cmd-deploy-options-help"></a>

 `--help, -h <BOOLEAN>`   
Mostrar as informações de referência do comando `cdk deploy`.<a name="ref-cli-cmd-deploy-options-hotswap"></a>

 `--hotswap <BOOLEAN>`   
Implantações de hotswap para um desenvolvimento mais rápido. Essa opção tenta realizar uma implantação de hotswap mais rápida, se possível. Por exemplo, se você modificar o código de uma função do Lambda em sua aplicação do CDK, a CLI do CDK atualizará o recurso diretamente por meio de APIs de serviço em vez de realizar uma implantação do CloudFormation.  
Se a CLI do CDK detectar alterações que não ofereçam suporte ao hotswapping, essas alterações serão ignoradas e uma mensagem será exibida. Se você preferir realizar uma implantação completa do CloudFormation como alternativa, use `--hotswap-fallback` em vez disso.  
A CLI do CDK usa suas credenciais da AWS atuais para realizar as chamadas de API. Ele não assume os perfis de sua pilha de bootstrapping, mesmo se o sinalizador de atributo `@aws-cdk/core:newStyleStackSynthesis` estiver definido como `true`. Esses perfis não têm as permissões necessárias para atualizar os recursos da AWS diretamente, sem usar o CloudFormation. Por isso, certifique-se de que suas credenciais sejam da mesma conta da AWS que as pilhas nas quais você está realizando implantações de hotswap e que elas tenham as permissões de IAM necessárias para atualizar os recursos.  
No momento, o Hotswapping é compatível com as seguintes alterações:  
+ Ativos de código (incluindo imagens do Docker e código embutido), alterações de tags e alterações de configuração (somente descrição e variáveis de ambiente são suportadas) das funções do Lambda.
+ Versões do Lambda e alterações de alias.
+ Alterações na definição de máquinas de estado do AWS Step Functions.
+ Alterações de ativos de contêineres dos serviços do Amazon ECS.
+ Alterações de ativos do site nas implantações de buckets do Amazon S3.
+ Alterações na origem e no ambiente de projetos do AWS CodeBuild.
+ Alterações no modelo de mapeamento de VTL para resolvedores e funções do AWS AppSync.
+ Alterações no esquema das APIs AWS AppSync GraphQL.
O uso de determinadas funções intrínsecas do CloudFormation é suportado como parte de uma implantação com hotswaps. Isso inclui:  
+  `Ref` 
+  `Fn::GetAtt` – Suportado apenas parcialmente. Consulte [essa implementação](https://github.com/aws/aws-cdk/blob/main/packages/aws-cdk/lib/api/evaluate-cloudformation-template.ts#L477-L492) para obter recursos e atributos compatíveis.
+  `Fn::ImportValue` 
+  `Fn::Join` 
+  `Fn::Select` 
+  `Fn::Split` 
+  `Fn::Sub` 
Essa opção também é compatível com pilhas aninhadas.  
+ Essa opção introduz deliberadamente o desvio nas pilhas do CloudFormation para acelerar as implantações. Por isso, use-a apenas para fins de desenvolvimento. Não use esta opção para suas implantações de produção.
+ Essa opção é considerada experimental e pode ter alterações significativas no futuro.
+ Os padrões para determinados parâmetros podem ser diferentes com o parâmetro hotswap. Por exemplo, a porcentagem íntegra mínima de um serviço Amazon ECS será atualmente definida como `0`. Revise a fonte adequadamente se isso ocorrer.
 *Valor padrão*: `false` <a name="ref-cli-cmd-deploy-options-hotswap-fallback"></a>

 `--hotswap-fallback <BOOLEAN>`   
Essa opção é semelhante a `--hotswap`. A diferença é que `--hotswap-fallback` recorrerá à execução de uma implantação completa do CloudFormation se for detectada uma alteração que exija isso.  
Para obter mais informações sobre essa opção, consulte `--hotswap`.  
 *Valor padrão*: `false` <a name="ref-cli-cmd-deploy-options-ignore-no-stacks"></a>

 `--ignore-no-stacks <BOOLEAN>`   
Execute uma implantação mesmo que sua aplicação CDK não contenha nenhuma pilha.  
Essa opção é útil no seguinte cenário: É possível ter uma aplicação com vários ambientes, como `dev` e `prod`. Ao iniciar o desenvolvimento, sua aplicação de produção pode não ter nenhum recurso ou os recursos podem ser comentados. Isso resultará em um erro de implantação com uma mensagem informando que a aplicação não tem pilhas. Use `--ignore-no-stacks` para ignorar esse erro.  
 *Valor padrão*: `false` <a name="ref-cli-cmd-deploy-options-import-existing-resources"></a>

 `--import-existing-resources <BOOLEAN>`   
Importe recursos existentes e não gerenciados do AWS CloudFormation da sua conta da AWS.  
Quando você usa essa opção, os recursos do seu modelo sintetizado do AWS CloudFormation com o mesmo nome personalizado dos recursos não gerenciados existentes na mesma conta serão importados para sua pilha.  
É possível usar essa opção para importar recursos existentes para pilhas novas ou existentes.  
É possível importar recursos existentes e implantar novos recursos no mesmo comando `cdk deploy`.  
Para saber mais sobre nomes personalizados, consulte [Tipo de nome](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-name.html) no *Guia do usuário do AWS CloudFormation*.  
Para saber mais sobre o parâmetro `ImportExistingResources` do CloudFormation, consulte [O AWS CloudFormation simplifica a importação de recursos com um novo parâmetro para ChangeSets](https://aws.amazon.com/about-aws/whats-new/2023/11/aws-cloudformation-import-parameter-changesets/).  
Para obter mais informações sobre como usar essa opção, consulte [Importação de recursos existentes](https://github.com/aws/aws-cdk-cli/tree/main/packages/aws-cdk#import-existing-resources) no *repositório aws-cdk-cli do GitHub*.<a name="ref-cli-cmd-deploy-options-logs"></a>

 `--logs <BOOLEAN>`   
Mostre o log do Amazon CloudWatch na saída padrão (`stdout`) para todos os eventos de todos os recursos nas pilhas selecionadas.  
Essa opção é compatível apenas com o `--watch`.  
 *Valor padrão*: `true` <a name="ref-cli-cmd-deploy-options-method"></a>

 `--method, -m <STRING>`   
Configure o método para realizar uma implantação.  
+  `change-set` – Método padrão. A CLI do CDK cria um conjunto de alterações do CloudFormation com as alterações que serão implantadas e, em seguida, executa a implantação.
+  `direct` – Não crie um conjunto de alterações. Em vez disso, aplique a alteração imediatamente. Normalmente, isso é mais rápido do que criar um conjunto de alterações, mas você perde os detalhes do andamento da implantação na saída da CLI.
+  `prepare-change-set` – Crie um conjunto de alterações, mas não realize a implantação. Isso é útil se você tiver ferramentas externas que inspecionarão o conjunto de alterações ou se você tiver um processo de aprovação para conjuntos de alterações.
 *Valores válidos*: `change-set`, `direct`, `prepare-change-set`   
 *Valor padrão*: `change-set` <a name="ref-cli-cmd-deploy-options-notification-arns"></a>

 `--notification-arns <ARRAY>`   
Os ARNs dos tópicos do Amazon SNS que o CloudFormation notificará sobre eventos relacionados à pilha.<a name="ref-cli-cmd-deploy-options-outputs-file"></a>

 `--outputs-file, -O <STRING>`   
O caminho para onde as saídas da pilha das implantações são gravadas.  
Depois da implantação, as saídas da pilha serão gravadas no arquivo de saída especificado no formato JSON.  
É possível configurar essa opção no arquivo `cdk.json` do projeto ou no `~/.cdk.json` em sua máquina de desenvolvimento local:  

```
{
   "app": "npx ts-node bin/myproject.ts",
   // ...
   "outputsFile": "outputs.json"
}
```
Se várias pilhas forem implantadas, as saídas serão gravadas no mesmo arquivo de saída, organizadas por chaves que representam o nome da pilha.<a name="ref-cli-cmd-deploy-options-parameters"></a>

 `--parameters <ARRAY>`   
Passe parâmetros adicionais para o CloudFormation durante a implantação.  
Esta opção aceita uma matriz no formato a seguir: `STACK:KEY=VALUE`.  
+  `STACK` – O nome da pilha ao qual associar o parâmetro.
+  `KEY` – O nome do parâmetro da sua pilha.
+  `VALUE` – O valor a ser repassado na implantação.
Se o nome da pilha não for fornecido, ou se `*` for fornecido como o nome da pilha, os parâmetros serão aplicados a todas as pilhas que estão sendo implantadas. Se uma pilha não usar o parâmetro, a implantação falhará.  
Os parâmetros não se propagam para pilhas aninhadas. Para passar parâmetros para pilhas aninhadas, use o constructo ` [NestedStack](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.NestedStack.html) `.  
 *Valor padrão*: `{}` <a name="ref-cli-cmd-deploy-options-previous-parameters"></a>

 `--previous-parameters <BOOLEAN>`   
Use valores anteriores para os parâmetros existentes.  
Quando essa opção é definida como `false`, você deve especificar todos os parâmetros em cada implantação.  
 *Valor padrão*: `true` <a name="ref-cli-cmd-deploy-options-progress"></a>

 `--progress <STRING>`   
Configure como a CLI do CDK exibe o andamento da implantação.  
+  `bar` – Exibir os eventos de implantação da pilha como uma barra de andamento, com os eventos do recurso que está sendo implantado no momento.
+  `events` – Fornecer um histórico completo, incluindo todos os eventos do CloudFormation.
Você também pode configurar essa opção no arquivo `cdk.json` do projeto ou em `~/.cdk.json` na sua máquina de desenvolvimento local:  

```
{
   "progress": "events"
}
```
 *Valores válidos*: `bar`, `events`   
 *Valor padrão*: `bar` <a name="ref-cli-cmd-deploy-options-require-approval"></a>

 `--require-approval <STRING>`   
Especifique quais alterações sensíveis à segurança exigem aprovação manual.  
+  `any-change` – É necessária aprovação manual para qualquer alteração na pilha.
+  `broadening` – É necessária aprovação manual se as alterações envolverem uma ampliação das permissões ou das regras do grupo de segurança.
+  `never` – A aprovação não é necessária.
 *Valores válidos*: `any-change`, `broadening`, `never`   
 *Valor padrão*: `broadening` <a name="ref-cli-cmd-deploy-options-rollback"></a>

 `--rollback` \$1 `--no-rollback`, `-R`   
Durante a implantação, se um recurso não for criado ou atualizado, a implantação voltará ao estado estável mais recente antes que a CLI do CDK retorne. Todas as alterações feitas até esse ponto serão desfeitas. Os recursos criados serão excluídos e as atualizações feitas serão revertidas.  
Especifique `--no-rollback` para desativar esse comportamento. Se um recurso não for criado ou atualizado, a CLI do CDK manterá as alterações feitas até aquele momento e retornará. Isso deixará sua implantação em um estado de falha e pausa. A partir daqui, você pode atualizar seu código e tentar a implantação novamente. Isso pode ser útil em ambientes de desenvolvimento em que você está iterando rapidamente.  
Se uma implantação realizada com o `--no-rollback` falhar e você decidir reverter a implantação, poderá usar o comando `cdk rollback`. Para obter mais informações, consulte [cdk rollback](ref-cli-cmd-rollback.md).  
Com o `--no-rollback`, implantações que causam substituições de recursos sempre falharão. Você só pode usar esse valor de opção para implantações que atualizam ou criam novos recursos.
 *Valor padrão*: `--rollback` <a name="ref-cli-cmd-deploy-options-toolkit-stack-name"></a>

 `--toolkit-stack-name <STRING>`   
O nome da pilha existente do Kit de Ferramentas CDK.  
Por padrão, o `cdk bootstrap` implanta uma pilha chamada `CDKToolkit` no ambiente AWS especificado. Use essa opção para fornecer um nome diferente para sua pilha de bootstrapping.  
A CLI do CDK usa esse valor para verificar a versão da pilha de bootstrapping.<a name="ref-cli-cmd-deploy-options-watch"></a>

 `--watch <BOOLEAN>`   
Observe continuamente os arquivos de projeto do CDK e implante automaticamente as pilhas especificadas quando as alterações forem detectadas.  
Essa opção implica `--hotswap` por padrão.  
Essa opção tem um comando da CLI do CDK equivalente. Para obter mais informações, consulte [cdk watch](ref-cli-cmd-watch.md).

## Exemplos
<a name="ref-cli-cmd-deploy-examples"></a>

### Implante a pilha chamada MyStackName
<a name="ref-cli-cmd-deploy-examples-1"></a>

```
$ cdk deploy MyStackName --app='node bin/main.js'
```

### Implante várias pilhas em uma aplicação
<a name="ref-cli-cmd-deploy-examples-2"></a>

Use `cdk list` para listar suas pilhas:

```
$ cdk list
CdkHelloWorldStack
CdkStack2
CdkStack3
```

Para implantar todas as pilhas, use a opção `--all`:

```
$ cdk deploy --all
```

Para escolher quais pilhas implantar, forneça os nomes das pilhas como argumentos:

```
$ cdk deploy CdkHelloWorldStack CdkStack3
```

### Implantar pilhas de pipeline
<a name="ref-cli-cmd-deploy-examples-3"></a>

Use `cdk list` para mostrar os nomes das pilhas como caminhos, mostrando onde elas estão na hierarquia do pipeline:

```
$ cdk list
PipelineStack
PiplelineStack/Prod
PipelineStack/Prod/MyService
```

Use a `--all` opção ou o curinga `*` para implantar todas as pilhas. Se você tiver uma hierarquia de pilhas, conforme descrito acima, `--all` e `*` só combinarão as pilhas no nível superior. Para combinar todas as pilhas na hierarquia, use `**`.

É possível combinar esses padrões. O seguinte implementa todas as pilhas no estágio `Prod`:

```
$ cdk deploy PipelineStack/Prod/**
```

### Passe os parâmetros na implantação
<a name="ref-cli-cmd-deploy-examples-4"></a>

Defina os parâmetros em sua pilha do CDK. Veja a seguir um exemplo de criação de um parâmetro chamado `TopicNameParam` para um tópico do Amazon SNS:

```
new sns.Topic(this, 'TopicParameter', {
    topicName: new cdk.CfnParameter(this, 'TopicNameParam').value.toString()
});
```

Para fornecer um valor de parâmetro de `parameterized`, execute o seguinte:

```
$ cdk deploy --parameters "MyStackName:TopicNameParam=parameterized"
```

É possível substituir os valores dos parâmetros usando a opção `--force`. Veja a seguir um exemplo de como substituir o nome do tópico de uma implantação anterior:

```
$ cdk deploy --parameters "MyStackName:TopicNameParam=parameterName" --force
```

### Grave as saídas da pilha em um arquivo após a implantação
<a name="ref-cli-cmd-deploy-examples-5"></a>

Defina as saídas em seu arquivo de pilha CDK. Veja a seguir um exemplo que cria uma saída para um ARN de função:

```
const fn = new lambda.Function(this, "fn", {
  handler: "index.handler",
  code: lambda.Code.fromInline(`exports.handler = \${handler.toString()}`),
  runtime: lambda.Runtime.NODEJS_LATEST
});

new cdk.CfnOutput(this, 'FunctionArn', {
  value: fn.functionArn,
});
```

Implantar a pilha e gravar as saídas em `outputs.json`:

```
$ cdk deploy --outputs-file outputs.json
```

Veja a seguir um exemplo do `outputs.json` depois da implantação:

```
{
  "MyStack": {
    "FunctionArn": "arn:aws:lambda:us-east-1:123456789012:function:MyStack-fn5FF616E3-G632ITHSP5HK"
  }
}
```

Neste exemplo, a chave `FunctionArn` corresponde ao ID lógico da instância `CfnOutput`.

Veja a seguir um exemplo do `outputs.json` depois da implantação de várias pilhas:

```
{
  "MyStack": {
    "FunctionArn": "arn:aws:lambda:us-east-1:123456789012:function:MyStack-fn5FF616E3-G632ITHSP5HK"
  },
  "AnotherStack": {
    "VPCId": "vpc-z0mg270fee16693f"
  }
}
```

### Modificar o método de implantação
<a name="ref-cli-cmd-deploy-examples-6"></a>

Para implantar com mais rapidez, sem usar conjuntos de alterações, use `--method='direct'`:

```
$ cdk deploy --method='direct'
```

Para criar um conjunto de alterações, mas não implantar, use `--method='prepare-change-set'`. Por padrão, um conjunto de alterações chamado `cdk-deploy-change-set` será criado. Se existir um conjunto de alterações anterior com esse nome, ele será substituído. Se nenhuma alteração for detectada, um conjunto de alterações vazio ainda será criado.

Você também pode nomear seu conjunto de alterações. Veja um exemplo a seguir:

```
$ cdk deploy --method='prepare-change-set' --change-set-name='MyChangeSetName'
```

# `cdk destroy`
<a name="ref-cli-cmd-destroy"></a>

Exclua uma ou mais pilhas do CDK da AWS do seu ambiente da AWS.

Quando você exclui uma pilha, os recursos na pilha serão destruídos, a menos que tenham sido configurados com um `DeletionPolicy` de `Retain`.

Durante a exclusão da pilha, esse comando produzirá informações de andamento semelhantes ao comportamento `cdk deploy`.

## Uso
<a name="ref-cli-cmd-destroy-usage"></a>

```
$ cdk destroy <arguments> <options>
```

## Argumentos
<a name="ref-cli-cmd-destroy-args"></a><a name="ref-cli-cmd-destroy-args-stack-name"></a>

 **ID da pilha CDK**   
O ID de constructo da pilha CDK da sua aplicação a ser excluído.  
 *Tipo:* string  
 *Obrigatório*: não

## Opções
<a name="ref-cli-cmd-destroy-options"></a>

Para obter uma lista das opções globais que funcionam com todos os comandos da CLI do CDK, consulte [Opções globais](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-destroy-options-all"></a>

 `--all <BOOLEAN>`   
Destrua todas as pilhas disponíveis.  
 *Valor padrão*: `false` <a name="ref-cli-cmd-destroy-options-exclusively"></a>

 `--exclusively, -e <BOOLEAN>`   
Destrua apenas as pilhas solicitadas e não inclua dependências.<a name="ref-cli-cmd-destroy-options-force"></a>

 `--force, -f <BOOLEAN>`   
Não peça confirmação antes de destruir as pilhas.<a name="ref-cli-cmd-destroy-options-help"></a>

 `--help, -h <BOOLEAN>`   
Mostrar as informações de referência do comando `cdk destroy`.

## Exemplos
<a name="ref-cli-cmd-destroy-examples"></a>

### Excluir uma pilha chamada MyStackName
<a name="ref-cli-cmd-destroy-examples-1"></a>

```
$ cdk destroy --app='node bin/main.js' <MyStackName>
```

# `cdk diff`
<a name="ref-cli-cmd-diff"></a>

Faça um diff para ver as mudanças na infraestrutura entre as pilhas do AWS CDK.

Esse comando geralmente é usado para comparar as diferenças entre o estado atual das pilhas em sua aplicação CDK local e as pilhas implantadas. Contudo, você também pode comparar uma pilha implantada com qualquer modelo local do AWS CloudFormation.

## Uso
<a name="ref-cli-cmd-diff-usage"></a>

```
$ cdk diff <arguments> <options>
```

## Argumentos
<a name="ref-cli-cmd-diff-args"></a><a name="ref-cli-cmd-diff-args-stack-name"></a>

 **ID da pilha CDK**   
O ID de constructo da pilha CDK da sua aplicação para realizar uma comparação.  
 *Tipo:* string  
 *Obrigatório*: não

## Opções
<a name="ref-cli-cmd-diff-options"></a>

Para obter uma lista das opções globais que funcionam com todos os comandos da CLI do CDK, consulte [Opções globais](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-diff-options-change-set"></a>

 `--change-set <BOOLEAN>`   
Especifique se deseja criar um conjunto de alterações para analisar as substituições de recursos.  
Quando `true`, a CLI do CDK criará um conjunto de alterações do AWS CloudFormation para exibir as alterações exatas que serão feitas em sua pilha. Essa saída inclui se os recursos serão atualizados ou substituídos. A CLI do CDK usa o perfil de implantação em vez do perfil de pesquisa para realizar essa ação.  
Quando `false`, uma comparação mais rápida, mas menos precisa, é realizada comparando os modelos do CloudFormation. Qualquer alteração detectada nas propriedades que exijam a substituição de um recurso será exibida como uma substituição de recurso, mesmo que a alteração seja puramente cosmética, como a substituição de uma referência de recurso por um ARN com codificação rígida.  
 *Valor padrão*: `true` <a name="ref-cli-cmd-diff-options-context-lines"></a>

 `--context-lines <NUMBER>`   
Número de linhas de contexto a serem incluídas na renderização arbitrária de diferenças JSON.  
 *Valor padrão*: `3` <a name="ref-cli-cmd-diff-options-exclusively"></a>

 `--exclusively, -e <BOOLEAN>`   
Diferenciar apenas as pilhas solicitadas e não incluir dependências.<a name="ref-cli-cmd-diff-options-fail"></a>

 `--fail <BOOLEAN>`   
Falhar e sair com um código de `1` se forem detectadas diferenças.<a name="ref-cli-cmd-diff-options-help"></a>

 `--help, -h <BOOLEAN>`   
Mostrar as informações de referência do comando `cdk diff`.<a name="ref-cli-cmd-diff-options-processed"></a>

 `--processed <BOOLEAN>`   
Especifique se deseja comparar com o modelo com as transformações do CloudFormation já processadas.  
 *Valor padrão*: `false` <a name="ref-cli-cmd-diff-options-quiet"></a>

 `--quiet, -q <BOOLEAN>`   
Não imprimir o nome da pilha CDK e a mensagem padrão `cdk diff` para `stdout` quando nenhuma alteração for detectada.  
 *Valor padrão*: `false` <a name="ref-cli-cmd-diff-options-security-only"></a>

 `--security-only <BOOLEAN>`   
Diferenciar apenas para mudanças de segurança ampliadas.  
 *Valor padrão*: `false` <a name="ref-cli-cmd-diff-options-strict"></a>

 `--strict <BOOLEAN>`   
Modifique o comportamento `cdk diff` para ser mais preciso ou rigoroso. Quando verdadeiro, a CLI do CDK não filtrará recursos da ` AWS::CDK::Metadata` ou caracteres não ASCII ilegíveis.  
 *Valor padrão*: `false` <a name="ref-cli-cmd-diff-options-template"></a>

 `--template <STRING>`   
O caminho para o modelo do CloudFormation com o qual comparar uma pilha do CDK.

## Exemplos
<a name="ref-cli-cmd-diff-examples"></a>

### Compare com a pilha atualmente implantada chamada MyStackName
<a name="ref-cli-cmd-diff-examples-1"></a>

A CLI do CDK usa os símbolos a seguir na saída de diff:
+  `[+]`: identifica o código ou os recursos que serão adicionados se você implantar suas alterações.
+  `[-]`: identifica o código ou os recursos que serão removidos se você implantar suas alterações.
+  `[~]`: identifica um recurso ou propriedade que será modificado se você implantar suas alterações.

Veja a seguir um exemplo que mostra uma diferença de alterações locais em uma função do Lambda:

```
$ cdk diff MyStackName
start: Building <asset-hash>:<account:Region>
success: Built <asset-hash>:<account:Region>
start: Publishing <asset-hash>:<account:Region>
success: Published <asset-hash>:<account:Region>
Hold on while we create a read-only change set to get a diff with accurate replacement information (use --no-change-set to use a less accurate but faster template-only diff)
Stack MyStackName
Resources
[~] AWS::Lambda::Function HelloWorldFunction <resource-logical-ID>
 └─ [~] Code
     └─ [~] .ZipFile:
         ├─ [-]
        exports.handler = async function(event) {
          return {
            statusCode: 200,
            body: JSON.stringify('Hello World!'),
          };
        };

         └─ [+]
        exports.handler = async function(event) {
          return {
            statusCode: 200,
            body: JSON.stringify('Hello from CDK!'),
          };
        };



✨  Number of stacks with differences: 1
```

Um indicador `[~]` para recursos que serão modificados nem sempre significa uma substituição completa de recursos:
+ Algumas propriedades do recurso, como `Code`, atualizarão o recurso.
+ Algumas propriedades do recurso, como `FunctionName`, podem causar a substituição total do recurso.

### Compare com um modelo específico do CloudFormation
<a name="ref-cli-cmd-diff-examples-2"></a>

```
$ cdk diff MyStackName --app='node bin/main.js' --template-path='./MyStackNameTemplate.yaml'
```

### Faça um diff de uma pilha local com sua pilha implantada. Não imprima em stdout se nenhuma alteração for detectada
<a name="ref-cli-cmd-diff-examples-3"></a>

```
$ cdk diff MyStackName --app='node bin/main.js' --quiet
```

# `cdk docs`
<a name="ref-cli-cmd-docs"></a>

Abra a documentação do AWS CDK no seu navegador.

## Uso
<a name="ref-cli-cmd-docs-usage"></a>

```
$ cdk docs <options>
```

## Opções
<a name="ref-cli-cmd-docs-options"></a>

Para obter uma lista das opções globais que funcionam com todos os comandos da CLI do CDK, consulte [Opções globais](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-docs-options-browser"></a>

 `--browser, -b <STRING>`   
O comando a ser usado para abrir o navegador, usando `%u` como espaço reservado para o caminho do arquivo a ser aberto.  
 *Valor padrão*: `open %u` <a name="ref-cli-cmd-docs-options-help"></a>

 `--help, -h <BOOLEAN>`   
Mostrar as informações de referência do comando `cdk docs`.

## Exemplos
<a name="ref-cli-cmd-docs-examples"></a>

### Abra a documentação do AWS CDK no Google Chrome
<a name="ref-cli-cmd-docs-examples-1"></a>

```
$ cdk docs --browser='chrome %u'
```

# `cdk doctor`
<a name="ref-cli-cmd-doctor"></a>

Inspecione e exiba informações úteis sobre seu projeto do CDK da AWS local e ambiente de desenvolvimento.

Essas informações podem ajudar na solução de problemas do CDK e devem ser fornecidas ao enviar relatórios de bugs.

## Uso
<a name="ref-cli-cmd-doctor-usage"></a>

```
$ cdk doctor <options>
```

## Opções
<a name="ref-cli-cmd-doctor-options"></a>

Para obter uma lista das opções globais que funcionam com todos os comandos da CLI do CDK, consulte [Opções globais](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-doctor-options-help"></a>

 `--help, -h <BOOLEAN>`   
Mostrar as informações de referência do comando `cdk doctor`.

## Exemplos
<a name="ref-cli-cmd-doctor-examples"></a>

### Exemplo simples do comando `cdk doctor`
<a name="ref-cli-cmd-doctor-examples-1"></a>

```
$ cdk doctor
ℹ️ CDK Version: 1.0.0 (build e64993a)
ℹ️ AWS environment variables:
  - AWS_EC2_METADATA_DISABLED = 1
  - AWS_SDK_LOAD_CONFIG = 1
```

# `cdk drift`
<a name="ref-cli-cmd-drift"></a>

Detecte desvios na configuração dos recursos que você define, gerencia e implanta usando o kit de desenvolvimento em nuvem da AWS (CDK da AWS). O desvio ocorre quando a configuração real de uma pilha difere da configuração esperada, o que acontece quando os recursos são modificados fora do AWS CloudFormation.

Esse comando identifica os recursos que foram modificados (por exemplo, por meio do Console da AWS ou da AWS CLI) comparando seu estado atual com a configuração esperada. Essas modificações podem causar um comportamento inesperado em sua infraestrutura.

Durante a detecção de desvios, a CLI do CDK produzirá indicadores de andamento e resultados, mostrando:
+ Recursos que se desviaram da configuração esperada.
+ O número total de recursos com desvios.
+ Um resumo indicando se o desvio foi detectado na pilha.

**Importante**  
Os comandos `cdk drift` e `cdk diff` funcionam de forma diferente:  
 `cdk drift` chama a operação de detecção de desvio do CloudFormation para comparar o estado real dos recursos em AWS (“realidade”) com a configuração esperada no CloudFormation. Nem todos os recursos da AWS oferecem suporte à detecção de desvio. Para ver a lista de recursos com suporte, consulte [Suporte a tipos de recursos](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import-supported-resources.html) no *Guia do usuário do AWS CloudFormation*.
 `cdk diff` compara o modelo do CloudFormation sintetizado a partir do seu código do CDK local com o modelo da pilha do CloudFormation implantada.
Use `cdk drift` quando precisar verificar se os recursos foram modificados fora do CloudFormation (por exemplo, por meio do Console da AWS ou da AWS CLI). Use `cdk diff` quando quiser visualizar como suas alterações no código local afetariam sua infraestrutura antes da implantação.

## Uso
<a name="ref-cli-cmd-drift-usage"></a>

```
$ cdk drift <arguments> <options>
```

## Argumentos
<a name="ref-cli-cmd-drift-args"></a><a name="ref-cli-cmd-drift-args-stack-name"></a>

 **Nome da pilha**   
O nome da pilha que você deseja verificar se há desvios. A pilha deve ter sido implantada anteriormente no CloudFormation para realizar a detecção de desvios.  
 *Tipo:* string  
 *Obrigatório*: não  
Se nenhuma pilha for especificada, a detecção de desvio será executada em todas as pilhas definidas em sua aplicação do CDK.

## Opções
<a name="ref-cli-cmd-drift-options"></a>

Para obter uma lista das opções globais que funcionam com todos os comandos da CLI do CDK, consulte [Opções globais](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-drift-options-fail"></a>

 `--fail <BOOLEAN>`   
Retorna com o código de saída 1 se for detectado desvio.  
 *Valor padrão*: `false` <a name="ref-cli-cmd-drift-options-help"></a>

 `--help, -h <BOOLEAN>`   
Mostrar as informações de referência do comando `cdk drift`.

## Exemplos
<a name="ref-cli-cmd-drift-examples"></a>

### Verifica o desvio de uma pilha específica
<a name="ref-cli-cmd-drift-examples-stack"></a>

```
$ cdk drift MyStackName
```

O comando produzirá resultados semelhantes a:

```
Stack MyStackName
Modified Resources
[~] AWS::Lambda::Function MyFunction MyLambdaFunc1234ABCD
 └─ [~] /Description
     ├─ [-] My original hello world Lambda function
     └─ [+] My drifted hello world Lambda function

1 resource has drifted from their expected configuration

✨  Number of resources with drift: 1
```

### Verifica o desvio quando os recursos foram excluídos
<a name="ref-cli-cmd-drift-examples-deleted"></a>

O exemplo a seguir mostra a aparência da saída quando os recursos são modificados e excluídos:

```
Stack MyStackName
Modified Resources
[~] AWS::Lambda::Function MyFunction MyLambdaFunc1234ABCD
 └─ [~] /Description
     ├─ [-] My original hello world Lambda function
     └─ [+] My drifted hello world Lambda function
Deleted Resources
[-] AWS::CloudWatch::Alarm MyAlarm MyCWAlarmABCD1234

2 resources have drifted from their expected configuration

✨  Number of resources with drift: 2
```

### Verifica o desvio com código de saída
<a name="ref-cli-cmd-drift-examples-fail"></a>

Para que o comando retorne um código de saída diferente de zero se for detectado um desvio:

```
$ cdk drift MyStackName --fail
```

Isso é útil em pipelines de CI/CD para detectar e responder automaticamente ao desvio da infraestrutura.

# `cdk flags`
<a name="ref-cli-cmd-flags"></a>

Visualize e modifique suas configurações de sinalizadores de atributos para a CLI do CDK.

Os sinalizadores de atributos controlam o comportamento da CLI do CDK e é possível usá-los para habilitar ou desabilitar recursos específicos. Use o comando `cdk flags` para visualizar suas configurações atuais de sinalizadores de atributos e modificá-las conforme necessário.

**Atenção**  
O comando `cdk flags` está em desenvolvimento para o AWS CDK. Os atributos atuais desse comando são considerados prontos para produção e seguros de usar. Contudo, o escopo desse comando e seus atributos estão sujeitos a alterações. Sendo assim, é necessário se cadastrar fornecendo a opção `unstable=flags` de usar esse comando.

## Uso
<a name="ref-cli-cmd-flags-usage"></a>

```
$ cdk flags <arguments> <options>
```

## Argumentos
<a name="ref-cli-cmd-flags-args"></a><a name="ref-cli-cmd-flags-args-flagname"></a>

 **FLAGNAME**   
O nome do sinalizador de atributo específico que você deseja visualizar ou modificar.  
 *Tipo:* string  
 *Obrigatório*: não

## Opções
<a name="ref-cli-cmd-flags-options"></a>

Para obter uma lista das opções globais que funcionam com todos os comandos da CLI do CDK, consulte [Opções globais](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-flags-options-set"></a>

 `--set <BOOLEAN>`   
Modifica uma configuração de sinalizador de atributo.<a name="ref-cli-cmd-flags-options-all"></a>

 `--all <BOOLEAN>`   
Modifica ou visualiza todos os sinalizadores de atributos.<a name="ref-cli-cmd-flags-options-recommended"></a>

 `--recommended <BOOLEAN>`   
Altera os sinalizadores para os estados recomendados.<a name="ref-cli-cmd-flags-options-default"></a>

 `--default <BOOLEAN>`   
Altera os sinalizadores para os estados padrão.<a name="ref-cli-cmd-flags-options-unconfigured"></a>

 `--unconfigured <BOOLEAN>`   
Modifica sinalizadores de atributos não configurados.<a name="ref-cli-cmd-flags-options-value"></a>

 `--value <STRING>`   
O valor para definir a configuração do sinalizador de atributo.  
 *requiresArg*: verdadeiro<a name="ref-cli-cmd-flags-options-safe"></a>

 `--safe <BOOLEAN>`   
Habilita todos os sinalizadores de atributos que não afetam a sua aplicação.<a name="ref-cli-cmd-flags-options-interactive"></a>

 `--interactive, -i <BOOLEAN>`   
Opção interativa para o comando flags.

## Exemplos
<a name="ref-cli-cmd-flags-examples"></a>

### Visualizar configurações de sinalizadores de atributos
<a name="ref-cli-cmd-flags-examples-1"></a>

Execute `cdk flags` para exibir um relatório das configurações do seu sinalizador de atributos que diferem dos nossos estados recomendados. Os sinalizadores não configurados são rotulados com `<unset>` para indicar que o sinalizador atualmente não tem valor. As sinalizadores são exibidos na ordem a seguir:
+ Sinalizadores definidos com um valor que não corresponde ao nosso valor recomendado
+ Sinalizadores que você não configurou

```
$ cdk flags --unstable=flags
Feature Flag                           Recommended                       User
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         <unset>
```

Você também pode executar `cdk flags --all` para exibir um relatório de todos os sinalizadores de atributos na ordem a seguir:
+ Sinalizadores definidos com um valor que corresponde ao nosso valor recomendado
+ Sinalizadores definidos com um valor que não corresponde ao nosso valor recomendado
+ Sinalizadores que você não configurou

```
$ cdk flags --unstable=flags --all
Feature Flag                              Recommended                     User
@aws-cdk/...                                true                         true
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         <unset>
```

### Modificação de valores de sinalizadores de atributos
<a name="ref-cli-cmd-flags-examples-2"></a>

Para modificar seus sinalizadores de atributos de forma interativa, execute `cdk flags --interactive` (ou `cdk flags -i`) para ver uma lista de opções de menu.

Para alterar cada sinalizador de atributo para nosso valor recomendado, execute `cdk flags --set --recommended --all`. Esse comando mantém a configuração do sinalizador de atributo atualizada com as configurações mais recentes do sinalizador de atributos do CDK. Esteja ciente de que a execução desse comando pode potencialmente substituir os valores configurados existentes.

```
$ cdk flags --unstable=flags --set --recommended --all
Feature Flag                              Recommended Value            User Value
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         <unset>
  Synthesizing...
    Resources
    [~] AWS::S3::Bucket MyBucket
    └─ [~] Properties
        └─ [~] Encryption
                ...
    Number of stacks with differences: 2
  Do you want to accept these changes? (y/n) y
  Resynthesizing...
```

Se você quiser preservar o estado dos seus sinalizadores configurados existentes, execute `cdk flags --set --recommended --unconfigured`. Essa opção altera somente os sinalizadores de atributos não configurados para nossos valores recomendados.

```
$ cdk flags --unstable=flags --set --recommended --unconfigured
Feature Flag                              Recommended Value            User Value
* @aws-cdk/...                              true                         <unset>
* @aws-cdk/...                              true                         <unset>
  Synthesizing...
    Resources
    [~] AWS::S3::Bucket MyBucket
    └─ [~] Properties
        └─ [~] Encryption
            ├─ [-] None
            └─ [+] ServerSideEncryptionConfiguration:
                    - ...
            ...
    Number of stacks with differences: 2
  Do you want to accept these changes? (y/n) y
  Resynthesizing...
```

Se você quiser garantir que quaisquer sinalizadores de atributos não configurados não interfiram na sua aplicação, execute o comando `cdk flags --set --default --unconfigured` para alterar os sinalizadores não configurados para seus valores padrão. Por exemplo, se `@aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021` não estiver configurado, uma notificação será exibida após a execução de `cdk synth`. No entanto, se você definir o sinalizador para seu estado padrão (falso), ele será configurado, desativado e não afetará sua aplicação.

```
$ cdk flags --unstable=flags --set --default --unconfigured
Feature Flag                              Recommended Value            User Value
* @aws-cdk/...                              true                         <unset>
* @aws-cdk/...                              true                         <unset>
  Synthesizing...

  Do you want to accept these changes? (y/n) y
  Resynthesizing...
```

### Inspeção de sinalizadores de atributos específicos
<a name="ref-cli-cmd-flags-examples-3"></a>

#### Visualização de mais informações sobre um sinalizador
<a name="_view_more_information_about_a_flag"></a>

Além de executar `cdk flags` e `cdk flags --all` para exibir sua configuração de sinalizadores de atributos, você também pode usar `cdk flags "FLAGNAME"` para inspecionar um sinalizador de atributo específico e descobrir o que o sinalizador faz. Isso pode ser útil nos casos em que você deseja entender um sinalizador específico e seu impacto na sua aplicação.

```
$ cdk flags --unstable=flags "@aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021"
    Description: Enable this feature flag to have cloudfront distributions use the security policy TLSv1.2_2021 by default.
    Recommended Value: true
    User Value: true
```

#### Filtragem de sinalizadores por substring
<a name="_filter_flags_by_substring"></a>

Você também pode executar `cdk flags substring` para exibir todos os sinalizadores de atributos correspondentes. Se houver apenas um sinalizador de atributo que corresponda a essa substring, detalhes específicos serão exibidos.

```
$ cdk flags --unstable=flags ebs
@aws-cdk/aws-ec2:ebsDefaultGp3Volume
    Description: When enabled, the default volume type of the EBS volume will be GP3
    Recommended Value: true
    User Value: true
```

Se vários sinalizadores corresponderem à substring, todos os sinalizadores correspondentes serão exibidos em uma tabela. Se você inserir várias substrings, todos os sinalizadores correspondentes que contenham qualquer uma das substrings serão retornados.

```
$ cdk flags --unstable=flags s3 lambda
Feature Flag                              Recommended                     User
* @aws-cdk/s3...                            true                         false
* @aws-cdk/lambda...                        true                         false
* @aws-cdk/lambda...                        true                         <unset>
```

#### Modificação de um sinalizador específico
<a name="_modify_a_specific_flag"></a>

Se você precisar modificar o valor de um sinalizador e quiser ter certeza de que está configurando-o para um estado correto e com suporte, execute `cdk flags --set "FLAGNAME" --value="state"`.

```
$ cdk flags --unstable=flags --set "@aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021" --value="true"
  Synthesizing...
    Resources
    [~] AWS::CloudFront::Distribution MyDistribution
    └─ [~] Properties
        └─ [~] DefaultSecurityPolicy
            ├─ [-] TLSv1.0
            └─ [+] TLSv1.2_2021
                    - ...
    Number of stacks with differences: 2
  Do you want to accept these changes? (y/n) y
  Resynthesizing...
```

# `cdk gc`
<a name="ref-cli-cmd-gc"></a>

Use o comando `cdk gc` da interface de linha de comandos (CLI) do kit de desenvolvimento em nuvem da AWS (CDK da AWS) para realizar a coleta de resíduos em ativos não utilizados armazenados nos recursos da sua pilha de bootstrapping. Use o comando a seguir para visualizar, gerenciar e excluir ativos que não sejam mais necessários.

Para ativos do Amazon Simple Storage Service (Amazon S3), a CLI do CDK verificará os modelos existentes do AWS CloudFormation no mesmo ambiente para ver se eles são referenciados. Se não forem referenciados, eles serão considerados não utilizados e elegíveis para ações de coleta de resíduos.

**Atenção**  
O comando `cdk gc` está em desenvolvimento para o AWS CDK. Os atributos atuais desse comando são considerados prontos para produção e seguros de usar. Contudo, o escopo desse comando e seus atributos estão sujeitos a alterações. Sendo assim, é necessário se cadastrar fornecendo a opção `unstable=gc` de usar esse comando.

## Uso
<a name="ref-cli-cmd-gc-usage"></a>

```
$ cdk gc <arguments> <options>
```

## Argumentos
<a name="ref-cli-cmd-gc-args"></a><a name="ref-cli-cmd-gc-args-env"></a>

 ** AWS Ambiente do**   
O ambiente de destino AWS no qual realizar ações de coleta de resíduos.  
Ao fornecer um ambiente, use o formato a seguir: `aws://<account-id>/<region>`. Por exemplo, `aws://<123456789012>/<us-east-1>`.  
Esse argumento pode ser fornecido várias vezes em um único comando para executar ações de coleta de resíduos em vários ambientes.  
Por padrão, a CLI do CDK executará ações de coleta de resíduos em todos os ambientes que você referenciar em sua aplicação do CDK ou fornecer como argumentos. Se você não fornecer um ambiente, a CLI do CDK determinará o ambiente a partir das fontes padrão. Essas fontes incluem ambientes que você especifica usando a opção `--profile`, variáveis de ambiente ou fontes da AWS CLI padrão.

## Opções
<a name="ref-cli-cmd-gc-options"></a>

Para obter uma lista das opções globais que funcionam com todos os comandos da CLI do CDK, consulte [Opções globais](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-gc-options-action"></a>

 `--action <STRING>`   
A ação que `cdk gc` executa em seus ativos durante uma coleta de resíduos.  
+  `delete-tagged`: exclui ativos com tag de uma data dentro do intervalo de dias de buffer fornecido por você, mas não aplica tag em ativos não utilizados recém-identificados.
+  `full`: executa todas as ações de coleta de resíduos. Isso inclui excluir ativos dentro do intervalo de dias de buffer que você fornece e aplicar tags em ativos não utilizados recém-identificados.
+  `print`: exibe o número de ativos não utilizados no prompt de comando, mas não faz nenhuma alteração real em seu ambiente da AWS.
+  `tag`: aplica tag em todos os ativos não utilizados recém-identificados, mas não exclui nenhum ativo dentro do intervalo de dias de buffer que você fornece.
 *Valores aceitos*: `delete-tagged`, `full`, `print`, `tag`   
 *Valor padrão*: `full` <a name="ref-cli-cmd-gc-options-bootstrap-stack-name"></a>

 `--bootstrap-stack-name <STRING>`   
O nome da pilha de bootstrapping do CDK no seu ambiente da AWS. Forneça essa opção se você personalizou o nome da pilha de bootstrapping. Se você estiver usando o nome da pilha `CDKToolkit` padrão, não é necessário fornecer essa opção.  
 *Valor padrão*: `CDKToolkit` <a name="ref-cli-cmd-gc-options-confirm"></a>

 `--confirm <BOOLEAN>`   
Especifica se a CLI do CDK solicitará sua confirmação manual antes de excluir quaisquer ativos.  
Especifica `false` para excluir ativos automaticamente, sem solicitar a confirmação manual.  
 *Valor padrão*: `true` <a name="ref-cli-cmd-gc-options-created-buffer-days"></a>

 `--created-buffer-days <NUMBER>`   
O número de dias que um ativo deve existir antes de ser elegível para ações de coleta de resíduos.  
Quando você fornece um número, os ativos que não existiram além do número especificado de dias são filtrados das ações de coleta de resíduos.  
 *Valor padrão*: `1` <a name="ref-cli-cmd-gc-options-help"></a>

 `--help, -h <BOOLEAN>`   
Mostrar as informações de referência do comando `cdk gc`.<a name="ref-cli-cmd-gc-options-rollback-buffer-days"></a>

 `--rollback-buffer-days <NUMBER>`   
O número de dias que um ativo deve receber uma tag de isolado antes de ser elegível para ações de coleta de resíduos.  
Quando você fornece um número, a CLI do CDK aplica uma tag nos ativos não utilizados com a data atual em vez de excluí-los. A CLI do CDK também verificará se algum ativo recebeu tag durante as execuções anteriores do comando `cdk gc`. Os ativos que anteriormente receberam a tag e que estejam dentro do intervalo de dias de buffer que você fornece serão excluídos.  
 *Valor padrão*: `0` <a name="ref-cli-cmd-gc-options-type"></a>

 `--type <STRING>`   
O tipo de recurso de bootstrapping em sua pilha de bootstrapping para realizar ações de coleta de resíduos.  
+  `all`: executa ações de coleta de resíduos em todos os recursos que tenha sofrido bootstrapping.
+  `ecr`: executa ações de coleta de resíduos em ativos no repositório Amazon Elastic Container Registry (Amazon ECR) da pilha de bootstrapping.
+  `s3`: executa ações de coleta de resíduos em ativos no bucket do Amazon S3 de sua pilha de bootstrapping.
 *Valores aceitos*: `all`, `ecr`, `s3`   
 *Valor padrão*: `all` <a name="ref-cli-cmd-gc-options-unstable"></a>

 `--unstable <STRING>`   
Permita o uso de comandos da CLI do CDK que ainda estão em desenvolvimento.  
Essa opção é necessária para usar qualquer comando da CLI do CDK que ainda esteja em desenvolvimento e sujeito a alterações.  
Essa opção pode ser fornecida várias vezes em um único comando.  
Para usar `cdk gc`, forneça `--unstable=gc`.

## Exemplos
<a name="ref-cli-cmd-gc-examples"></a>

### Exemplos básicos
<a name="ref-cli-cmd-gc-examples-basic"></a>

O exemplo a seguir solicita uma confirmação manual para realizar ações padrão de coleta de resíduos em ativos no bucket Amazon S3 da sua pilha de bootstrapping:

```
$ cdk gc --unstable=gc --type=s3

 ⏳  Garbage Collecting environment aws://<account-id>/<region>...
Found 99 assets to delete based off of the following criteria:
- assets have been isolated for > 0 days
- assets were created > 1 days ago

Delete this batch (yes/no/delete-all)?
```

O exemplo a seguir executa ações de coleta de resíduos em uma faixa de ativos no bucket do Amazon S3 da sua pilha de bootstrapping: Essa faixa inclui ativos previamente marcados com tag por `cdk gc` por mais de 30 dias e foram criados com 10 dias ou mais. Esse comando solicitará a confirmação manual antes de excluir qualquer ativo:

```
$ cdk gc --unstable=gc --type=s3 --rollback-buffer-days=30 --created-buffer-days=10
```

O exemplo a seguir executa a ação de excluir ativos previamente marcados com tag no bucket do Amazon S3 da sua pilha de bootstrapping que não foram utilizados por mais de 30 dias:

```
$ cdk gc --unstable=gc --type=s3 --action=delete-tagged --rollback-buffer-days=30
```

# `cdk import`
<a name="ref-cli-cmd-import"></a>

Use as [importações de recursos do AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import.html) para importar recursos da AWS existentes em uma pilha do CDK.

Com esse comando, é possível pegar os recursos existentes que foram criados usando outros métodos e começar a gerenciá-los usando o AWS CDK.

Ao considerar a transferência de recursos para o gerenciamento do CDK, às vezes é aceitável criar novos recursos, como com perfis do IAM, funções do Lambda e regras de eventos. Para outros recursos, como recursos com estado, como buckets do Amazon S3 e tabelas do DynamoDB, a criação de novos recursos pode causar impactos em seu serviço. É possível usar `cdk import` para importar recursos existentes com o mínimo de interrupção em seus serviços. Para ver a lista de recursos da AWS com suporte, consulte [Suporte a tipos de recursos](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import-supported-resources.html) no *Guia do usuário do AWS CloudFormation*.

 **Para importar um recurso existente para uma pilha do CDK**   

1. Execute um `cdk diff` para garantir que sua pilha do CDK não tenha alterações pendentes. Ao realizar um `cdk import`, as únicas alterações permitidas em uma operação de importação são a adição de novos recursos sendo importados.

1. Adicione constructos para os recursos que você deseja importar para a pilha. Por exemplo, adicione o seguinte para um bucket do Amazon S3:

   ```
   new s3.Bucket(this, 'ImportedS3Bucket', {});
   ```

   Não adicione nenhuma outra alteração. Você também deve se certificar de modelar exatamente o estado que o recurso tem atualmente. Para o exemplo do bucket, não se esqueça de incluir chaves do AWS KMS, políticas de ciclo de vida e qualquer outra coisa que seja relevante sobre o bucket. Caso contrário, as operações de atualização subsequentes podem não fazer o que você espera.

1. Executar `cdk import`. Se houver várias pilhas na aplicação CDK, passe um nome de pilha específico como argumento.

1. A CLI do CDK solicitará que você informe os nomes reais dos recursos que você está importando. Depois de fornecer essas informações, a importação será iniciada.

1. Quando o relatório `cdk import` for bem-sucedido, o recurso será gerenciado pelo CDK. Quaisquer alterações subsequentes na configuração da constructo serão refletidas no recurso.

No momento, esse recurso tem as seguintes limitações:
+ Não é possível importar recursos para pilhas aninhadas.
+ Não há verificação se as propriedades especificadas estão corretas e completas para o recurso importado. Tente iniciar uma operação de detecção de desvio após a importação.
+ Os recursos que dependem de outros recursos devem ser importados juntos ou individualmente, na ordem correta. Caso contrário, a implantação do CloudFormation falhará com referências não resolvidas.
+ Esse comando usa as credenciais do perfil de implantação, necessárias para ler o bucket de teste criptografado. Isso requer a versão 12 do modelo de bootstrapping, que inclui as permissões necessárias do IAM para o perfil de implantação.

## Uso
<a name="ref-cli-cmd-import-usage"></a>

```
$ cdk import <arguments> <options>
```

## Argumentos
<a name="ref-cli-cmd-import-args"></a><a name="ref-cli-cmd-import-args-stack-name"></a>

 **ID da pilha CDK**   
O ID de constructo da pilha CDK da sua aplicação para o qual importar recursos. Este argumento pode ser fornecido várias vezes em um único comando.  
 *Tipo:* string  
 *Obrigatório*: não

## Opções
<a name="ref-cli-cmd-import-options"></a>

Para obter uma lista das opções globais que funcionam com todos os comandos da CLI do CDK, consulte [Opções globais](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-import-options-change-set-name"></a>

 `--change-set-name <STRING>`   
O nome do conjunto de alterações do CloudFormation a ser criado.<a name="ref-cli-cmd-import-options-execute"></a>

 `--execute <BOOLEAN>`   
Especifique se deseja executar o conjunto de alterações.  
 *Valor padrão*: `true` <a name="ref-cli-cmd-import-options-force"></a>

 `--force, -f <BOOLEAN>`   
Por padrão, a CLI do CDK sai do processo se a diferença do modelo incluir atualizações ou exclusões. Especifique `true` para substituir esse comportamento e sempre continuar com a importação.<a name="ref-cli-cmd-import-options-help"></a>

 `--help, -h <BOOLEAN>`   
Mostrar as informações de referência do comando `cdk import`.<a name="ref-cli-cmd-import-options-record-resource-mapping"></a>

 `--record-resource-mapping, -r <STRING>`   
Use essa opção para gerar um mapeamento dos recursos físicos existentes para os recursos do CDK que serão importados. O mapeamento será gravado no caminho do arquivo que você fornecer. Nenhuma operação de importação real será realizada.<a name="ref-cli-cmd-import-options-resource-mapping"></a>

 `--resource-mapping, -m <STRING>`   
Use essa opção para especificar um arquivo que define seu mapeamento de recursos. A CLI do CDK usará esse arquivo para mapear recursos físicos em recursos para importação, em vez de perguntar interativamente a você.  
Essa opção pode ser executada a partir de scripts.<a name="ref-cli-cmd-import-options-rollback"></a>

 `--rollback <BOOLEAN>`   
Reverta a pilha para o estado estável em caso de falha.  
Para especificar `false`, você pode usar `--no-rollback` ou `-R`.  
Especifique `false` para iterar mais rapidamente. Implantações contendo substituições de recursos sempre falharão.  
 *Valor padrão*: `true` <a name="ref-cli-cmd-import-options-toolkit-stack-name"></a>

 `--toolkit-stack-name <STRING>`   
O nome da pilha do Kit de Ferramentas CDK a ser criada.  
Por padrão, o `cdk bootstrap` implanta uma pilha chamada `CDKToolkit` no ambiente AWS especificado. Use essa opção para fornecer um nome diferente para sua pilha de bootstrapping.  
A CLI do CDK usa esse valor para verificar a versão da pilha de bootstrapping.

# `cdk init`
<a name="ref-cli-cmd-init"></a>

Crie um novo projeto do AWS CDK a partir de um modelo.

## Uso
<a name="ref-cli-cmd-init-usage"></a>

```
$ cdk init <arguments> <options>
```

## Argumentos
<a name="ref-cli-cmd-init-args"></a><a name="ref-cli-cmd-init-args-template-type"></a>

 **Tipo de modelo**   
O tipo de modelo CDK a partir do qual inicializar um novo projeto do CDK.  
+  `app` – Modelo para uma aplicação CDK.
+  `lib` – Modelo para uma biblioteca AWS Construct.
+  `sample-app` – Exemplo de aplicação CDK que inclui alguns constructos.
 *Valores válidos*: `app`, `lib`, `sample-app` 

## Opções
<a name="ref-cli-cmd-init-options"></a>

Para obter uma lista das opções globais que funcionam com todos os comandos da CLI do CDK, consulte [Opções globais](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-init-options-generate-only"></a>

 `--generate-only <BOOLEAN>`   
Especifique essa opção para gerar arquivos de projeto sem iniciar operações adicionais, como configurar um repositório git, instalar dependências ou compilar o projeto.  
 *Valor padrão*: `false` <a name="ref-cli-cmd-init-options-help"></a>

 `--help, -h <BOOLEAN>`   
Mostrar as informações de referência do comando `cdk init`.<a name="ref-cli-cmd-init-options-language"></a>

 `--language, -l <STRING>`   
A linguagem a ser usada para o novo projeto. Essa opção pode ser configurada no arquivo de configuração `cdk.json` do projeto ou em `~/.cdk.json` na sua máquina de desenvolvimento local.  
 *Valores válidos*: `csharp`, `fsharp`, `go`, `java`, `javascript`, `python`, `typescript` <a name="ref-cli-cmd-init-options-list"></a>

 `--list <BOOLEAN>`   
Liste os tipos de modelos e linguagens disponíveis.

## Exemplos
<a name="ref-cli-cmd-init-examples"></a>

### Liste os tipos de modelos e linguagens disponíveis
<a name="ref-cli-cmd-init-examples-1"></a>

```
$ cdk init --list
Available templates:
* app: Template for a CDK Application
   └─ cdk init app --language=[csharp|fsharp|go|java|javascript|python|typescript]
* lib: Template for a CDK Construct Library
   └─ cdk init lib --language=typescript
* sample-app: Example CDK Application with some constructs
   └─ cdk init sample-app --language=[csharp|fsharp|go|java|javascript|python|typescript]
```

### Crie um nova aplicação CDK no TypeScript a partir do modelo de biblioteca
<a name="ref-cli-cmd-init-examples-2"></a>

```
$ cdk init lib --language=typescript
```

# `cdk list`
<a name="ref-cli-cmd-list"></a>

Liste todas as pilhas do AWS CDK e suas dependências em uma aplicação do CDK.

## Uso
<a name="ref-cli-cmd-list-usage"></a>

```
$ cdk list <arguments> <options>
```

## Argumentos
<a name="ref-cli-cmd-list-args"></a><a name="ref-cli-cmd-list-args-stack-name"></a>

 **ID da pilha CDK**   
O ID de constructo da pilha CDK contra o qual sua aplicação deve executar esse comando.  
 *Tipo:* string  
 *Obrigatório*: não

## Opções
<a name="ref-cli-cmd-list-options"></a>

Para obter uma lista das opções globais que funcionam com todos os comandos da CLI do CDK, consulte [Opções globais](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-list-options-help"></a>

 `--help, -h <BOOLEAN>`   
Mostrar as informações de referência do comando `cdk list`.<a name="ref-cli-cmd-list-options-long"></a>

 `--long, -l <BOOLEAN>`   
Exibir informações do ambiente AWS para cada pilha.  
 *Valor padrão*: `false` <a name="ref-cli-cmd-list-options-show-dependencies"></a>

 `--show-dependencies, -d <BOOLEAN>`   
Exibir as informações de dependência da pilha para cada pilha.  
 *Valor padrão*: `false` 

## Exemplos
<a name="ref-cli-cmd-list-examples"></a>

### Listar todas as pilhas na aplicação do CDK “node bin/main.js”
<a name="ref-cli-cmd-list-examples-1"></a>

```
$ cdk list --app='node bin/main.js'
Foo
Bar
Baz
```

### Listar todas as pilhas, incluindo detalhes do ambiente AWS de cada pilha
<a name="ref-cli-cmd-list-examples-"></a>

```
$ cdk list --app='node bin/main.js' --long
-
    name: Foo
    environment:
        name: 000000000000/bermuda-triangle-1
        account: '000000000000'
        region: bermuda-triangle-1
-
    name: Bar
    environment:
        name: 111111111111/bermuda-triangle-2
        account: '111111111111'
        region: bermuda-triangle-2
-
    name: Baz
    environment:
        name: 333333333333/bermuda-triangle-3
        account: '333333333333'
        region: bermuda-triangle-3
```

# `cdk metadata`
<a name="ref-cli-cmd-metadata"></a>

Exibir metadados associados a uma pilha do CDK.

## Uso
<a name="ref-cli-cmd-metadata-usage"></a>

```
$ cdk metadata <arguments> <options>
```

## Argumentos
<a name="ref-cli-cmd-metadata-args"></a><a name="ref-cli-cmd-metadata-args-stack-name"></a>

 **ID da pilha CDK**   
O ID de constructo da pilha do CDK da sua aplicação para a qual exibir os metadados.  
 *Tipo:* string  
 *Obrigatório*: não

## Opções
<a name="ref-cli-cmd-metadata-options"></a>

Para obter uma lista das opções globais que funcionam com todos os comandos da CLI do CDK, consulte [Opções globais](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-metadata-options-help"></a>

 `--help, -h <BOOLEAN>`   
Mostrar as informações de referência do comando `cdk metadata`.

# `cdk migrate`
<a name="ref-cli-cdk-migrate"></a>

Migre os recursos da AWS implantados, pilhas do AWS CloudFormation e modelos do CloudFormation para um novo projeto do AWS CDK.

Esse comando cria um nova aplicação CDK que inclui uma única pilha nomeada com o valor que você fornece usando o `--stack-name`. É possível configurar a fonte de migração usando o `--from-scan`, `--from-stack` ou `--from-path`.

Para obter mais informações sobre o uso de `cdk migrate`, consulte [Migração de recursos existentes e modelos do AWS CloudFormation para o AWS CDK](migrate.md).

**nota**  
O comando `cdk migrate` é experimental e pode ter alterações significativas no futuro.

## Uso
<a name="ref-cli-cdk-migrate-usage"></a>

```
$ cdk migrate <options>
```

## Opções
<a name="ref-cli-cdk-migrate-options"></a>

Para obter uma lista das opções globais que funcionam com todos os comandos da CLI do CDK, consulte [Opções globais](ref-cli-cmd.md#ref-cli-cmd-options).

### Opções obrigatórias
<a name="ref-cli-cdk-migrate-options-required"></a><a name="ref-cli-cdk-migrate-options-stack-name"></a>

 `--stack-name <STRING>`   
O nome da pilha do AWS CloudFormation que será criada na aplicação do CDK após a migração.  
 *Obrigatório*: Sim

### Opções condicionais
<a name="ref-cli-cdk-migrate-options-conditional"></a><a name="ref-cli-cdk-migrate-options-from-path"></a>

 `--from-path <PATH>`   
O caminho para o modelo do AWS CloudFormation a ser migrado. Forneça essa opção para especificar um modelo local.  
 *Obrigatório:* condicional. Obrigatório ao migrar de um modelo local do AWS CloudFormation.<a name="ref-cli-cdk-migrate-options-from-scan"></a>

 `--from-scan <STRING>`   
Ao migrar recursos implantados de um ambiente da AWS, use essa opção para especificar se um novo escaneamento deve ser iniciado ou se a CLI do AWS CDK deve usar o último escaneamento bem-sucedido.  
 *Obrigatório:* condicional. Obrigatório ao migrar dos recursos implantados do AWS.  
 *Valores aceitos*: `most-recent`, `new` <a name="ref-cli-cdk-migrate-options-from-stack"></a>

 `--from-stack <BOOLEAN>`   
Forneça essa opção para migrar a partir de uma pilha do AWS CloudFormation implantada. Use `--stack-name` para especificar o nome da pilha do AWS CloudFormation implantada.  
 *Obrigatório:* condicional. Obrigatório ao migrar de uma pilha do AWS CloudFormation implantada.

### Opções opcionais
<a name="ref-cli-cdk-migrate-options-optional"></a><a name="ref-cli-cdk-migrate-options-account"></a>

 `--account <STRING>`   
A conta da qual recuperar o modelo de pilha do AWS CloudFormation.  
 *Obrigatório*: não  
 *Padrão*: a CLI do AWS CDK obtém informações da conta de fontes padrão.<a name="ref-cli-cdk-migrate-options-compress"></a>

 `--compress <BOOLEAN>`   
Forneça essa opção para compactar o projeto do CDK gerado em um arquivo `ZIP`.  
 *Obrigatório*: não<a name="ref-cli-cdk-migrate-options-filter"></a>

 `--filter <ARRAY>`   
Use ao migrar recursos implantados a partir de uma conta da AWS e região da AWS. Essa opção especifica um filtro para determinar quais recursos implantados devem ser migrados.  
Essa opção aceita uma matriz de pares de valores-chave, em que **chave** representa o tipo de filtro e **valor** representa o valor a ser filtrado.  
As seguintes chaves são aceitas:  
+  `resource-identifier` — Um identificador para o recurso. O valor pode ser o ID lógico ou físico do recurso. Por exemplo, `resource-identifier="ClusterName"`.
+  `resource-type-prefix`: o prefixo do tipo de recurso do AWS CloudFormation. Por exemplo, especifique `resource-type-prefix="AWS::DynamoDB::"` para filtrar todos os recursos do Amazon DynamoDB.
+  `tag-key` – A chave de uma tag de recurso. Por exemplo, `tag-key="myTagKey"`.
+  `tag-value` – O valor de uma tag de recurso. Por exemplo, `tag-value="myTagValue"`.
Forneça vários pares de valores-chave para lógica `AND` condicional. O exemplo a seguir filtra qualquer recurso do DynamoDB marcado com `myTagKey` como a chave da tag: `--filter resource-type-prefix="AWS::DynamoDB::", tag-key="myTagKey"`.  
Forneça a opção `--filter` várias vezes em um único comando para a lógica condicional `OR`. O exemplo a seguir filtra qualquer recurso que seja um recurso do DynamoDB ou que esteja marcado com `myTagKey` como a chave da tag: `--filter resource-type-prefix="AWS::DynamoDB::" --filter tag-key="myTagKey"`.  
 *Obrigatório*: não<a name="ref-cli-cdk-migrate-options-help"></a>

 `--help, -h <BOOLEAN>`   
Mostrar as informações de referência do comando `cdk migrate`.<a name="ref-cli-cdk-migrate-options-language"></a>

 `--language <STRING>`   
A linguagem de programação a ser usada no projeto do CDK criado durante a migração.  
 *Obrigatório*: não  
 *Valores válidos*: `typescript`, `python`, `java`, `csharp`, `go`.  
 *Padrão*: `typescript` <a name="ref-cli-cdk-migrate-options-output-path"></a>

 `--output-path <PATH>`   
O caminho de saída para o projeto do CDK migrado.  
 *Obrigatório*: não  
 *Padrão*: por padrão, a CLI do AWS CDK usará seu diretório de trabalho atual.<a name="ref-cli-cdk-migrate-options-region"></a>

 `--region <STRING>`   
A região da AWS da qual recuperar o modelo de pilha do AWS CloudFormation.  
 *Obrigatório*: não  
 *Padrão*: a CLI do AWS CDK obtém informações da região da AWS de fontes padrão.

## Exemplos
<a name="ref-cli-cdk-migrate-examples"></a>

### Exemplo simples de migração de uma pilha do CloudFormation
<a name="ref-cli-cdk-migrate-examples-1"></a>

Migre de uma pilha implantada do CloudFormation em um ambiente específico usando o AWS `--from-stack`. Forneça um nome `--stack-name` para sua nova pilha do CDK. Veja a seguir um exemplo que migra `myCloudFormationStack` para um nova aplicação do CDK que está usando o TypeScript:

```
$ cdk migrate --language typescript --from-stack --stack-name 'myCloudFormationStack'
```

### Exemplo simples de migração de um modelo local do CloudFormation
<a name="ref-cli-cdk-migrate-examples-2"></a>

Migre de um modelo JSON ou YAML local do CloudFormation usando o `--from-path`. Forneça um nome `--stack-name` para sua nova pilha do CDK. Veja a seguir um exemplo que cria um nova aplicação do CDK em Typecript que inclui uma pilha `myCloudFormationStack` de um arquivo local `template.json`:

```
$ cdk migrate --stack-name "myCloudFormationStack" --language typescript --from-path "./template.json"
```

### Exemplo simples de migração de recursos AWS implantados
<a name="ref-cli-cdk-migrate-examples-3"></a>

Migre os recursos AWS implantados de um ambiente AWS específico que não estão associados a uma pilha do CloudFormation usando o `--from-scan`. A CLI do CDK utiliza o serviço IaC generator para escanear recursos e gerar um modelo. Em seguida, a CLI do CDK faz referência ao modelo para criar a nova aplicação do CDK. Veja a seguir um exemplo que cria um nova aplicação do CDK em TypeScript com uma nova pilha `myCloudFormationStack` contendo recursos AWS migrados:

```
$ cdk migrate --language typescript --from-scan --stack-name "myCloudFormationStack"
```

# `cdk notices`
<a name="ref-cli-cmd-notices"></a>

Exibir avisos para sua aplicação CDK.

Os avisos podem incluir mensagens importantes sobre vulnerabilidades de segurança, regressões e uso de versões não suportadas.

Esse comando exibe avisos relevantes, independentemente de terem sido reconhecidos ou não. Por padrão, avisos relevantes também podem aparecer após cada comando.

É possível suprimir os Avisos das seguintes maneiras:
+ Por meio de opções de comando. Veja um exemplo a seguir:

  ```
  $ cdk deploy --no-notices
  ```
+ Suprimir todos os avisos indefinidamente por meio do contexto no arquivo `cdk.json` do projeto:

  ```
  {
    "notices": false,
    "context": {
      // ...
    }
  }
  ```
+ Reconhecer cada aviso com o comando `cdk acknowledge`.

## Uso
<a name="ref-cli-cmd-notices-usage"></a>

```
$ cdk notices <options>
```

## Opções
<a name="ref-cli-cmd-notices-options"></a>

Para obter uma lista das opções globais que funcionam com todos os comandos da CLI do CDK, consulte [Opções globais](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-notices-options-help"></a>

 `--help, -h <BOOLEAN>`   
Mostrar as informações de referência do comando `cdk notices`.

## Exemplos
<a name="ref-cli-cmd-notices-examples"></a>

### Exemplo de um aviso padrão exibido após a execução do comando implantar cdk
<a name="ref-cli-cmd-notices-examples-1"></a>

```
$ cdk deploy

... # Normal output of the command

NOTICES

16603   Toggling off auto_delete_objects for Bucket empties the bucket

        Overview: If a stack is deployed with an S3 bucket with
                  auto_delete_objects=True, and then re-deployed with
                  auto_delete_objects=False, all the objects in the bucket
                  will be deleted.

        Affected versions: <1.126.0.

        More information at: https://github.com/aws/aws-cdk/issues/16603


17061   Error when building EKS cluster with monocdk import

        Overview: When using monocdk/aws-eks to build a stack containing
                  an EKS cluster, error is thrown about missing
                  lambda-layer-node-proxy-agent/layer/package.json.

        Affected versions: >=1.126.0 <=1.130.0.

        More information at: https://github.com/aws/aws-cdk/issues/17061


If you don’t want to see an notice anymore, use "cdk acknowledge ID". For example, "cdk acknowledge 16603"
```

### Exemplo simples de execução do comando avisos cdk
<a name="ref-cli-cmd-notices-examples-2"></a>

```
$ cdk notices

NOTICES

16603   Toggling off auto_delete_objects for Bucket empties the bucket

        Overview: if a stack is deployed with an S3 bucket with
                  auto_delete_objects=True, and then re-deployed with
                  auto_delete_objects=False, all the objects in the bucket
                  will be deleted.

        Affected versions: framework: <=2.15.0 >=2.10.0

        More information at: https://github.com/aws/aws-cdk/issues/16603


If you don’t want to see a notice anymore, use "cdk acknowledge <id>". For example, "cdk acknowledge 16603"
```

# `cdk refactor`
<a name="ref-cli-cmd-refactor"></a>

**Importante**  
O comando `cdk refactor` é uma versão de teste e está sujeita a alterações.  
É necessário fornecer a opção `--unstable=refactor` ao usar esse comando.

Preserve os recursos implantados ao refatorar o código em sua aplicação do kit de desenvolvimento em nuvem da AWS (CDK da AWS).

Quando você renomeia constructos ou os move entre pilhas em seu código do CDK, o CloudFormation normalmente os trata como novos recursos, causando substituições que podem levar a interrupções de serviços ou a perda de dados. O comando `cdk refactor` detecta essas alterações de forma inteligente e funciona com a API de refatoração do CloudFormation para preservar seus recursos enquanto atualiza seus IDs lógicos.

Com o `cdk refactor`, você pode:
+ Renomeie os constructos para obter maior clareza em sua base de código sem causar a substituição de recursos.
+ Mova recursos entre pilhas para melhorar a organização e a separação de interesses.
+ Reorganize sua hierarquia de constructos (como agrupar recursos da AWS em um novo constructo L3) enquanto preserva os recursos de nuvem subjacentes.
+ Atualize ou alterne com segurança entre bibliotecas de constructos, incluindo dependências de terceiros, sem acionar a substituição de recursos quando os IDs lógicos mudam entre as versões.

Esse comando analisa suas alterações, mostra uma lista de recursos que mudarão de local (pilha e ID lógico) e gerencia o complexo processo de atualização dos recursos do CloudFormation, mantendo sua identidade e estado.

Quando executado, o comando calcula automaticamente os mapeamentos comparando seu código atual com o estado implantado. Ela verifica se sua aplicação do CDK contém exatamente o mesmo conjunto de recursos do estado implantado, diferindo apenas em suas localizações na árvore de constructos. Se o comando detectar quaisquer adições, exclusões ou modificações de recursos, a operação de refatoração será rejeitada com uma mensagem de erro.

Após o mapeamento do cálculo, o comando mostrará as alterações propostas e, após a confirmação do usuário, aplicará a refatoração. Se for detectada ambiguidade (onde vários mapeamentos válidos são possíveis), é possível fornecer um arquivo de substituição com mapeamentos explícitos para resolver esses casos.

Para obter uma introdução, consulte [Preservação de recursos implantados ao refatorar o código do CDK](refactor.md).

## Uso
<a name="ref-cli-cmd-refactor-usage"></a>

```
$ cdk refactor <arguments> <options>
```

## Argumentos
<a name="ref-cli-cmd-refactor-args"></a><a name="ref-cli-cmd-refactor-args-stack-id"></a>

 **ID da pilha CDK**   
O ID de constructo da pilha do CDK da sua aplicação a refatorar.  
É possível especificar vários IDs de pilha para focar a operação de refatoração nessas pilhas. Se os recursos estiverem sendo movidos entre as pilhas e uma dessas pilhas não estiver explicitamente incluída, o comando de refatoração incluirá automaticamente a pilha adicional na operação.  
Se você não fornecer nenhum ID de pilha, todas as pilhas na aplicação serão consideradas para refatoração.  
 *Tipo:* string  
 *Obrigatório*: não

## Opções
<a name="ref-cli-cmd-refactor-options"></a>

Para obter uma lista das opções globais que funcionam com todos os comandos da CLI do CDK, consulte [Opções globais](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-refactor-options-dry-run"></a>

 `--dry-run`   
Imprima o mapeamento no console sem aplicá-lo.  
Essa opção é útil para validar suas alterações antes de realmente realizar a refatoração, especialmente ao trabalhar com aplicações complexas. Ele mostra exatamente quais alterações seriam feitas sem modificar nenhum recurso.<a name="ref-cli-cmd-refactor-options-force"></a>

 `--force`   
Prossiga com a refatoração sem solicitar a confirmação do usuário.  
Isso é útil em ambientes interativos quando você está confiante sobre as mudanças. Em ambientes não interativos, como pipelines de CI/CD, a CLI do CDK prossegue automaticamente sem aviso prévio, portanto, essa opção não é necessária.<a name="ref-cli-cmd-refactor-options-help"></a>

 `--help, -h <BOOLEAN>`   
Mostrar as informações de referência do comando `cdk refactor`.<a name="ref-cli-cmd-refactor-options-override-file"></a>

 `--override-file <FILE>`   
Forneça substituições quando a CLI do CDK não for capaz de determinar uma resolução de refatoração para os recursos. Esse arquivo contém mapeamentos de recursos no formato .json. Veja um exemplo a seguir:  

```
{
    "environments": [
        {
            "account": "123456789012",
            "region": "us-east-2",
            "resources": {
                "StackA.OldName": "StackB.NewName",
                "StackC.Foo": "StackC.Bar"
            }
        }
    ]
}
```<a name="ref-cli-cmd-refactor-options-revert"></a>

 `--revert <FILE>`   
Reverta uma refatoração anterior. É necessário fornecer um arquivo de substituição com mapeamentos de recursos.  
Isso não desfaz completamente uma operação de refatoração anterior. Para reverter totalmente uma refatoração, você precisa reverter sua aplicação para um estado anterior e executar o processo de refatoração novamente.

# `cdk rollback`
<a name="ref-cli-cmd-rollback"></a>

Use o comando `cdk rollback` da interface de linha de comandos (CLI) do kit de desenvolvimento em nuvem da AWS (CDK da AWS) para reverter uma pilha com falha ou pausada de uma implantação do AWS CloudFormation para seu último estado estável.

**nota**  
Para usar este comando, você deve ter a v23 do modelo de inicialização implantada em seu ambiente. Para obter mais informações, consulte [Histórico de versões de modelos de bootstrapping](bootstrapping-env.md#bootstrap-template-history).

Quando você implanta usando `cdk deploy`, a CLI do CDK reverte uma implantação com falha por padrão. Se você especificar `--no-rollback` com `cdk deploy`, poderá usar o comando `cdk rollback` para reverter manualmente uma implantação com falha. Isso iniciará uma reversão para o último estado estável da sua pilha.

## Uso
<a name="ref-cli-cmd-rollback-usage"></a>

```
$ cdk rollback <arguments> <options>
```

## Argumentos
<a name="ref-cli-cmd-rollback-args"></a><a name="ref-cli-cmd-rollback-args-stack-name"></a>

 **ID da pilha CDK**   
O ID de constructo da pilha do CDK da sua aplicação para a reversão.  
 *Tipo:* string  
 *Obrigatório*: não

## Opções
<a name="ref-cli-cmd-rollback-options"></a>

Para obter uma lista das opções globais que funcionam com todos os comandos da CLI do CDK, consulte [Opções globais](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-rollback-options-all"></a>

 `--all <BOOLEAN>`   
Reverter todas as pilhas em sua aplicação CDK.  
 *Valor padrão*: `false` <a name="ref-cli-cmd-rollback-options-force"></a>

 `--force, -f <BOOLEAN>`   
Quando você usa o `cdk rollback`, alguns recursos podem falhar na reversão. Forneça essa opção para forçar a reversão de todos os recursos. Esse é o mesmo comportamento de fornecer a opção `--orphan` para cada recurso em sua pilha.  
 *Valor padrão*: `false` <a name="ref-cli-cmd-rollback-options-help"></a>

 `--help, -h <BOOLEAN>`   
Mostrar as informações de referência do comando `cdk rollback`.<a name="ref-cli-cmd-rollback-options-orphan"></a>

 `--orphan <LogicalId>`   
Quando você usa o `cdk rollback`, alguns recursos podem falhar na reversão. Quando isso acontece, você pode tentar forçar a reversão de um recurso usando essa opção e fornecendo o ID lógico do recurso que falhou na reversão.  
Essa opção pode ser fornecida várias vezes em um único comando. Veja a seguir um exemplo:  

```
$ cdk rollback MyStack --orphan MyLambdaFunction --orphan MyLambdaFunction2
```
Para forçar a reversão de todos os recursos, use a opção `--force`.<a name="ref-cli-cmd-rollback-options-toolkit-stack-name"></a>

 `--toolkit-stack-name <STRING>`   
O nome da pilha existente do Kit de Ferramentas CDK com a qual o ambiente é inicializado.  
Por padrão, o `cdk bootstrap` implanta uma pilha chamada `CDKToolkit` no ambiente AWS especificado. Use essa opção para fornecer um nome diferente para sua pilha de bootstrapping.  
A CLI do CDK usa esse valor para verificar a versão da pilha de bootstrapping.<a name="ref-cli-cmd-rollback-options-validate-bootstrap-version"></a>

 `--validate-bootstrap-version <BOOLEAN>`   
Especifique se deseja validar a versão da pilha de bootstrapping. Forneça o `--validate-bootstrap-version=false` ou `--no-validate-bootsrap-version` para desativar esse comportamento.  
 *Valor padrão*: `true` 

# `cdk synthesize`
<a name="ref-cli-cmd-synth"></a>

Sintetize uma aplicação do CDK para produzir um conjunto de nuvem, incluindo um modelo do AWS CloudFormation para cada pilha.

Conjuntos de nuvem são arquivos que incluem tudo o que é necessário para implantar sua aplicação em seu ambiente da AWS. Por exemplo, ele inclui um modelo do CloudFormation para cada pilha em sua aplicação e uma cópia dos ativos de arquivo ou imagens do Docker que você faz referência em sua aplicação.

Se sua aplicação contiver uma única pilha ou se uma única pilha for fornecida como argumento, o modelo do CloudFormation também será exibido na saída padrão (`stdout`) no formato YAML.

Se sua aplicação contiver várias pilhas, o `cdk synth` sintetizará o conjunto de nuvem para `cdk.out`.

## Uso
<a name="ref-cli-cmd-synth-usage"></a>

```
cdk synthesize <arguments> <options>
```

## Argumentos
<a name="ref-cli-cmd-synth-args"></a><a name="ref-cli-cmd-synth-args-stack-name"></a>

 **ID da pilha CDK**   
O ID de constructo da pilha CDK da sua aplicação para sintetizar.  
 *Tipo:* string  
 *Obrigatório*: não

## Opções
<a name="ref-cli-cmd-synth-options"></a>

Para obter uma lista das opções globais que funcionam com todos os comandos da CLI do CDK, consulte [Opções globais](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-synth-options-exclusively"></a>

 `--exclusively, -e <BOOLEAN>`   
Sintetize apenas as pilhas solicitadas, não inclua dependências.<a name="ref-cli-cmd-synth-options-help"></a>

 `--help, -h <BOOLEAN>`   
Mostrar as informações de referência do comando `cdk synthesize`.<a name="ref-cli-cmd-synth-options-quiet"></a>

 `--quiet, -q <BOOLEAN>`   
Não resultar em um modelo do CloudFormation para `stdout`.  
Essa opção pode ser configurada no arquivo `cdk.json` do projeto do CDK. Veja um exemplo a seguir:  

```
{
   "quiet": true
}
```
 *Valor padrão*: `false` <a name="ref-cli-cmd-synth-options-validation"></a>

 `--validation <BOOLEAN>`   
Validar os modelos do CloudFormation gerados após a síntese realizando verificações adicionais.  
Você também pode configurar essa opção por meio do atributo `validateOnSynth` ou da variável de ambiente `CDK_VALIDATION`.  
 *Valor padrão*: `true` 

## Exemplos
<a name="ref-cli-cmd-synth-examples"></a>

### Sintetize a conjunto de nuvem para uma pilha do CDK com o ID lógico MyStackName e enviar o modelo do CloudFormation para stdout
<a name="ref-cli-cmd-synth-examples-1"></a>

```
$ cdk synth MyStackName
```

### Sintetizar o conjunto de nuvem para todas as pilhas em uma aplicação CDK e salvá-las em cdk.out
<a name="ref-cli-cmd-synth-examples-2"></a>

```
$ cdk synth
```

### Sintetizar o conjunto de nuvem para MyStackName, mas não incluir dependências
<a name="ref-cli-cmd-synth-examples-3"></a>

```
$ cdk synth MyStackName --exclusively
```

### Sintetizar o conjunto de nuvem para MyStackName, mas não imprimir o modelo CloudFormation para stdout
<a name="ref-cli-cmd-synth-examples-4"></a>

```
$ cdk synth MyStackName --quiet
```

# `cdk watch`
<a name="ref-cli-cmd-watch"></a>

Observe continuamente um projeto local de AWS CDK em busca de mudanças na realização de implantações e hotswaps.

Esse comando é semelhante ao `cdk deploy`, exceto que ele pode realizar implantações contínuas e hotswaps por meio de um único comando.

Esse comando é um atalho para `cdk deploy --watch`.

Para finalizar uma sessão `cdk watch`, interrompa o processo pressionando `Ctrl+C`.

Os arquivos observados são determinados pela configuração `"watch"` em seu arquivo `cdk.json`. Ele tem duas subchaves, `"include"` e `"exclude"`, que aceitam uma única string ou uma matriz de strings. Cada entrada é interpretada como um caminho relativo à localização do arquivo `cdk.json`. Tanto `*` quanto `**` são aceitos.

Se você criar um projeto usando o comando `cdk init`, o seguinte comportamento padrão será configurado para o `cdk watch` no arquivo `cdk.json` do seu projeto:
+  `"include"` é definido como `"**/*"`, o que inclui todos os arquivos e diretórios na raiz do projeto.
+  `"exclude"` é opcional, exceto para arquivos e pastas já ignorados por padrão. Isso consiste em arquivos e diretórios começando com `.`, o diretório de saída do CDK e o diretório `node_modules`.

A configuração mínima a ser configurada no `watch` é `"watch": {}`.

Se o código do CDK ou o código da aplicação exigirem uma etapa de compilação antes da implantação, o `cdk watch` trabalha com a chave `"build"` no arquivo `cdk.json`.

**Importante**  
Esse comando é destinado à implantação rápida durante a fase de desenvolvimento do CDK Apps e não é recomendado para implantações de produção.

As mesmas limitações do `cdk deploy --hotswap` se aplicam ao `cdk watch`. Para obter mais informações, consulte ` cdk deploy --hotswap `.

## Usage
<a name="ref-cli-cmd-watch-usage"></a>

```
$ cdk watch <arguments> <options>
```

## Argumentos
<a name="ref-cli-cmd-watch-args"></a><a name="ref-cli-cmd-watch-args-stack-name"></a>

 **ID da pilha CDK**   
O ID de constructo da pilha do CDK da sua aplicação a observar.  
 *Tipo:* string  
 *Obrigatório*: não

## Opções
<a name="ref-cli-cmd-watch-options"></a>

Para obter uma lista das opções globais que funcionam com todos os comandos da CLI do CDK, consulte [Opções globais](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-watch-options-build-exclude"></a>

 `--build-exclude, -E <ARRAY>`   
Não recompile o ativo com o ID fornecido.  
Esta opção pode ser especificada várias vezes em um único comando.  
 *Valor padrão*: `[]` <a name="ref-cli-cmd-watch-options-change-set-name"></a>

 `--change-set-name <STRING>`   
O nome do conjunto de CloudFormation alterações a ser criado.<a name="ref-cli-cmd-watch-options-concurrency"></a>

 `--concurrency <NUMBER>`   
Implantar e fazer o hotswap de várias pilhas em paralelo enquanto contabiliza as dependências entre pilhas. Use essa opção para acelerar as implantações. Você ainda deve considerar qualquer outra limitação AWS da taxa da conta. CloudFormation   
Forneça um número para especificar o número máximo de implantações simultâneas (se a dependência permitir) a serem executadas.  
 *Valor padrão*: `1` <a name="ref-cli-cmd-watch-options-exclusively"></a>

 `--exclusively, -e <BOOLEAN>`   
Implante somente as pilhas solicitadas e não inclua dependências.<a name="ref-cli-cmd-watch-options-force"></a>

 `--force, -f <BOOLEAN>`   
Sempre implante pilhas, mesmo que os modelos sejam idênticos.  
 *Valor padrão*: `false` <a name="ref-cli-cmd-watch-options-help"></a>

 `--help, -h <BOOLEAN>`   
Mostrar as informações de referência do comando `cdk watch`.<a name="ref-cli-cmd-watch-options-hotswap"></a>

 `--hotswap <BOOLEAN>`   
Por padrão, o `cdk watch` usa implantações de hotswap quando possível para atualizar seus recursos. A CLI do CDK tentará realizar uma implantação de hotswap e não retornará a uma CloudFormation implantação completa se não for bem-sucedida. Quaisquer alterações detectadas que não possam ser atualizadas por meio de um hotswap são ignoradas.  
 *Valor padrão*: `true` <a name="ref-cli-cmd-watch-options-hotswap-fallback"></a>

 `--hotswap-fallback <BOOLEAN>`   
Por padrão, `cdk watch` tenta realizar implantações de hotswap e ignora as alterações que exigem implantações. CloudFormation `--hotswap-fallback`Forneça uma alternativa e execute uma CloudFormation implantação completa se a implantação do hotswap não for bem-sucedida.<a name="ref-cli-cmd-watch-options-logs"></a>

 `--logs <BOOLEAN>`   
Por padrão, `cdk watch` monitora todos os grupos de CloudWatch log em seu aplicativo e transmite os eventos de log localmente para o. `stdout`  
 *Valor padrão*: `true` <a name="ref-cli-cmd-watch-options-progress"></a>

 `--progress <STRING>`   
Configure como a CLI do CDK exibe o andamento da implantação.  
+  `bar` – Exibir os eventos de implantação da pilha como uma barra de andamento, com os eventos do recurso que está sendo implantado no momento.
+  `events`— Forneça um histórico completo, incluindo todos os CloudFormation eventos.
Você também pode configurar essa opção no arquivo `cdk.json` do projeto ou em `~/.cdk.json` na sua máquina de desenvolvimento local:  

```
{
   "progress": "events"
}
```
 *Valores válidos*: `bar`, `events`   
 *Valor padrão*: `bar` <a name="ref-cli-cmd-watch-options-rollback"></a>

 `--rollback <BOOLEAN>`   
Durante a implantação, se um recurso não for criado ou atualizado, a implantação voltará ao estado estável mais recente antes que a CLI do CDK retorne. Todas as alterações feitas até esse ponto serão desfeitas. Os recursos criados serão excluídos e as atualizações feitas serão revertidas.  
Use `--no-rollback` ou `-R` para desativar esse comportamento. Se um recurso não for criado ou atualizado, a CLI do CDK manterá as alterações feitas até aquele momento e retornará. Isso pode ser útil em ambientes de desenvolvimento em que você está iterando rapidamente.  
Quando `false`, implantações que causam substituições de recursos sempre falharão. Você só pode usar esse valor para implantações que atualizam ou criam novos recursos.
 *Valor padrão*: `true` <a name="ref-cli-cmd-watch-options-toolkit-stack-name"></a>

 `--toolkit-stack-name <STRING>`   
O nome da pilha existente do CDK Toolkit.  
Por padrão, `cdk bootstrap` implanta uma pilha nomeada `CDKToolkit` no ambiente especificado AWS . Use essa opção para fornecer um nome diferente para sua pilha de bootstrapping.  
A CLI do CDK usa esse valor para verificar a versão da pilha de bootstrapping.

## Exemplos
<a name="ref-cli-cmd-watch-examples"></a>

### Veja as alterações em uma pilha de CDK com ID DevelopmentStack lógica
<a name="ref-cli-cmd-watch-examples-1"></a>

```
$ cdk watch DevelopmentStack
Detected change to 'lambda-code/index.js' (type: change). Triggering 'cdk deploy'
DevelopmentStack: deploying...

 ✅  DevelopmentStack
```

### Configure um arquivo cdk.json para saber o que incluir e excluir da observação de alterações
<a name="ref-cli-cmd-watch-examples-2"></a>

```
{
   "app": "mvn -e -q compile exec:java",
   "watch": {
    "include": "src/main/**",
    "exclude": "target/*"
   }
}
```

### Criação de um projeto do CDK usando Java antes da implantação com a configuração do arquivo cdk.json
<a name="ref-cli-cmd-watch-examples-3"></a>

```
{
  "app": "mvn -e -q exec:java",
  "build": "mvn package",
  "watch": {
    "include": "src/main/**",
    "exclude": "target/*"
  }
}
```