# Atualizar o CloudFormation StackSets
<a name="stacksets-update"></a>

Você pode atualizar seu StackSet usando o console do CloudFormation ou a AWS CLI. 

Para adicionar e remover contas e regiões de um StackSet, consulte [Adicionar pilhas a StackSets](stackinstances-create.md) e [Excluir pilhas de StackSets](stackinstances-delete.md). Para substituir os valores dos parâmetros de uma pilha, consulte [Substituir parâmetros em pilhas](stackinstances-override.md). 

**Topics**
+ [Atualizar seu StackSet (console)](#stacksets-update-console)
+ [Atualizar seu StackSet (AWS CLI)](#stacksets-update-cli)

## Atualizar seu StackSet (console)
<a name="stacksets-update-console"></a>

**Para atualizar um StackSet**

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

1. Na página **StackSets**, selecione o StackSet que você deseja atualizar.

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

1. Na página **Escolher um modelo**, atualize a seção **Permissões** conforme necessário ou vá para a próxima etapa.

1. Em **Pré-requisito: preparar o modelo**, escolha **Usar modelo atual** para usar o modelo atual ou **Substituir modelo atual** para especificar um URL do S3 para outro modelo ou fazer upload de um novo modelo.

1. Escolha **Próximo**.

1. Na página **Especificar detalhes do StackSet**, em **Descrição do StackSet**, atualize a descrição do StackSet conforme necessário.

1. Em **Parâmetros**, atualize os valores dos parâmetros conforme necessário.

1. Escolha **Próximo**.

1. Na página **Configurar opções do StackSet**, em **Tags**, modifique as tags conforme necessário. É possível adicionar, atualizar ou excluir tags. Para obter mais informações sobre como as tags são usadas na AWS, consulte [Organizar e acompanhar custos usando tags de alocação de custos da AWS](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) no *Guia do usuário do Gerenciamento de Faturamento e Custos da AWS*.

1. Em **Configuração de execução**, é possível atualizar a configuração de execução conforme necessário. 
**nota**  
Lembre-se de que você não pode alterar as configurações de execução quando há operações em execução ou em fila.

1. Se o seu modelo contém recursos do IAM, em **Recursos**, escolha **Eu reconheço que este modelo pode criar recursos do IAM** para especificar que você deseja usar recursos do IAM no modelo. Para obter mais informações, consulte [Confirmar recursos do IAM em modelos do CloudFormation](control-access-with-iam.md#using-iam-capabilities).

1. Escolha **Próximo**.

1. Na página **Definir opções de implantação**, informe forneça as contas e regiões para a atualização.

   O CloudFormation implantará atualizações de pilhas nas contas especificadas na primeira região, depois passará para a próxima e assim por diante, desde que as falhas de implantação de uma região não excedam uma tolerância a falhas especificada.

   1. [Permissões autogerenciadas] Em **Contas**, **Locais de implantação**, escolha **Implantar pilhas em contas**. Cole os IDs das contas de destino usadas para criar o StackSet na caixa de texto, separando os números distintos com vírgulas. 

      [Permissões gerenciadas pelo serviço] Siga um destes procedimentos:
      + Escolha **Deploy to organizational units (OUs) (Implantar em unidades organizacionais (OUs))**. Insira as UOs de destino que você usou para criar seu StackSet.
      + Escolha **Deploy to accounts (Implantar em contas)**. Cole os IDs das UOs ou das contas de destino usados para criar seu StackSet.

   1. Em **Especificar regiões**, especifique a ordem na qual você deseja que o CloudFormation implemente suas atualizações.

   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 **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. 
      + [Permissões gerenciadas pelo serviço] Para **dependências** do StackSet, adicione ARNs dependentes do StackSet, permanecendo com dez dependências no máximo. Para obter mais informações, consulte [Habilite ou desabilite implantações automáticas de StackSets no AWS Organizations](stacksets-orgs-manage-auto-deployment.md).

   1. Escolha **Próximo** para continuar.

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

1. Quando estiver pronto para prosseguir, escolha **Enviar**.

   O CloudFormation começa a aplicar as atualizações ao seu StackSet e exibe a guia **Operações** da página de detalhes do StackSet. É possível visualizar o progresso e o status das operações de atualização na guia **Operations (Operações)**.

## Atualizar seu StackSet (AWS CLI)
<a name="stacksets-update-cli"></a>

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

1. 

**Para atualizar um StackSet**

   Use o comando [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/update-stack-set.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/update-stack-set.html) para fazer alterações no seu StackSet.

   Nos exemplos a seguir, vamos atualizar o StackSet usando a opção `--parameters`. Especificamente, alteramos a frequência de entrega do snapshot padrão para a configuração do canal de entrega de `TwentyFour_Hours` para `Twelve_Hours`. Como continuaremos a usar o modelo atual, adicionaremos a opção `--use-previous-template`.

   Defina o processamento simultâneo de contas e outras preferências de implantação 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. 

   [Permissões autogerenciadas] Para a opção `--accounts`, forneça os IDs das contas que você deseja que a atualização tenha como destino.

   ```
   aws cloudformation update-stack-set --stack-set-name my-stackset \
     --use-previous-template \
     --parameters ParameterKey=MaximumExecutionFrequency,ParameterValue=Twelve_Hours \
     --accounts account_ID_1 account_ID_2 \
     --regions us-west-2 us-east-1 \
     --operation-preferences MaxConcurrentCount=1,FailureToleranceCount=0
   ```

   [Permissões gerenciadas pelo serviço] Na opção `--deployment-targets`, forneça o ID da raiz da organização ou os IDs das unidades organizacionais (UOs) às quais você deseja que a atualização se aplique.

   ```
   aws cloudformation update-stack-set --stack-set-name my-stackset \
     --use-previous-template \
     --parameters ParameterKey=MaximumExecutionFrequency,ParameterValue=Twelve_Hours \
     --deployment-targets OrganizationalUnitIds=ou-rcuk-1x5j1lwo,ou-rcuk-slr5lh0a \
     --regions us-west-2 us-east-1 \
     --operation-preferences MaxConcurrentCount=1,FailureToleranceCount=0
   ```

   Para obter mais informações, consulte [UpdateStackSet](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_UpdateStackSet.html) na *Referência de API do AWS CloudFormation*.

1. Verifique se o StackSet foi atualizado com êxito executando o comando **describe-stack-set-operation** para mostrar o status e os resultados da operação de atualização. Em `--operation-id`, use o ID de operação que foi retornado pelo comando **update-stack-set**.

   ```
   aws cloudformation describe-stack-set-operation \
     --operation-id operation_ID
   ```