本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
AWS-UpdateLinuxAmi
描述
使用 Linux 分发软件包和 Amazon 软件更新 Amazon Machine Image (AMI) 。
文档类型
自动化
所有者
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
默认：{” HttpEndpoint “: “已启用”，“HttpTokens“：“可选”}
说明：（可选）实例的元数据选项。有关更多信息，请参阅 InstanceMetadataOptionsRequest。
允许的模式：
^\{[^<>\$;|&\\]*\}$-
必须用大括号 {} 括起来，并且不能包含以下字符：
< > $ ; | & \
-
-
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_from_ {{SourceAmiId}} _on_ {global: date_Time}}
说明：（可选）将创建的新 AMI 的名称。默认为系统生成的字符串，其中包括源 AMI ID 以及创建时间和日期。
允许的模式：
^[a-zA-Z0-9()\[\]\{\} ./'@_:-]{3,128}$-
必须介于 3 到 128 个字符之间，并且仅包含字母、数字、空格和以下字符：
( ) [ ] { } . / ' @ _ : -
-
