Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

 **Descripción** 

 El manual de procedimientos `AWS-DeregisterAMIs` le ayuda a anular el registro Amazon Machine Images (AMIs) especificando la etiqueta que ha aplicado a su AMIs.

 [Ejecuta esta automatización (consola)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-DeregisterAMIs) 

**Tipo de documento**

Automatización

**Propietario**

Amazon

**Plataformas**

Linux, macOS, Windows

**Parámetros**
+ AutomationAssumeRole

  Tipo: cadena

  Descripción: (opcional) el Nombre de recurso de Amazon (ARN) del rol de AWS Identity and Access Management (IAM) que permite a Systems Manager Automation realizar las acciones en su nombre. Si no se especifica ningún rol, Systems Manager Automation utiliza los permisos del usuario que comienza este manual de procedimientos.
+ DryRun

  Tipo: cadena

  Valores válidos: Yes \| No

  Descripción: (obligatorio) comprueba si tiene los permisos necesarios para la acción, sin realizar realmente la solicitud, y proporciona una respuesta de error.
+ RetainNumber

  Tipo: cadena

  Descripción: (opcional) el número de AMIs que desea retener. No especifique un valor para este parámetro si especifica un valor para `Age`.
+ Antigüedad

  Tipo: cadena

  Descripción: (opcional) El número de días anteriores de AMIs que desea retener. No especifique un valor para este parámetro si especifica un valor para `RetainNumber`.
+ TagKey

  Tipo: cadena

  Descripción: (obligatorio) la clave de la etiqueta asignada a la AMIs cuyo registro desea anular.
+ TagValue

  Tipo: cadena

  Descripción: (obligatorio) el valor de la etiqueta asignada a la AMIs cuyo registro desea anular.

**Permisos de IAM necesarios**

El parámetro `AutomationAssumeRole` requiere las siguientes acciones para utilizar el manual de procedimientos correctamente.
+  `ec2:DeregisterImage` 
+  `ec2:DescribeImages` 

 **Pasos de documentos** 
+  `aws:executeAwsApi`: valida los valores que especifique para los parámetros de entrada del manual de procedimientos. 
+  `aws:executeAwsApi`: anula el registro AMIs con la etiqueta que especifique con los parámetros `TagKey` y `TagValue`.