检索经 Amazon ECS 优化的 AMI 元数据 - Amazon Elastic Container Service
Systems Manager Parameter Store 参数格式示例
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

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

经 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 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 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>

  • 经 Amazon ECS 优化的 Amazon 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 的元数据

您可以使用 Amazon CLI 和以下 Amazon CLI 命令检索最新版稳定的经 Amazon ECS 优化的 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

  • 对于 Amazon 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

  • 对于经 Amazon ECS 优化的 Amazon 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 版本的元数据

使用 Amazon CLI 和以下 Amazon CLI 命令检索特定 经 Amazon ECS 优化的 Amazon Linux AMI版本的元数据。将要检索的 经 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 GetParametersByPath API 检索经 Amazon ECS 优化的 Amazon Linux 2 内核 5.10 AMI 元数据

通过 Amazon 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/kernel-5.10/ --region us-east-1

检索最新推荐的经 Amazon ECS 优化的 Amazon Linux 2 内核 5.10 AMI 的映像 ID

您可以通过使用子参数 image_id 检索最新推荐的经 Amazon ECS 优化的 Amazon Linux 2 内核 5.10 AMI ID 的映像 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 CloudFormation 模板中使用最新推荐的经 Amazon ECS 优化的 AMI

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