Destinos no nível das contas para conjuntos de pilhas gerenciados pelo serviço - AWS CloudFormation
Exemplos do AWS CLI

Destinos no nível das contas para conjuntos de pilhas gerenciados pelo serviço

O AccountFilterType permite que você limite as metas de implantação a contas individuais ou inclua contas adicionais com unidades (UOs) do AWS Organizations fornecidas com as operações de criação, atualização ou exclusão.

Conjuntos de pilhas gerenciados pelo serviço podem ser implantados em contas individuais com o parâmetro accounts, em todas as contas ou em um subconjunto de contas na UO especificada. Para obter mais informações sobre destinos de implantações, consulte DeploymentTargets.

{
  "Accounts": ["string", ...],
  "AccountsUrl": "string", 
  "OrganizationalUnitIds": ["string", ...] 
  "AccountFilterType": "string"
}
Accounts

Os nomes de uma ou mais Contas da AWS nas quais você deseja implantar atualizações do StackSets.

AccountsUrl

Um URL do Amazon S3 para uma lista de contas.

OrganizationalUnitIds

O ID raiz da organização ou os IDs das unidades organizacionais (UO) nas quais o StackSets será implantado.

AccountFilterType

Valores válidos: INTERSECTION | DIFFERENCE | UNION

A seguir, temos uma lista de valores possíveis para a operação de AccountFilterType.

  • INTERSECTION: o StackSets é implantado nas contas especificadas no parâmetro Accounts.

  • DIFFERENCE: o StackSets exclui as contas especificadas no parâmetro Accounts. Isso permite que o usuário evite determinadas contas dentro de uma UO, como contas suspensas.

  • UNION: (valor padrão) o StackSets inclui contas adicionais como destinos de implantação.

    O valor padrão se AccountFilterType não for fornecido. Isso permite que o usuário atualize uma UO inteira e contas individuais de uma outra UO em uma única solicitação, o que costumava exigir duas solicitações separadas.

  • NONE: faz a implantação em todas as contas nas unidades organizacionais (UO) especificadas.

Exemplos do AWS CLI

Os exemplos a seguir mostram como usar AccountFilterType na AWS CLI.

Contas de destino individuais em uma UO

O exemplo a seguir filtra os destinos de implantação na UO. Neste exemplo, as contas A1, A2 e A3 estão todas na organização UO1. O comando AWS CLI faz a implantação nas contas de destino A1 e A2.

Visar contas individuais em uma UO. 
aws cloudformation create-stack-instances --deployment-targets OrganizationalUnitIds=OU1,Accounts=A1,A2,AccountFilterType=INTERSECTION

Resultados: você criou instâncias de pilha para as contas 1 e 2.

Visar uma OU e filtrar contas individuais

O exemplo a seguir cria uma instância de pilha em todas as contas da UO, além das contas 1 e 2.

Visar contas individuais em uma UO 
aws cloudformation create-stack-instances --deployment-targets OrganizationalUnitIds=OU1,Accounts=A1,A2,AccountFilterType=DIFFERENCE

Resultados: você evitou a implantação em contas específicas da UO.

Visar uma UO e uma conta individual adicional

O exemplo a seguir atualiza as instâncias de pilha.

Visar contas individuais em uma UO 
aws cloudformation update-stack-instances --deployment-targets OrganizationalUnitIds=OU1,Accounts=A4,AccountFilterType=UNION

Resultados: você atualizou as instâncias de pilha para as contas 1, 2 e 4 na UO. Filtrando as contas, você não atualizou as instâncias de pilha na conta A5.