AWS-DeregisterAMIs - AWS Systems Manager 自動化 Runbook 參考

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

AWS-DeregisterAMIs

Description

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

執行此自動化 (主控台)

文件類型

 自動化

擁有者

Amazon

平台

Linux、macOS、 Windows

參數

  • AutomationAssumeRole

    類型:字串

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

  • DryRun

    類型:字串

    有效值:是 | 否

    描述:(必要) 檢查您是否擁有動作所需的許可,而無需實際提出請求,並提供錯誤回應。

  • RetainNumber

    類型:字串

    描述:(選用) 您要保留AMIs的 數量。如果您指定 的值,請勿為此參數指定值Age

  • 年齡

    類型:字串

    描述:(選用) 您要保留AMIs的過去天數。如果您指定 的值,請勿為此參數指定值RetainNumber

  • TagKey

    類型:字串

    描述:(必要) 指派給您要取消註冊AMIs之 標籤的索引鍵。

  • TagValue

    類型:字串

    描述:(必要) 指派給AMIs您要取消註冊之 的標籤值。

必要的 IAM 許可

AutomationAssumeRole 參數需要下列動作才能成功使用 Runbook。

  • ec2:DeregisterImage

  • ec2:DescribeImages

文件步驟

  • aws:executeAwsApi - 驗證您為 Runbook 輸入參數指定的值。

  • aws:executeAwsApi - AMIs 使用您使用 TagKeyTagValue 參數指定的標籤取消註冊。