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

# `AWSSupport-TroubleshootCFNCustomResource`
<a name="automation-awssupport-TroubleshootCFNCustomResource"></a>

 **Descrição** 

 O runbook `AWSSupport-TroubleshootCFNCustomResource` ajuda a diagnosticar por que uma pilha do AWS CloudFormation falhou ao criar, atualizar ou excluir um recurso personalizado. O runbook verifica o token de serviço usado para o recurso personalizado e a mensagem de erro que foi retornada. Depois de analisar os detalhes do recurso personalizado, a saída do runbook fornece uma explicação sobre o comportamento da pilha e as etapas de solução de problemas do recurso personalizado. 

 [Execute esta automação (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-TroubleshootCFNCustomResource) 

**Tipo de documento**

Automação

**Proprietário**

Amazon

**Plataformas**

Linux, macOS, Windows

**Parâmetros**
+ AutomationAssumeRole

  Tipo: String

  Descrição: (opcional) o nome do recurso da Amazon (ARN) do perfil do AWS Identity and Access Management (IAM) que permite que o Systems Manager Automation realize ações em seu nome. Se nenhum perfil for especificado, o Systems Manager Automation usa as permissões do usuário que inicia este runbook.
+ StackName

  Tipo: string

  Descrição: (Obrigatório) O nome da CloudFormation pilha em que o recurso personalizado falhou.

**Permissões obrigatórias do IAM**

O parâmetro `AutomationAssumeRole` requer as seguintes ações para usar o runbook com êxito.
+  `cloudformation:DescribeStacks` 
+  `cloudformation:DescribeStackEvents` 
+  `cloudformation:ListStackResources` 
+  `ec2:DescribeRouteTables` 
+  `ec2:DescribeNatGateways` 
+  `ec2:DescribeSecurityGroups` 
+  `ec2:DescribeVpcs` 
+  `ec2:DescribeVpcEndpoints` 
+  `ec2:DescribeSubnets` 
+  `logs:FilterLogEvents` 

 **Etapas do documento** 
+  `validateCloudFormationStack`- Verifica se a CloudFormation pilha existe na mesma e. Conta da AWS Região da AWS
+  `checkCustomResource`- Analisa a CloudFormation pilha, verifica o recurso personalizado com falha e gera informações sobre como solucionar o problema do recurso personalizado com falha.