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

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

检索Amazon ECS-Optimized AMI元数据

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

注意

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

  • ssm:GetParameters

  • ssm:GetParameter

  • ssm:GetParametersByPath

Systems Manager Parameter Store 参数格式

以下是每个Amazon ECS-optimized AMI变体的参数名称的格式。

经 Amazon ECS优化AMI的 Linux

  • 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-optimized Amazon Linux AMI 将于 2021 年 4 月 15 日弃用。此后,Amazon ECS 将继续为 AMI 提供关键和重要的安全更新,但不会增加对新功能的支持。

经 Amazon ECS优化AMI的 Windows

  • Windows Server 2019 完整 AMI 元数据:

    /aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized
  • Windows Server 2019 Core AMI 元数据:

    /aws/service/ami-windows-latest/Windows_Server-2019-English-Core-ECS_Optimized
  • Windows Server 2014 Core AMI 元数据:

    /aws/service/ami-windows-latest/Windows_Server-2004-English-Core-ECS_Optimized
  • Windows Server 1909 Core AMI 元数据:

    /aws/service/ami-windows-latest/Windows_Server-1909-English-Core-ECS_Optimized
    重要

    已经 Amazon ECS 优化的 Windows Server 1909 Core AMI弃用。不会发布此 AMI 的新版本。

  • Windows Server 2016 Full AMI 元数据:

    /aws/service/ami-windows-latest/Windows_Server-2016-English-Full-ECS_Optimized

以下参数名称格式通过使用 Amazon ECS-optimized Amazon Linux 2 AMI 检索最新稳定的recommended. 的元数据。

/aws/service/ecs/optimized-ami/amazon-linux-2/recommended

以下是针对参数值返回的 JSON 对象的示例。

{
	"schema_version": 1,
	"image_name": "amzn2-ami-ecs-hvm-2.0.20181017-x86_64-ebs",
	"image_id": "ami-04a4fb062c609f55b",
	"os": "Amazon Linux 2",
	"ecs_runtime_version": "Docker version 18.06.1-ce",
	"ecs_agent_version": "1.21.0"
}

上述输出中的每个字段都可作为子参数查询。通过将子参数名称追加到所选 的路径来构造子参数的参数路径。AMI. 可用子参数如下:

  • schema_version

  • image_id

  • image_name

  • os

  • ecs_agent_version

  • ecs_runtime_version

以下参数名称格式通过使用子参数 Amazon ECS-optimized Amazon Linux 2 AMI 检索最新稳定的image_id. 的映像 ID。

/aws/service/ecs/optimized-ami/amazon-linux-2/recommended/image_id

以下参数名称格式通过指定 Amazon ECS-optimized AMI 名称来检索特定AMI 版本的元数据。

  • Amazon ECS-optimized Amazon Linux 2 AMI 元数据:

    /aws/service/ecs/optimized-ami/amazon-linux-2/amzn2-ami-ecs-hvm-2.0.20181112-x86_64-ebs
注意

所有版本的Amazon ECS-optimized 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-optimized AMI

您可以将 与Amazon ECS-optimized AMI以下命令AWS CLI结合使用AWS CLI来检索最新的稳定 。

经 Amazon ECS优化AMI的 Linux

  • 对于 Amazon ECS-optimized 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-optimized AMI:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/gpu/recommended --region us-east-1
  • 对于 Amazon ECS-optimized 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-optimized Amazon Linux AMI:

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

    Amazon ECS-optimized Amazon Linux AMI 将于 2021 年 4 月 15 日弃用。此后,Amazon ECS 将继续为 AMI 提供关键和重要的安全更新,但不会增加对新功能的支持。

经 Amazon ECS优化AMI的 Windows

  • 对于 Amazon ECS 优化的 Windows Server 2019 Full AMI:

    aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized --region us-east-1
  • 对于 经 Amazon ECS 优化的 Windows Server 2019 Core AMI:

    aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Core-ECS_Optimized --region us-east-1
  • 对于 经 Amazon ECS 优化的 Windows Server 2004 Core AMI:

    aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2004-English-Core-ECS_Optimized --region us-east-1
  • 对于 经 Amazon ECS 优化的 Windows Server 1909 Core AMI:

    aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-1909-English-Core-ECS_Optimized --region us-east-1
    重要

    已经 Amazon ECS 优化的 Windows Server 1909 Core AMI弃用。不会发布此 AMI 的新版本。

  • 对于 Amazon ECS 优化的 Windows Server 2016 Full AMI:

    aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2016-English-Full-ECS_Optimized --region us-east-1

检索特定Amazon ECS-optimized Amazon Linux 2 AMI 版本的元数据

将 Amazon ECS-optimized Amazon Linux AMI 与以下 AWS CLI 命令结合使用来检索特定AWS CLI 版本的元数据。将 AMI 名称替换为要检索的Amazon ECS-optimized Amazon Linux 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

使用 Amazon ECS-optimized Amazon Linux 2 AMI Systems Manager API 检索GetParametersByPath元数据

通过Amazon ECS-optimized Amazon Linux 2 AMI以下命令,使用 Systems Manager GetParametersByPath API 检索AWS CLI元数据。

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

检索最新推荐的 的映像 IDAmazon ECS-optimized Amazon Linux 2 AMI

您可以通过使用子参数 Amazon ECS-optimized Amazon Linux 2 AMI 检索最新推荐的image_id. 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 ECS-optimized AMI 模板中使用最新推荐的AWS CloudFormation

您可以通过引用 Amazon ECS-optimized AMI 参数存储名称来引用 AWS CloudFormation 模板Systems Manager中最新推荐的 。

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

Windows 示例

Parameters: LatestECSOptimizedAMI: Description: AMI ID Type: AWS::SSM::Parameter::Value<AWS::EC2::Image::Id> Default: /aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized/image_id