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|UNIONA seguir, temos uma lista de valores possíveis para a operação de
AccountFilterType.-
INTERSECTION: o StackSets é implantado nas contas especificadas no parâmetroAccounts. -
DIFFERENCE: o StackSets exclui as contas especificadas no parâmetroAccounts. 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
AccountFilterTypenã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.
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.
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.
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.
