本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

 **描述** 

 `AWS-DeregisterAMIs`运行手册使用指定已应用于 AMIs 的标签来帮助您取消注册 Amazon Machine Images (AMIs)。

 [运行此自动化（控制台）](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-DeregisterAMIs) 

**文档类型**

自动化

**所有者**

Amazon

**平台**

Linux、macOS、Windows

**参数**
+ AutomationAssumeRole

  类型：字符串

  描述：（可选）允许 Systems Manager Automation 代表您执行操作 AWS Identity and Access Management (IAM) 角色的 Amazon 资源名称（ARN）。如果未指定角色，Systems Manager Automation 将使用启动此运行手册的用户的权限。
+ DryRun

  类型：字符串

  有效值：是 \$1 否

  描述：（必需）在未实际发出请求的情况下检查您是否拥有该操作所需的权限，并提供错误响应。
+ RetainNumber

  类型：字符串

  描述：（可选）要保留的 AMIs 的数量。如果您为 `Age` 参数指定了一个值，则不要为此参数指定值。
+ 天数

  类型：字符串

  描述：（可选）要保留的前几天的 AMIs 数量。如果您为 `RetainNumber` 参数指定了一个值，则不要为此参数指定值。
+ TagKey

  类型：字符串

  描述：（必需）分配给要取消注册 AMIs 的标签的键。
+ TagValue

  类型：字符串

  描述：（必需）分配给要取消注册 AMIs 的标签的值。

**所需的 IAM 权限**

`AutomationAssumeRole` 参数需要执行以下操作才能成功使用运行手册。
+  `ec2:DeregisterImage` 
+  `ec2:DescribeImages` 

 **文档步骤** 
+  `aws:executeAwsApi` - 验证您为运行手册输入参数指定的值。
+  `aws:executeAwsApi` - 使用您用 `TagKey` 和 `TagValue` 参数指定的标签来取消 AMIs 的注册。