# Excluir pilhas do CloudFormation StackSets
<a name="stackinstances-delete"></a>

É possível excluir pilhas de StackSets usando o console ou a AWS CLI do CloudFormation. 

**Topics**
+ [Excluir pilhas do seu StackSet (console)](#stackinstances-delete-console)
+ [Excluir pilhas do StackSet (AWS CLI)](#stackinstances-delete-cli)

**nota**  
Excluir pilhas de uma unidade organizacional (UO) do nível superior removerá essa UO como um destino do StackSet.

## Excluir pilhas do seu StackSet (console)
<a name="stackinstances-delete-console"></a>

**Para excluir pilhas**

1. Faça login no Console de gerenciamento da AWS e abra o console CloudFormation em [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/).

1. Na barra de navegação na parte superior da tela, escolha a Região da AWS em que você criou o StackSet.

1. No painel de navegação, escolha **StackSets**. Na página StackSets, selecione o StackSet.

1. Com o StackSet selecionado, escolha **Excluir pilhas do StackSet** no menu **Ações**.

1. Na página **Definir opções de implantação**, primeiro escolha as contas e as regiões nas quais você deseja excluir as pilhas.

   1. [Permissões autogerenciadas] Em **Contas**, escolha **Implantar pilhas em contas** ou **Implantar pilhas em unidades organizacionais**.

      Se você escolher **Implantar pilhas em contas**, cole os números das contas de destino na caixa de texto **Números das contas**, separando os números com vírgulas.

      Se você escolher **Implantar pilhas em unidades organizacionais**, cole a ID da OU de destino na caixa de texto **Números da organização** para que todas as contas da organização especificada sejam destino da implantação.

   1. [Permissões gerenciadas pelo serviço] Em **Unidades organizacionais (UOs),** especifique os IDs das UOs de destino. 
**Importante**  
O CloudFormation excluirá as pilhas das UOs de destino especificadas e das OUs subordinadas a elas.

      Em **Tipo de filtro da conta**, você pode refinar de quais contas as pilhas serão excluídas escolhendo uma das opções a seguir e fornecendo os números das contas. 
      + **Nenhuma** (padrão): excluir as pilhas de todas as contas da UOs especificadas.
      + **Interseção**: excluir as pilhas apenas de determinadas contas individuais das UOs selecionadas.
      + **Diferença**: excluir as pilhas de todas as contas das UOs selecionadas, exceto determinadas contas.
      + **União**: excluir as pilhas das UOs especificadas e também de contas individuais adicionais.

   1. Em **Especificar regiões**, escolha as regiões das quais você deseja excluir as pilhas das contas de destino.

1. Em **Opções de implantação**, faça o seguinte:
   + Em **Máximo de contas simultâneas**, especifique quantas contas são processadas simultaneamente.
   + Em **Tolerância a falhas**, especifique o número máximo de falhas de conta permitidas por região. A operação será interrompida e não prosseguirá para outras regiões quando esse limite for atingido.
   + Em **Reter pilhas**, habilite esta opção para salvar as pilhas e os recursos a elas associados ao removê-las do StackSet. Os recursos permanecem em seu estado atual, mas não fazem mais parte do StackSet.
   + Em **Simultaneidade de regiões**, escolha o modo de processar as regiões: **Sequencial** (uma região de cada vez) ou **Paralelo** (várias regiões simultaneamente).
   + Em **Modo de simultaneidade**, escolha como a simultaneidade se comporta durante a execução de uma operação.
     + **Tolerância a falhas estrita**: reduz o nível de simultaneidade da conta quando ocorrem falhas, permanecendo dentro da faixa de **Tolerância a falhas** \$11.
     + **Tolerância a falhas flexível**: mantém o nível de simultaneidade especificado (o valor de **Máximo de contas simultâneas**) a despeito de falhas. 

1. Escolha **Próximo**.

1. Na página **Analisar**, examine suas escolhas. Para fazer alterações, escolha **Editar** na seção relacionada.

1. Quando estiver tudo pronto para remover as pilhas do StackSet, escolha **Enviar**.

   Após a exclusão de pilhas ser concluída, é possível verificar se as pilhas foram excluídas do StackSet na página de detalhes do StackSet, na guia **Instâncias de pilha**.

## Excluir pilhas do StackSet (AWS CLI)
<a name="stackinstances-delete-cli"></a>

**nota**  
Ao atuar como um administrador delegado, você deve incluir `--call-as DELEGATED_ADMIN` no comando. 

Use o comando **delete-stack-instances** com o nome do StackSet.

Nestes exemplos, usamos a opção `--no-retain-stacks` porque não vamos reter nenhuma pilha. Use `--retain-stacks` em vez de `--no-retain-stacks` se quiser manter as pilhas e seus recursos. 

Em `--regions`, especifique as Regiões da AWS das quais você deseja excluir pilhas, por exemplo, `us-west-2` e `us-east-1`.

Defina o processamento simultâneo de contas e outras preferências usando a opção `--operation-preferences`. Esses exemplos usam configurações baseadas em contagem. Observe que `MaxConcurrentCount` não deve exceder `FailureToleranceCount` \$1 1. Para configurações baseadas em porcentagem, use `FailureTolerancePercentage` ou `MaxConcurrentPercentage` em vez disso. 

**Para excluir pilhas (permissões autogerenciadas)**  
Na opção `--accounts`, especifique os IDs das contas das quais as pilhas serão excluídas.

```
aws cloudformation delete-stack-instances --stack-set-name my-stackset \
  --accounts account_ID_1 account_ID_2 \
  --regions us-west-2 us-east-1 \
  --no-retain-stacks \
  --operation-preferences MaxConcurrentCount=1,FailureToleranceCount=0
```

**Para excluir pilhas (permissões gerenciadas pelo serviço)**  
Em `--deployment-targets`, especifique o ID raiz da organização ou os IDs das unidades organizacionais (UOs) das quais as pilhas serão excluídas.

**Importante**  
O CloudFormation excluirá as pilhas das UOs de destino especificadas e das OUs subordinadas a elas.

```
aws cloudformation delete-stack-instances --stack-set-name my-stackset \
  --deployment-targets OrganizationalUnitIds=ou-rcuk-1x5jlwo,ou-rcuk-slr5lh0a \ 
  --regions us-west-2 us-east-1 \
  --no-retain-stacks \
  --operation-preferences MaxConcurrentCount=1,FailureToleranceCount=0
```

Para obter mais informações, consulte [DeleteStackInstances](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DeleteStackInstances.html) na *AWS CloudFormation API Reference*.

Opcionalmente, após a exclusão das pilhas ser concluída, verifique se as pilhas foram excluídas do StackSet executando o comando **describe-stack-set-operation** para mostrar o status e os resultados da operação de exclusão de pilhas. Em `--operation-id`, use o ID de operação que foi retornado pelo comando **delete-stack-instances**.

```
aws cloudformation describe-stack-set-operation --stack-set-name my-stackset \
  --operation-id ddf16f54-ad62-4d9b-b0ab-3ed8e9example
```