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á.
# Guia de solução de problemas do Account Factory for Terraform (AFT)
Esta seção pode ajudar a solucionar problemas comuns que você pode encontrar ao usar o Account Factory for Terraform (AFT).
**Topics**
+ [Problemas gerais](#w2aac44c33c45b7)
+ [Problemas relacionados ao provisionamento/registro da conta](#w2aac44c33c45b9)
+ [Problemas relacionados à invocação de personalizações](#w2aac44c33c45c11)
+ [Problemas relacionados ao fluxo de trabalho de personalização da conta](#w2aac44c33c45c13)
## Problemas gerais
+ **Cotas de AWS recursos excedidas**
[Se seus grupos de registros indicarem que você excedeu as cotas de AWS recursos, entre em contato com o Support AWS .](https://aws.amazon.com/premiumsupport/) O Account Factory usa Serviços da AWS com cotas de recursos que incluem AWS CodeBuild AWS Organizations, e. AWS Systems Manager Para saber mais, consulte:
+ [O que é o AWS CodeBuild?](https://docs.aws.amazon.com/codebuild/latest/userguide/welcome.html) no *CodeBuild Guia do usuário*
+ [O que é AWS Organizations?](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_introduction.html) no *Guia do Usuário do Organizations*.
+ [O que é AWS Systems Manager?](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html) no Guia do *usuário do Systems Manager*.
+ **Versão desatualizada do Account Factory**
Se encontrar um problema e achar que é um erro, verifique se você tem versão mais recente do Account Factory. Consulte mais informações em [Updating the Account Factory version](https://docs.aws.amazon.com/controltower/latest/userguide/update-aft-version.html).
+ **Foram feitas alterações locais no código-fonte do Account Factory**
O Account Factory é um projeto de código aberto. O AWS Control Tower é compatível com o código principal do Account Factory. Se você fizer uma alteração local no código principal do Account Factory, o AWS Control Tower só permitirá sua implantação do Account Factory com base no melhor esforço.
+ **Permissões insuficientes do perfil do Account Factory**
O Account Factory cria políticas e perfis do IAM para gerenciar implantações e personalizações de contas fornecidas. Se você alterar esses perfis ou políticas, o pipeline do Account Factory poderá não conseguir realizar determinadas ações. Consulte mais informações em [Required roles](https://docs.aws.amazon.com/controltower/latest/userguide/aft-required-roles.html).
+ **Repositórios de contas não preenchidos corretamente **
Certifique-se de seguir as [etapas de pós-implantação](https://docs.aws.amazon.com/controltower/latest/userguide/aft-post-deployment.html) antes de provisionar contas.
+ **Não é detectado o desvio após alterar a UO manualmente**
**nota**
O AWS Control Tower detecta o desvio automaticamente. Consulte informações sobre como resolver desvios em [Detect and resolve drift in AWS Control Tower](https://docs.aws.amazon.com/controltower/latest/userguide/drift.html#resolving-drift).
O desvio não é detectado quando a unidade organizacional (UO) é alterada manualmente. Isso se deve à natureza orientada por eventos do Account Factory. Quando uma solicitação de conta é enviada, o recurso que o Terraform gerencia é um item do Amazon DynamoDB, não uma conta direta. Depois que um item é alterado, a solicitação é colocada em uma fila, onde o AWS Control Tower a processa por meio do Service Catalog (o serviço que gerencia os detalhes da conta). Se você altera a UO manualmente, o desvio não é detectado porque a solicitação da conta não foi alterada.
## Problemas relacionados ao provisionamento/registro da conta
+ **A solicitação de conta (endereço de e-mail/nome) já existe**
O problema geralmente resulta em uma falha do produto do Service Catalog durante o provisionamento ou como `ConditionalCheckFailedException`.
Você pode encontrar mais informações sobre o problema seguindo um destes procedimentos:
+ Revise seus grupos de registros do Terraform ou do CloudWatch Logs.
+ Analise as falhas que são emitidas para o tópico `aft-failure-notifications` do Amazon SNS.
+ **Solicitação de conta criada incorretamente **
Certifique-se de que sua solicitação de conta siga o esquema esperado. Para ver exemplos, consulte [terraform-aws-control\$1tower\$1account\$1factory em](https://github.com/aws-ia/terraform-aws-control_tower_account_factory/tree/main/sources/aft-customizations-repos/aft-account-request/examples). GitHub
+ **Cotas de recursos excedidas da AWS Organizations**
Certifique-se de que sua solicitação de conta não exceda as cotas AWS Organizations de recursos. Para obter mais informações, consulte [Quotas for AWS Organizations](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_reference_limits.html).
## Problemas relacionados à invocação de personalizações
+ ** Conta de destino não integrada ao Account Factory **
Certifique-se de que todas as contas incluídas em uma solicitação de personalização tenham sido integradas ao Account Factory. Consulte mais informações em [Update an existing account](https://docs.aws.amazon.com/controltower/latest/userguide/aft-update-account.html).
+ **Conta que os destinos da solicitação de personalização existem na tabela `aft-request-metadata` do DynamoDB, mas não no repositório de solicitações de conta**
Formate sua solicitação de invocação de personalização para excluir a conta incorreta seguindo um destes procedimentos:
+ Na tabela `aft-request-metadata` do DynamoDB, exclua a entrada que faz referência à conta que não está mais no seu repositório de solicitações de conta.
+ Não use “tudo” como destino.
+ Não use como destino a OU à qual a conta pertence.
+ Não use como destino a conta diretamente.
+ ** Usou o token incorreto para o Terraform Cloud **
Verifique se configurou o token correto. O Terraform Cloud é compatível apenas com tokens baseados em equipe, não com tokens baseados em organização.
+ **Falha ao criar a conta antes da criação do pipeline de personalização da conta; não é possível personalizar a conta**
Faça uma alteração na especificação da conta no repositório de solicitações de conta. Quando você faz uma alteração, como no valor de uma tag de uma conta, o Account Factory segue o caminho que tenta criar o pipeline, mesmo que ele não exista.
## Problemas relacionados ao fluxo de trabalho de personalização da conta
Se você estiver enfrentando problemas relacionados ao fluxo de trabalho de personalização da conta, certifique-se de que sua versão do AFT seja 1.8.0 ou posterior e exclua todas as instâncias de metadados relacionados à conta da tabela de solicitações do DynamoDB.
Para obter informações sobre a versão 1.8.0 do AFT, consulte a [versão 1.8.0](https://github.com/aws-ia/terraform-aws-control_tower_account_factory/releases/tag/1.8.0) ativada. GitHub
Consulte mais informações sobre como verificar e atualizar sua versão do AFT em:
+ [Check the AFT version](https://docs.aws.amazon.com/controltower/latest/userguide/check-aft-version.html)
+ [Update the AFT version](https://docs.aws.amazon.com/controltower/latest/userguide/update-aft-version.html)
Você também pode rastrear e solucionar problemas de solicitações de personalização usando as consultas do Amazon CloudWatch Logs Insights para filtrar registros contendo sua conta de destino e sua solicitação de personalização. IDs Consulte mais informações em [Troubleshooting with AFT account customization request tracing](https://docs.aws.amazon.com/controltower/latest/userguide/aft-account-customization-options.html).