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

# `AWS-ArchiveEBSSnapshots`
<a name="aws-archiveebssnapshots"></a>

 **Description** 

 `AWS-ArchiveEBSSnapshots` Runbook 透過指定已套用至快照的標籤，協助您封存 Amazon Elastic Block Store (Amazon EBS) 磁碟區的快照。或者，如果您的快照未加上標籤，您可以提供磁碟區的 ID。

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

**文件類型**

 自動化

**擁有者**

Amazon

**平台**

Linux、macOS、 Windows

**參數**
+ AutomationAssumeRole

  類型：字串

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

  類型：字串

  描述：（選用） Amazon EBS 快照的描述。
+ DryRun

  類型：字串

  有效值：是 \$1 否

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

  類型：字串

  描述：（選用） 您要封存的快照數量。如果您指定 的值，請勿指定此參數的值`RetentionDays`。
+ RetentionDays

  類型：字串

  描述：（選用） 您要封存的快照過去天數。如果您指定 的值，請勿指定此參數的值`RetentionCount`。
+ SnapshotWithTag

  類型：字串

  有效值：是 \$1 否

  描述：（必要） 指定是否標記您要封存的快照。
+ TagKey

  類型：字串

  描述：（選用） 指派給您要封存之快照的標籤索引鍵。
+ TagValue

  類型：字串

  描述：（選用） 指派給您要封存之快照的標籤值。
+ VolumeId

  類型：字串

  描述：（選用） 您要封存其快照的磁碟區 ID。如果您的快照未加上標籤，請使用此參數。

**必要的 IAM 許可**

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

 **文件步驟** 

`aws:executeScript` - 使用您使用 `TagKey`和 `TagValue` 參數或 `VolumeId` 參數指定的標籤封存快照。