检索经 Amazon ECS 优化的 AMI 元数据 - Amazon Elastic Container Service

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

检索经 Amazon ECS 优化的 AMI 元数据

您可以通过编程方式检索经亚马逊 ECS 优化的 AMI 元数据。元数据包括 AMI 名称、Amazon ECS 容器代理版本和包括 Docker 版本的 Amazon ECS 运行时版本。

经 Amazon ECS 优化的 AMI 的 AMI ID、映像名称、操作系统、容器代理版本、源映像名称和运行时版本可通过查询 Systems Manager Parameter Store API 以编程方式检索。有关 Systems Manager 参数存储 API 的更多信息,请参阅GetParametersGetParametersByPath

注意

您的管理用户必须具有以下 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>
  • 亚马逊 ECS GPU 优化内核 5.10 AMI 元数据:

    /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/gpu/<version>
  • Amazon Linux 2 (GPU) AMI 元数据:

    /aws/service/ecs/optimized-ami/amazon-linux-2/gpu/<version>
  • 亚马逊 ECS 优化了亚马逊 Linux 2(Neuron)内核 5.10 AMI 元数据:

    /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/inf/<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 的元数据

您可以使用以下 AWS CLI 命令检索经过优化 Amazon ECS 的最新稳定 AWS 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 内核 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 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(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 优化的 Amazon Linux 2 (arm64) AMI:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/arm64/recommended --region us-east-1
  • 对于亚马逊 ECS GPU 优化内核 5.10 AMI:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/gpu/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
  • 对于优化的亚马逊 ECS,亚马逊 Linux 2(Neuron)内核 5.10 AMI:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/inf/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 --region us-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 版本的元数据

使用以下 AWS CLI 命令检索特定亚马逊 ECS 优化的 Amazon Linux AMI 版本 AWS 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 --region us-east-1

使用 Systems Manager API 检索经亚马逊 ECS 优化的亚马逊 Linux 2 内核 5.10 AMI 元数据 GetParametersByPath

使用带有以下命令的 Systems Manager GetParametersByPath API 检索经亚马逊 ECS 优化的 Amazon Linux 2 AWS CLI AMI 元数据。

aws ssm get-parameters-by-path --path /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/ --region us-east-1

正在检索最新推荐的亚马逊 ECS 优化版 Amazon Linux 2 内核 5.10 AMI 的图片 ID

您可以使用子参数检索最新推荐的亚马逊 ECS 优化的 Amazon Linux 2 内核 5.10 AMI ID 的映像 ID。image_id

aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/recommended/image_id --region us-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 AWS CloudFormation

您可以参考 Systems Manager 参数存储名称引用 AWS CloudFormation 模板中最新推荐的经 Amazon ECS 优化的 AMI。

Linux 示例

Parameters:kernel-5.10 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