本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

 **Description** 

 `AWS-DeregisterAMIs` Runbook 透過指定您已套用至 的標籤，協助您取消註冊 Amazon Machine Images(AMIs)AMIs。

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

**文件類型**

 自動化

**擁有者**

Amazon

**平台**

Linux、macOS、 Windows

**參數**
+ AutomationAssumeRole

  類型：字串

  描述：（選用） 允許 Systems Manager Automation 代表您執行動作的 (IAM) 角色的 AWS Identity and Access Management Amazon Resource Name (ARN)。如果未指定角色，Systems Manager Automation 會使用啟動此 Runbook 的使用者許可。
+ DryRun

  類型：字串

  有效值：是 \$1 否

  描述：（必要） 檢查您是否具有動作所需的許可，而無需實際提出請求，並提供錯誤回應。
+ RetainNumber

  類型：字串

  描述：（選用） 您要保留AMIs的 數量。如果您指定 的值，請勿指定此參數的值`Age`。
+ 年齡

  類型：字串

  描述：（選用） 您要保留AMIs的前幾天數量。如果您為 指定值，請勿為此參數指定值`RetainNumber`。
+ TagKey

  類型：字串

  描述：（必要） 指派給您要取消註冊AMIs之 標籤的索引鍵。
+ TagValue

  類型：字串

  描述：（必要） 指派給AMIs您要取消註冊之 的標籤值。

**必要的 IAM 許可**

`AutomationAssumeRole` 參數需要下列動作才能成功使用 Runbook。
+  `ec2:DeregisterImage` 
+  `ec2:DescribeImages` 

 **文件步驟** 
+  `aws:executeAwsApi` - 驗證您為 Runbook 輸入參數指定的值。
+  `aws:executeAwsApi` - AMIs 使用您使用 `TagKey`和 `TagValue` 參數指定的標籤取消註冊。