Quero resolver o erro de permissão de marcação que recebo quando minha pilha do AWS CloudFormation falha.
Solução
Observação: Se você receber mensagens de erro ao executar comandos da AWS Command Line Interface (AWS CLI), consulte Solução de problemas da AWS CLI. Além disso, verifique se você está usando a versão mais recente da AWS CLI.
Se você tentar criar, atualizar ou excluir um recurso nas pilhas do CloudFormation sem as permissões de marcação corretas, suas operações de pilha falharão. Para resolver esse problema, você deve conceder as permissões de marcação necessárias à sua entidade principal do AWS Identity and Access Management (AWS IAM).
Identificar o perfil e a operação da API que falharam
Em recursos do Amazon Elastic Compute Cloud (Amazon EC2), decodifique a mensagem de falha de autorização codificada. Para identificar o perfil e a operação da API que falharam, execute o seguinte comando decode-authorization-message da AWS CLI.
aws sts decode-authorization-message --encoded-message example-encoded-message --example-region
Observação: Substitua example-encoded-message pela sua mensagem codificada e example-region pela sua região da AWS.
Em outros recursos que não estão relacionados ao Amazon EC2, consulte a página de eventos de pilha para saber o perfil e a API que falharam.
Adicione as permissões ausentes à entidade principal do IAM
Para encontrar a entidade principal do IAM que você usa para operações de marcação, conclua as seguintes etapas:
- Abra o console do CloudFormation.
- No painel de navegação, clique em Pilhas.
- Selecione o nome da pilha e, na seção Visão geral, anote o ID da pilha.
Se você tiver um nome do recurso da Amazon (ARN) em um perfil do IAM listado, o CloudFormation usará o perfil para gerenciar e marcar os recursos.
Se você não tiver um ARN em um perfil do IAM listado, verifique o histórico de eventos da sua pilha do CloudFormation. Conclua as seguintes etapas:
- Abra o console do AWS CloudTrail.
- No painel de navegação, clique em Histórico de eventos.
- Em Atributos de pesquisa, selecione Nome do recurso e insira seu ID de pilha na caixa de pesquisa.
Observação: O histórico de eventos inclui eventos dos últimos 90 dias. Se sua pesquisa de ID de pilha não exibir eventos, atualize a pilha.
- Na lista Histórico de eventos, selecione o primeiro nome de evento.
Se o campo do tipo userIdentity for IAMUser, a entidade principal no campo arn gerenciará o recurso. Se o tipo userIdentity for Role, o CloudFormation usará a entidade principal no campo arn abaixo do sessionIssuer.
Conceda permissões de marcação em sua política do IAM
Quando um serviço de infraestrutura como código (IaC) gerencia uma entidade principal do IAM, você deve atualizar a política do IAM relacionada com o mesmo serviço de IaC.
Para usar o console do IAM para conceder permissões de marcação, crie uma nova política em linha ou atualize uma política existente.
Para configurar as permissões de marcação da entidade principal do IAM, também é possível executar o seguinte comando put-role-policy da AWS CLI:
aws iam put-role-policy --role-name example-role-name --policy-name example-policy --policy-document file://AdminPolicy.json
Observação: Substitua example-role-name pelo nome do seu perfil, example-policy pelo nome da sua política e AdminPolicy.json pelo documento JSON da sua política. O nome e a extensão do arquivo não são importantes.
Além disso, é possível combinar suas tags de modelo do CloudFormation com suas tags de recursos para manter uma infraestrutura consistente.