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á.
Ações, recursos e chaves de condição para AWS CloudFormation
AWS CloudFormation (prefixo do serviço:cloudformation) fornece os seguintes recursos, ações e chaves de contexto de condição específicos do serviço para uso nas políticas de permissão do IAM.
Referências:
-
Saiba como configurar este serviço.
-
Visualize uma lista das operações de API disponíveis para este serviço.
-
Saiba como proteger este serviço e seus recursos usando políticas de permissão do IAM.
Tópicos
Ações definidas pelo AWS CloudFormation
Você pode especificar as seguintes ações no elemento Action de uma declaração de política do IAM. Use políticas para conceder permissões para executar uma operação na AWS. Quando usa uma ação em uma política, você geralmente permite ou nega acesso à operação da API ou ao comando da CLI com o mesmo nome. No entanto, em alguns casos, uma única ação controla o acesso a mais de uma operação. Como alternativa, algumas operações exigem várias ações diferentes.
A coluna Tipos de recursos na tabela Ações indica se cada ação é compatível com permissões no nível do recurso. Se não houver valor para essa coluna, você deverá especificar todos os recursos ("*") aos quais a política se aplica no elemento Resource de sua declaração de política. Se a coluna incluir um tipo de recurso, você poderá especificar um ARN desse tipo em uma instrução com essa ação. Se a ação tiver um ou mais recursos necessários, o chamador deverá ter permissão para usar a ação com esses recursos. Os recursos obrigatórios são indicados na tabela com um asterisco (*). Se você limitar o acesso aos recursos com o elemento Resource em uma política do IAM, deverá incluir um ARN ou padrão para cada tipo de recurso necessário. Algumas ações oferecem suporte a vários tipos de recursos. Se o tipo de recurso for opcional (não indicado como obrigatório), você poderá optar por usar um dos tipos de recurso opcionais.
A coluna Chaves de condição na tabela Ações inclui chaves que você pode especificar em um elemento Condition da declaração de política. Para obter mais informações sobre as chaves de condição associadas aos recursos do serviço, consulte a coluna Chaves de condição da tabela Tipos de recursos.
nota
As chaves de condição do recurso estão listadas na tabela Tipos de recursos. Você pode encontrar um link para o tipo de recurso que se aplica a uma ação na coluna Tipos de recursos (*obrigatório) da tabela Ações. O tipo de recurso na tabela Tipos de recursos inclui a coluna Chaves de condição, que são as chaves de condição do recurso que se aplicam a uma ação na tabela Ações.
Para obter detalhes sobre as colunas na tabela a seguir, consulte Tabela de ações.
| Ações | Descrição | Nível de acesso | Tipos de recursos (*necessários) | Chaves de condição | Ações dependentes |
|---|---|---|---|---|---|
| ActivateOrganizationsAccess | Concede permissão para ativar o acesso confiável entre StackSets e Organizations. Com o acesso confiável entre StackSets e Organizations ativado, a conta de gerenciamento tem permissões StackSets para criar e gerenciar sua organização | Escrever | |||
| ActivateType | Concede permissão para ativar uma extensão pública de terceiros, tornando-a disponível para uso em modelos de pilha | Escrever | |||
| BatchDescribeTypeConfigurations | Concede permissão para retornar dados de configuração para as CloudFormation extensões especificadas | Leitura | |||
| CancelUpdateStack | Concede permissão para cancelar uma atualização na pilha especificada | Write | |||
| ContinueUpdateRollback | Concede permissão para continuar revertendo uma pilha que está no estado UPDATE_ROLLBACK_FAILED para o estado UPDATE_ROLLBACK_COMPLETE | Write | |||
| CreateChangeSet | Concede permissão para criar uma lista de alterações para uma pilha | Escrever | |||
| CreateGeneratedTemplate | Concede permissão para criar um modelo a partir de recursos existentes que ainda não foram gerenciados com CloudFormation | Escrever | |||
| CreateStack | Concede permissão para criar uma pilha conforme especificado no modelo | Write | |||
| CreateStackInstances | Concede permissão para criar instâncias de pilha para as contas especificadas, dentro das regiões especificadas | Write | |||
| CreateStackSet | Concede permissão para criar um conjunto de pilha conforme especificado no modelo | Write | |||
| CreateUploadBucket [somente permissão] | Concede permissão para enviar modelos para buckets do Amazon S3. Usado somente pelo AWS CloudFormation console e não está documentado na referência da API | Escrever | |||
| DeactivateOrganizationsAccess | Concede permissão para desativar o acesso confiável entre StackSets e Organizations. Se o acesso confiável for desativado, a conta de gerenciamento não terá permissões para criar e gerenciar serviços gerenciados StackSets para sua organização | Escrever | |||
| DeactivateType | Concede permissão para desativar uma extensão pública que foi ativada anteriormente nesta conta e região | Escrever | |||
| DeleteChangeSet | Concede permissão para excluir o conjunto de alterações especificado. A exclusão de conjuntos de alterações garante que ninguém execute o conjunto de alterações errado | Escrever | |||
| DeleteGeneratedTemplate | Concede permissão para excluir um modelo gerado | Escrever | |||
| DeleteStack | Concede permissão para excluir uma pilha especificada | Write | |||
| DeleteStackInstances | Concede permissão para excluir instâncias de pilha para as contas especificadas, nas regiões especificadas | Write | |||
| DeleteStackSet | Concede permissão para excluir um conjunto de pilha especificado | Escrever | |||
| DeregisterType | Concede permissão para cancelar o registro de um CloudFormation tipo ou versão de tipo existente | Escrever | |||
| DescribeAccountLimits | Concede permissão para recuperar os limites da AWS CloudFormation sua conta | Leitura | |||
| DescribeChangeSet | Concede permissão para devolver a descrição do conjunto de alterações especificado | Leitura | |||
| DescribeChangeSetHooks | Concede permissão para devolver as informações da chamada do Hook para o conjunto de alterações especificado | Leitura | |||
| DescribeGeneratedTemplate | Concede permissão para descrever um modelo gerado. A saída inclui detalhes sobre o progresso da criação de um modelo gerado | Leitura | |||
| DescribeOrganizationsAccess | Concede permissão para retornar informações sobre o OrganizationAccess status da conta | Leitura | |||
| DescribePublisher | Concede permissão para devolver informações sobre um editor CloudFormation de extensões | Leitura | |||
| DescribeResourceScan | Concede permissão para descrever detalhes de uma análise de recursos | Leitura | |||
| DescribeStackDriftDetectionStatus | Concede permissão para devolver informações sobre uma operação de detecção de desvio de pilha | Read | |||
| DescribeStackEvents | Concede permissão para devolver todos os eventos relacionados à pilha para uma pilha especificada | Leitura | |||
| DescribeStackInstance | Concede permissão para retornar a instância da pilha associada ao conjunto de pilhas e à região especificados Conta da AWS | Leitura | |||
| DescribeStackResource | Concede permissão para devolver uma descrição do recurso especificado na pilha especificada | Read | |||
| DescribeStackResourceDrifts | Concede permissão para retornar informações de desvio para os recursos que foram verificados quanto ao desvio na pilha especificada | Leitura | |||
| DescribeStackResources | Concede permissão para retornar descrições AWS de recursos para pilhas em execução e excluídas | Leitura | |||
| DescribeStackSet | Concede permissão para devolver a descrição do conjunto de pilha especificado | Read | |||
| DescribeStackSetOperation | Concede permissão para devolver a descrição da operação de conjunto de pilha especificada | Leitura | |||
| DescribeStacks | Concede permissão para retornar a descrição da pilha especificada e de todas as pilhas quando usada em combinação com a ação ListStacks | Lista |
cloudformation:ListStacks |
||
| DescribeType | Concede permissão para retornar informações sobre o CloudFormation tipo solicitado | Leitura | |||
| DescribeTypeRegistration | Concede permissão para retornar informações sobre o processo de registro de um CloudFormation tipo | Leitura | |||
| DetectStackDrift | Concede permissão para detectar se a configuração real de uma pilha difere, ou foi derivada, da configuração esperada, conforme definido no modelo de pilha e quaisquer valores especificados como parâmetros de modelo | Read | |||
| DetectStackResourceDrift | Concede permissão para retornar informações sobre se a configuração real de um recurso difere ou se foi derivada da configuração esperada, conforme definido no modelo de pilha e quaisquer valores especificados como parâmetros de modelo | Read | |||
| DetectStackSetDrift | Concede permissão para permitir que os usuários detectem desvio em um conjunto de pilha e as instâncias de pilha que pertencem a esse conjunto de pilhas | Read | |||
| EstimateTemplateCost | Concede permissão para devolver o custo mensal estimado de um modelo | Read | |||
| ExecuteChangeSet | Concede permissão para atualizar uma pilha usando as informações de entrada fornecidas quando o conjunto de alterações especificado foi criado | Escrever | |||
| GetGeneratedTemplate | Concede permissão para recuperar um modelo gerado | Leitura | |||
| GetStackPolicy | Concede permissão para devolver a política de pilha para uma pilha especificada | Read | |||
| GetTemplate | Concede permissão para devolver o corpo do modelo para uma pilha especificada | Read | |||
| GetTemplateSummary | Concede permissão para devolver informações sobre um modelo novo ou existente | Leitura | |||
| ImportStacksToStackSet | Concede permissão para permitir que os usuários importem pilhas existentes para um conjunto de pilhas novo ou existente | Escrever | |||
| ListChangeSets | Concede permissão para devolver a ID e o status de cada conjunto de alterações ativas para uma pilha. Por exemplo, AWS CloudFormation lista os conjuntos de alterações que estão no estado CREATE_IN_PROGRESS ou CREATE_PENDING | Lista | |||
| ListExports | Concede permissão para listar todos os valores de saída exportados na conta e região em que você chama essa ação | Lista | |||
| ListGeneratedTemplates | Concede permissão para listar seus modelos gerados nesta região | Lista | |||
| ListImports | Concede permissão para listar todas as pilhas que estão importando um valor de saída exportado | Lista | |||
| ListResourceScanRelatedResources | Concede permissão para listar os recursos relacionados para obter uma lista de recursos de uma análise de recursos. A resposta indica se cada recurso retornado já é gerenciado pelo CloudFormation | Lista | |||
| ListResourceScanResources | Concede permissão para listar os recursos de uma análise de recursos. Os resultados podem ser filtrados por identificador de recurso, prefixo do tipo de recurso, chave da tag e valor da tag | Lista | |||
| ListResourceScans | Concede permissão para listar os escaneamentos de recursos da mais recente para a mais antiga. Por padrão, ele retornará até 10 escaneamentos de recursos. | Lista | |||
| ListStackInstanceResourceDrifts | Concede permissão para retornar informações de desvio para os recursos que foram verificados quanto ao desvio na instância da pilha especificada | Lista | |||
| ListStackInstances | Concede permissão para devolver informações de resumo sobre instâncias de pilha associadas ao conjunto de pilha especificado | List | |||
| ListStackResources | Concede permissão para devolver descrições de todos os recursos da pilha especificada | Lista | |||
| ListStackSetAutoDeploymentTargets | Concede permissão para retornar informações resumidas sobre metas de implantação StackSet automática | Lista | |||
| ListStackSetOperationResults | Concede permissão para devolver informações resumidas sobre os resultados de uma operação de conjunto de pilha | List | |||
| ListStackSetOperations | Concede permissão para devolver informações resumidas sobre operações executadas em um conjunto de pilhas | List | |||
| ListStackSets | Concede permissão para devolver informações de resumo sobre conjuntos de pilha associados ao usuário | Lista | |||
| ListStacks | Concede permissão para retornar as informações resumidas das pilhas cujo status corresponda ao especificado StackStatusFilter. Em combinação com a DescribeStacks ação, concede permissão para listar as descrições das pilhas | Lista | |||
| ListTypeRegistrations | Concede permissão para listar tentativas CloudFormation de registro do tipo | Lista | |||
| ListTypeVersions | Concede permissão para listar versões de um CloudFormation tipo específico | Lista | |||
| ListTypes | Concede permissão para listar CloudFormation os tipos disponíveis | Lista | |||
| PublishType | Concede permissão para publicar a extensão especificada no CloudFormation registro como uma extensão pública nesta região | Escrever | |||
| RecordHandlerProgress | Concede permissão para registrar o progresso do manipulador | Escrever | |||
| RegisterPublisher | Concede permissão para registrar uma conta como editora de extensões públicas no CloudFormation registro | Escrever | |||
| RegisterType | Concede permissão para registrar um novo CloudFormation tipo | Escrever | |||
| RollbackStack | Concede permissão para reverter a pilha ao último estado estável | Escrever | |||
| SetStackPolicy | Concede permissão para definir uma política de pilha para uma pilha especificada | Gerenciamento de permissões | |||
| SetTypeConfiguration | Concede permissão para definir os dados de configuração de uma CloudFormation extensão registrada, na conta e região em questão | Escrever | |||
| SetTypeDefaultVersion | Concede permissão para definir qual versão de um CloudFormation tipo se aplica às CloudFormation operações | Escrever | |||
| SignalResource | Concede permissão para enviar um sinal para o recurso especificado com um status de sucesso ou falha | Escrever | |||
| StartResourceScan | Concede permissão para iniciar uma análise dos recursos desta conta nesta região | Escrever | |||
| StopStackSetOperation | Concede permissão para interromper uma operação em andamento em um conjunto de pilha e suas instâncias de pilha associadas | Write | |||
| TagResource | Concede permissão para marcar recursos do cloudformation | Tags | |||
| TestType | Concede permissão para testar uma extensão registrada para garantir que ela atenda a todos os requisitos necessários para ser publicada no CloudFormation registro | Escrever | |||
| UntagResource | Concede permissão para desmarcar recursos do cloudformation | Tags | |||
| UpdateGeneratedTemplate | Concede permissão para atualizar um modelo gerado. Isso pode ser usado para alterar o nome, adicionar e remover recursos, atualizar recursos e alterar as configurações DeletionPolicy e. UpdateReplacePolicy | Escrever | |||
| UpdateStack | Concede permissão para atualizar uma pilha conforme especificado no modelo | Write | |||
| UpdateStackInstances | Concede permissão para atualizar os valores de parâmetro para instâncias de pilha para as contas especificadas, dentro das regiões especificadas | Write | |||
| UpdateStackSet | Concede permissão para atualizar um conjunto de pilha conforme especificado no modelo | Write | |||
| UpdateTerminationProtection | Concede permissão para atualizar a proteção de encerramento para a pilha especificada | Write | |||
| ValidateTemplate | Concede permissão para validar um modelo especificado | Leitura |
Tipos de recursos definidos pelo AWS CloudFormation
Os seguintes tipos de recursos são definidos por este serviço e podem ser usados no elemento Resource de declarações de políticas de permissão do IAM. Cada ação na Tabela de ações identifica os tipos de recursos que podem ser especificados com essa ação. Um tipo de recurso também pode definir quais chaves de condição você pode incluir em uma política. Essas chaves são exibidas na última coluna da tabela Tipos de recursos. Para obter detalhes sobre as colunas na tabela a seguir, consulte Tabela de tipos de recursos.
| Tipos de recursos | ARN | Chaves de condição |
|---|---|---|
| changeset |
arn:${Partition}:cloudformation:${Region}:${Account}:changeSet/${ChangeSetName}/${Id}
|
|
| stack |
arn:${Partition}:cloudformation:${Region}:${Account}:stack/${StackName}/${Id}
|
|
| stackset |
arn:${Partition}:cloudformation:${Region}:${Account}:stackset/${StackSetName}:${Id}
|
|
| stackset-target |
arn:${Partition}:cloudformation:${Region}:${Account}:stackset-target/${StackSetTarget}
|
|
| type |
arn:${Partition}:cloudformation:${Region}:${Account}:type/resource/${Type}
|
|
| generatedtemplate |
arn:${Partition}:cloudformation:${Region}:${Account}:generatedTemplate/${Id}
|
|
| resourcescan |
arn:${Partition}:cloudformation:${Region}:${Account}:resourceScan/${Id}
|
Chaves de condição do AWS CloudFormation
AWS CloudFormation define as seguintes chaves de condição que podem ser usadas no Condition elemento de uma política do IAM. É possível usar essas chaves para refinar ainda mais as condições sob as quais a declaração de política se aplica. Para obter detalhes sobre as colunas na tabela a seguir, consulte Tabela de chaves de condição.
Para visualizar as chaves de condição globais disponíveis para todos os serviços, consulte Chaves de condição globais disponíveis.
| Chaves de condição | Descrição | Tipo |
|---|---|---|
| aws:RequestTag/${TagKey} | Filtra o acesso pelas etiquetas que são transmitidas na solicitação | Segmento |
| aws:ResourceTag/${TagKey} | Filtra o acesso pelas etiquetas associadas ao recurso | Segmento |
| aws:TagKeys | Filtra o acesso pelas chaves da etiqueta que são transmitidas na solicitação | ArrayOfString |
| cloudformation:ChangeSetName | Filtra o acesso pelo nome do conjunto de AWS CloudFormation alterações. Use para controlar quais conjuntos de alterações os usuários do IAM podem executar ou excluir | String |
| cloudformation:ImportResourceTypes | Filtra o acesso pelos tipos de recursos do modelo, como AWS: :EC2: :Instance. Use para controlar com quais tipos de recursos os usuários do IAM podem trabalhar quando quiserem importar um recurso para uma pilha | String |
| cloudformation:ResourceTypes | Filtra o acesso pelos tipos de recursos do modelo, como AWS: :EC2: :Instance. Use para controlar com quais tipos de recursos os usuários do IAM podem trabalhar ao criar ou atualizar uma pilha | ArrayOfString |
| cloudformation:RoleArn | Filtra o acesso por ARN de uma função de serviço do IAM. Use para controlar qual função de serviço os usuários do IAM podem usar para trabalhar com pilhas ou conjuntos de alterações | ARN |
| cloudformation:StackPolicyUrl | Filtra o acesso por um URL de política de pilha do Amazon S3. Use para controlar quais políticas de pilha os usuários do IAM podem associar a uma pilha durante uma ação de criação ou atualização | String |
| cloudformation:TargetRegion | Filtra o acesso por região de destino do conjunto de pilhas. Use para controlar quais regiões os usuários do IAM podem usar quando criam ou atualizam conjuntos de pilhas | ArrayOfString |
| cloudformation:TemplateUrl | Filtra o acesso por um URL de modelo do Amazon S3. Use para controlar quais modelos os usuários do IAM podem usar quando criam ou atualizam pilhas | String |
