本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

 **描述** 

 `AWS-ArchiveEBSSnapshots` 运行手册通过指定您应用于快照的标签，帮助您归档 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 代表您执行操作 AWS Identity and Access Management (IAM) 角色的 Amazon 资源名称（ARN）。如果未指定角色，Systems Manager Automation 将使用启动此运行手册的用户的权限。
+ 说明

  类型：字符串

  描述：（可选）对 Amazon EBS 快照的说明。
+ DryRun

  类型：字符串

  有效值：是 \$1 否

  描述：（必需）在未实际发出请求的情况下检查您是否拥有该操作所需的权限，并提供错误响应。
+ RetentionCount

  类型：字符串

  描述：（可选）要归档的快照数量。如果您为 `RetentionDays` 参数指定了一个值，则不要为此参数指定值。
+ RetentionDays

  类型：字符串

  描述：（可选）要归档的前几天快照的数量。如果您为 `RetentionCount` 参数指定了一个值，则不要为此参数指定值。
+ SnapshotWithTag

  类型：字符串

  有效值：是 \$1 否

  描述：（必需）指定要归档的快照是否已添加标签。
+ TagKey

  类型：字符串

  描述：（可选）分配给要归档快照的标签的键。
+ TagValue

  类型：字符串

  描述：（可选）分配给要归档快照的标签的值。
+ VolumeId

  类型：字符串

  描述：（可选）要归档快照的卷 ID。如果快照未添加标签，请使用此参数。

**所需的 IAM 权限**

`AutomationAssumeRole` 参数需要执行以下操作才能成功使用运行手册。
+  `ec2:ArchiveSnapshots` 
+  `ec2:DescribeSnapshots` 

 **文档步骤** 

`aws:executeScript` - 使用您用 `TagKey` 和 `TagValue` 参数指定的标签或参数 `VolumeId` 对快照进行归档。