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

经 Amazon ECS 优化的 AMI 的 AMI ID、映像名称、操作系统、容器代理版本、源映像名称和运行时版本可通过查询 Systems Manager Parameter Store API 以编程方式检索。有关 Systems Manager Parameter Store 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 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（Inferentia）AMI 元数据：

  /aws/service/ecs/optimized-ami/amazon-linux-2/inf/<version>

• Amazon Linux 2022 AMI 元数据：

  重要

  经 Amazon ECS 优化的 Amazon Linux 2022 AMI 处于预览版，可能会发生变化。

  /aws/service/ecs/optimized-ami/amazon-linux-2022/<version>

• Amazon Linux AMI 元数据：

  /aws/service/ecs/optimized-ami/amazon-linux/<version>

  重要

  经 Amazon ECS 优化的 Amazon Linux AMI 于2021 年 4 月 15 日已弃用。在此日期之后，Amazon ECS 将继续为 AMI 提供关键和重要的安全更新，但不会添加对新功能的支持。

以下参数名称格式通过使用子参数 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 ECS 优化的 AMI 的元数据

您可以使用 AWS CLI 和以下 AWS CLI 命令检索最新版稳定的经 Amazon ECS 优化的 AMI。

Linux经 Amazon ECS 优化的 AMI

• 对于经 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（Inferentia）AMI：

  aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/inf/recommended --region us-east-1

• 经 Amazon ECS 优化的 Amazon Linux 2022 AMI 处于预览版，可能会发生变化。

  对于经 Amazon ECS 优化的 Amazon Linux 2022 AMI：

  aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2022/recommended --region us-east-1

• 对于 经 Amazon ECS 优化的 Amazon Linux AMI：

  aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux/recommended --region us-east-1

  重要

  经 Amazon ECS 优化的 Amazon Linux AMI 于 2021 年 4 月 15 日已弃用。在此日期之后，Amazon ECS 将继续为 AMI 提供关键和重要的安全更新，但不会添加对新功能的支持。

检索特定经 Amazon ECS 优化的 Amazon Linux 2 AMI 版本的元数据

使用 AWS CLI 和以下 AWS CLI 命令检索特定 经 Amazon ECS 优化的 Amazon Linux AMI版本的元数据。将要检索的 经 Amazon ECS 优化的 Amazon Linux AMI 的名称替换为 AMI 名称 有关可用版本的更多信息，请参阅 经 Amazon ECS 优化的 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 GetParametersByPath API 检索 经 Amazon ECS 优化的 Amazon Linux 2 AMI 元数据

通过 AWS CLI 和下列命令使用 Systems Manager GetParametersByPath API 检索 经 Amazon ECS 优化的 Amazon Linux 2 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 --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"

在 AWS CloudFormation 模板中使用最新推荐的经 Amazon ECS 优化的 AMI

您可以参考 Systems Manager 参数存储名称引用 AWS 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