检索经 Amazon ECS 优化的 AMI 元数据 - Amazon Elastic Container Service
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

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

注意

您的用户账户必须具有以下 IAM 权限才能检索经 Amazon ECS 优化的 AMI 元数据。这些权限已添加到 AmazonECS_FullAccess IAM 策略。

  • 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 (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 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 版本

Examples

以下示例说明了可用于检索经 Amazon ECS 优化的 AMI 变体元数据的方法。

检索最新版稳定经 Amazon ECS 优化的 AMI 的元数据

您可以使用 Amazon CLI 和以下 Amazon 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 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 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 版本的元数据

使用 Amazon CLI 和以下 Amazon 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 元数据

通过 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/ --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"

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

您可以参考 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