翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# `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

**[Platforms]** (プラットフォーム)

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 の登録を解除します。