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

# `AWS-DeregisterAMIs`
<a name="aws-deregisteramis"></a>

 **Descrição** 

 O runbook `AWS-DeregisterAMIs` ajuda a cancelar o registro de Amazon Machine Images (AMIs) especificando a tag que foi aplicada ao AMIs.

 [Executar esta automação (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-DeregisterAMIs) 

**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.
+ DryRun

  Tipo: string

  Valores válidos: sim \$1 não

  Descrição: (obrigatório) verifica se você tem as permissões necessárias para a ação, sem realmente fazer a solicitação, e fornece uma resposta de erro.
+ RetainNumber

  Tipo: string

  Descrição: (opcional) o número de AMIs que você deseja reter. Não especifique um valor para esse parâmetro se foi especificado um valor para `Age`.
+ Idade

  Tipo: string

  Descrição: (opcional) o número de dias anteriores de AMIs que você deseja reter. Não especifique um valor para esse parâmetro se foi especificado um valor para `RetainNumber`.
+ TagKey

  Tipo: string

  Descrição: (obrigatório) a chave da tag atribuída às AMIs cujo registro você deseja cancelar.
+ TagValue

  Tipo: string

  Descrição: (obrigatório) o valor da tag atribuída às AMIs cujo registro você deseja cancelar.

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

O parâmetro `AutomationAssumeRole` requer as seguintes ações para usar o runbook com êxito.
+  `ec2:DeregisterImage` 
+  `ec2:DescribeImages` 

 **Etapas do documento** 
+  `aws:executeAwsApi`: valida os valores especificados para os parâmetros de entrada do runbook. 
+  `aws:executeAwsApi` :cancela o log de AMIs usando a tag que foi especificada usando os parâmetros `TagKey` e `TagValue`.