本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
检索经 Amazon ECS 优化的 AMI 元数据
您可以通过编程方式检索经亚马逊 ECS 优化的 AMI 元数据。元数据包括 AMI 名称、Amazon ECS 容器代理版本和包括 Docker 版本的 Amazon ECS 运行时版本。
经 Amazon ECS 优化的 AMI 的 AMI ID、映像名称、操作系统、容器代理版本、源映像名称和运行时版本可通过查询 Systems Manager Parameter Store API 以编程方式检索。有关 Systems Manager 参数存储 API 的更多信息,请参阅GetParameters和GetParametersByPath。
注意
您的管理用户必须具有以下 IAM 权限才能检索经 Amazon ECS 优化的 AMI 元数据。这些权限已添加到 AmazonECS_FullAccess
IAM policy。
-
ssm:GetParameters
-
ssm:GetParameter
-
ssm:GetParametersByPath
Systems Manager Parameter Store 参数格式
以下是经 Amazon ECS 优化的 AMI 变体参数名称的格式。
Linux 经 Amazon ECS 优化的 AMI
-
Amazon Linux 2023 AMI 元数据:
/aws/service/ecs/optimized-ami/amazon-linux-2023/
<version>
-
Amazon Linux 2023(arm64)AMI 元数据:
/aws/service/ecs/optimized-ami/amazon-linux-2023/arm64/
<version>
-
Amazon Linux 2023(Neuron)AMI 元数据:
/aws/service/ecs/optimized-ami/amazon-linux-2023/inf/
<version>
-
Amazon Linux 2 AMI 元数据:
/aws/service/ecs/optimized-ami/amazon-linux-2/
<version>
-
Amazon Linux 2 内核 5.10 AMI 元数据:
/aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/
<version>
-
Amazon Linux 2 (arm64) AMI 元数据:
/aws/service/ecs/optimized-ami/amazon-linux-2/arm64/
<version>
-
Amazon Linux 2 内核 5.10(arm64)AMI 元数据:
/aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/arm64/
<version>
-
Amazon Linux 2 (GPU) AMI 元数据:
/aws/service/ecs/optimized-ami/amazon-linux-2/gpu/
<version>
-
Amazon Linux 2(Neuron)AMI 元数据:
/aws/service/ecs/optimized-ami/amazon-linux-2/inf/
<version>
以下参数名称格式通过使用子参数 image_id
检索 经 Amazon ECS 优化的Amazon Linux 2 AMI 的映像 ID。
/aws/service/ecs/optimized-ami/amazon-linux-2/
recommended/image_id
以下参数名称格式通过指定 AMI 名称来检索特定的经 Amazon ECS 优化的 AMI 版本的元数据。
-
经 Amazon ECS 优化的 Amazon Linux 2 AMI 元数据:
/aws/service/ecs/optimized-ami/amazon-linux-2/
amzn2-ami-ecs-hvm-2.0.20181112-x86_64-ebs
注意
经 Amazon ECS 优化的 Amazon Linux 2 AMI 的所有版本都可用于检索。只能检索经 Amazon ECS 优化的 AMI 版本 amzn-ami-2017.09.l-amazon-ecs-optimized
(Linux) 及更高版本。
示例
以下示例说明了可用于检索经 Amazon ECS 优化的 AMI 变体的元数据的方法。
检索最新稳定的经 Amazon ECS 优化的 AMI 的元数据
您可以使用以下 Amazon CLI 命令检索经过优化 Amazon ECS 的最新稳定 Amazon CLI 版 AMI。
Linux 经 Amazon ECS 优化的 AMI
-
对于经 Amazon ECS 优化的 Amazon Linux 2023 AMI:
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/recommended --region
us-east-1
-
对于经 Amazon ECS 优化的 Amazon Linux 2023(arm64)AMI:
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/arm64/recommended --region
us-east-1
-
对于经 Amazon ECS 优化的 Amazon Linux 2 AMI:
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/recommended --region
us-east-1
-
对于经 Amazon ECS 优化的 Amazon Linux 2 内核 5.10 AMI:
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/recommended --region
us-east-1
-
对于经 Amazon ECS 优化的 Amazon Linux 2 (arm64) AMI:
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/arm64/recommended --region
us-east-1
-
对于经 Amazon ECS 优化的 Amazon Linux 2 内核 5.10(arm64)AMI:
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/arm64/recommended --region
us-east-1
-
对于 Amazon ECS GPU 优化型 AMI:
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/gpu/recommended --region
us-east-1
-
对于经 Amazon ECS 优化的 Amazon Linux 2(Neuron)AMI:
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/inf/recommended --region
us-east-1
检索最新推荐的经 Amazon ECS 优化的 Amazon Linux 2023 AMI 的映像 ID
您可以通过使用子参数 image_id
检索最新推荐的经 Amazon ECS 优化的 Amazon Linux 2023 AMI ID 的映像 ID。
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/
recommended/image_id
--regionus-east-1
要仅检索 image_id
值,您可以查询特定参数值;例如:
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/recommended/
image_id
--region us-east-1 --query "Parameters[0].Value
"
检索特定经 Amazon ECS 优化的 Amazon Linux 2 AMI 版本的元数据
使用以下 Amazon CLI 命令检索特定亚马逊 ECS 优化的 Amazon Linux AMI 版本 Amazon CLI 的元数据。将要检索的 经 Amazon ECS 优化的 Amazon Linux AMI 的名称替换为 AMI 名称
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/
amzn2-ami-ecs-hvm-2.0.20200928-x86_64-ebs
--regionus-east-1
使用 Systems Manager API 检索经亚马逊 ECS 优化的 Amazon Linux 2 AMI 元数据 GetParametersByPath
使用带有以下命令的 Systems Manager GetParametersByPath API 检索经亚马逊 ECS 优化的 Amazon Linux 2 Amazon CLI AMI 元数据。
aws ssm get-parameters-by-path --path /aws/service/ecs/optimized-ami/amazon-linux-2/ --region
us-east-1
检索最新推荐的 经 Amazon ECS 优化的 Amazon Linux 2 AMI 的映像 ID
您可以通过使用子参数 image_id
检索最新推荐的 经 Amazon ECS 优化的 Amazon Linux 2 AMI ID 的映像 ID。
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/
recommended/image_id
--regionus-east-1
要仅检索 image_id
值,您可以查询特定参数值;例如:
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/recommended/
image_id
--region us-east-1 --query "Parameters[0].Value
"
在模板中使用最新推荐的 Amazon ECS 优化版 AMI Amazon CloudFormation
您可以参考 Systems Manager 参数存储名称引用 Amazon CloudFormation 模板中最新推荐的经 Amazon ECS 优化的 AMI。
Linux 示例
Parameters: LatestECSOptimizedAMI: Description: AMI ID Type: AWS::SSM::Parameter::Value<AWS::EC2::Image::Id> Default:
/aws/service/ecs/optimized-ami/amazon-linux-2/recommended/image_id