Amazon 系统映像 ID 的本机参数支持 - AWS Systems Manager
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

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

Amazon 系统映像 ID 的本机参数支持

当您创建 String 参数时,您可以在 Ctring 参数中指定数据类型作为aws:ec2:image以确保您输入的参数值是有效的 Amazon Machine Image (AMI) ID 格式。

对该项的支持 AMI ID 格式允许您避免每次使用新 ID 更新所有脚本和模板 AMI 你想要在你的进程中使用的变化。您可以使用数据类型创建参数aws:ec2:image,并输入 AMI。 这是 AMI 当前要从中创建新实例。然后在模板、命令和脚本中引用此参数。

例如,您可以指定包含首选项的参数 AMI 运行 Amazon Elastic Compute Cloud (Amazon EC2) 时的 IDrun-instances命令。

注意

运行此命令的用户必须拥有 AWS Identity and Access Management (IAM) 权限,其中包含ssm:GetParametersAPI 操作,以便验证参数值。否则,参数创建过程将失败。

aws ec2 run-instances \ --image-id resolve:ssm:/golden-ami \ --count 1 \ --instance-type t2.micro \ --key-name my-key-pair \ --security-groups my-security-group

还可以选择您喜欢的 AMI 当您使用 Amazon EC2 控制台创建实例时。有关更多信息,请参阅 。使用 Systems Manager 参数查找 AMI中的适用于 Windows 实例的 Amazon EC2 用户指南

当它的时间使用不同的 AMI 在实例创建工作流中,您只需使用新的 AMI 值,并且参数存储将再次验证您输入的 ID 格式是否正确。

授予创建 aws: ec2: image 数据类型参数的权限

使用 AWS Identity and Access Management (IAM) 策略,您可以提供或限制用户对参数存储 API 操作和内容的访问权限。

以下示例策略为用户授予权限,以调用PutParameter的 API 操作aws:ec2:image。这意味着用户可以添加数据类型aws:ec2:image传递到系统。

{ "Version": "2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": "ssm:PutParameter", "Resource": "*" }, { "Sid": "VisualEditor1", "Effect": "Allow", "Action": "ec2:DescribeImages", "Resource": "*" } ] }

操作方法 AMI 格式验证工作

当您指定aws:ec2:image作为参数的数据类型,Systems Manager 不会立即创建参数。而是执行异步验证操作,以确保参数值满足 AMI ID,并且指定的 AMI 您的 AWS 账户中可用。

请务必注意,在验证操作完成之前,可能会生成参数版本号。也就是说,单独生成的参数版本号并不表示该操作已成功完成。

要监控参数是否已成功创建,我们建议使用 Amazon EventBridge (EventBridge) 向您发送有关创建和更新参数操作的通知。这些通知会报告参数操作是否成功。如果操作失败,通知会包含一条错误消息,指出失败的原因。

{ "version": "0", "id": "eed4a719-0fa4-6a49-80d8-8ac65EXAMPLE", "detail-type": "Parameter Store Change", "source": "aws.ssm", "account": "111122223333", "time": "2020-05-26T22:04:42Z", "region": "us-east-2", "resources": [ "arn:aws:ssm:us-east-2:111122223333:parameter/golden-ami" ], "detail": { "exception": "Unable to Describe Resource", "dataType": "aws:ec2:image", "name": "golden-ami", "type": "String", "operation": "Create" } }

有关在 EventBridge 中订阅参数存储事件的信息,请参阅。基于 Parameter Store 事件设置通知或触发操作