AWS-DeregisterAMIs

説明

AWS-DeregisterAMIs ランブックは、AMIs に適用したタグを指定することで Amazon Machine Images (AMIs) の登録を解除するのに役立ちます。

このオートメーションを実行する (コンソール)

ドキュメントタイプ

Automation

[所有者]

Amazon

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

Linux、macOS、Windows

パラメータ

• AutomationAssumeRole

  型: 文字列

  説明: (オプション) Systems Manager Automation がユーザーに代わってアクションを実行できるようにする AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN)。ロールを指定しない場合、Systems Manager Automation はこのランブックを開始するユーザーのアクセス許可を使用します。

• DryRun

  型: 文字列

  有効な値: はい | いいえ

  説明: (必須) 実際にリクエストを実行することなく、アクションに必要なアクセス許可があるかどうかを確認し、エラーレスポンスを提供します。

• RetainNumber

  型: 文字列

  説明: (オプション) 保持する AMIs の番号。Age の値を指定していない場合、このパラメータの値を指定しないでください。

• 年齢

  型: 文字列

  説明: (オプション) 保持する AMIs のそれ以前の日数。RetainNumber の値を指定していない場合、このパラメータの値を指定しないでください。

• TagKey

  型: 文字列

  説明: (必須) 登録を解除する AMIs に割り当てられたタグのキー。

• TagValue

  型: 文字列

  説明: (必須) 登録を解除する AMIs に割り当てられたタグの値。

必要な IAM アクセス許可

AutomationAssumeRole パラメータでは、ランブックを正常に使用するために、次のアクションが必要です。

• ec2:DeregisterImage

• ec2:DescribeImages

ドキュメントステップ

• aws:executeAwsApi - ランブックの入力パラメータに指定した値を検証します。

• aws:executeAwsApi - TagKey および TagValue パラメータを使用して指定したタグを使用して AMIs の登録を解除します。