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

# `AWS-UpdateLinuxAmi`
<a name="automation-aws-updatelinuxami"></a>

**描述**

使用 Linux 分发软件包和 Amazon 软件更新 Amazon Machine Image (AMI) 。

[运行此自动化（控制台）](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-UpdateLinuxAmi)

**文档类型**

自动化

**所有者**

Amazon

**平台**

Linux

**参数**
+ AutomationAssumeRole

  类型：字符串

  描述：（可选）允许 Systems Manager Automation 代表您执行操作 AWS Identity and Access Management (IAM) 角色的 Amazon 资源名称（ARN）。如果未指定角色，Systems Manager Automation 将使用启动此运行手册的用户的权限。

  允许的模式：`^$|^arn:aws[a-z0-9-]*:iam::(\d{12}|\{\{global:ACCOUNT_ID\}\}):role/[\w/.@+=,-]{1,1017}$`
  + 必须是有效的 IAM 角色 ARN 或空字符串。系统变量`{{global:ACCOUNT_ID}}`可用来代替 arn 中的 AWS 账户 ID。
+ ExcludePackages

  类型：字符串

  默认：无

  说明：（可选）在所有情况下从更新中排除的软件包的名称。默认值 ("none") 不排除任何软件包。

  允许的模式：`^(none|[a-zA-Z0-9\s,._+:=<>()\[\]/*-]+)$`
  + 必须为 “none” 或由字母、数字、空格和以下字符组成的以逗号分隔的项目列表：`, . _ + : = < > ( ) [ ] / * -`
+ IamInstanceProfileName

  类型：字符串

  默认： ManagedInstanceProfile

  说明：（必需）启用 Systems Manager 以管理实例的实例配置文件。

  允许的模式：`^[\w+=,.@-]{1,128}$`
  + 必须介于 1 到 128 个字符之间，并且仅包含字母、数字和以下字符：`+ = , . @ - _`
+ IncludePackages

  类型：字符串

  默认：all

  说明：（可选）仅更新这些指定的软件包。默认值 ("all") 将应用所有可用的更新。

  允许的模式：`^(all|[a-zA-Z0-9\s,._+:=<>()\[\]/*-]+)$`
  + 必须为 “all” 或由字母、数字、空格和以下字符组成的以逗号分隔的项目列表：`, . _ + : = < > ( ) [ ] / * -`
+ InstanceType

  类型：字符串

  默认：t2.micro

  说明：（可选）启动作为工作区主机的实例的类型。实例类型因区域而异。

  允许的模式：`^[a-z0-9]+(-[a-z0-9]+)*\.[a-z0-9]+$`
  + 必须采用 prefix.suffix 格式，其中两个部分都包含小写字母和数字，前缀可以包含连字符
+ MetadataOptions

  类型： StringMap

  默认：\$1” HttpEndpoint “: “已启用”，“HttpTokens“：“可选”\$1

  说明：（可选）实例的元数据选项。有关更多信息，请参阅 [InstanceMetadataOptionsRequest](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_InstanceMetadataOptionsRequest.html)。

  允许的模式：`^\{[^<>\$;|&\\]*\}$`
  + 必须用大括号 \$1\$1 括起来，并且不能包含以下字符：`< > $ ; | & \`
+ PostUpdateScript

  类型：字符串

  默认：无

  说明：（可选）在应用软件包更新后要运行的脚本的 URL。默认值 ("none") 不运行脚本。

  允许的模式：`^(none|https?://[\w\-._~:/?#\[\]@!$&'()*+,;=%]+)$`
  + 必须为 “无” 或有效的 HTTP/HTTPS 网址
+ PreUpdateScript

  类型：字符串

  默认：无

  说明：（可选）在更新前应用要运行的脚本的 URL。默认值 ("none") 不运行脚本。

  允许的模式：`^(none|https?://[\w\-._~:/?#\[\]@!$&'()*+,;=%]+)$`
  + 必须为 “无” 或有效的 HTTP/HTTPS 网址
+ SecurityGroupIds

  类型：字符串

  描述：（必填）要应用于的安全组 IDs 的列表，以逗号分隔。AMI

  允许的模式：`^sg-[a-z0-9]{8,17}$`
  + 必须以 “sg-” 开头，后跟 8-17 个小写字母或数字
+ SourceAmiId

  类型：字符串

  说明：（必需）源 Amazon 系统映像 ID。

  允许的模式：`^ami-[a-z0-9]{8,17}$`
  + 必须以 “ami-” 开头，后跟 8-17 个小写字母或数字
+ SubnetId

  类型：字符串

  描述：（可选）您希望启动实例以便使用的子网 ID。如果您已删除默认 VPC，则此参数是必需的。

  允许的模式：`^$|^subnet-[a-z0-9]{8,17}$`
  + 必须为空或者以 “subnet-” 开头，后跟 8-17 个小写字母或数字
+ TargetAmiName

  类型：字符串

  默认：UpdateLinuxAmi\$1from\$1 \$1\$1SourceAmiId\$1\$1 \$1on\$1 \$1global: date\$1Time\$1\$1

  说明：（可选）将创建的新 AMI 的名称。默认为系统生成的字符串，其中包括源 AMI ID 以及创建时间和日期。

  允许的模式：`^[a-zA-Z0-9()\[\]\{\} ./'@_:-]{3,128}$`
  + 必须介于 3 到 128 个字符之间，并且仅包含字母、数字、空格和以下字符：`( ) [ ] { } . / ' @ _ : -`