检索经 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 policy。

  • ssm:GetParameters

  • ssm:GetParameter

  • ssm:GetParametersByPath

Systems Manager Parameter Store 参数格式

以下是经 Amazon ECS 优化的 AMI 变体的参数名称格式。

  • Windows Server 2022 Full AMI 元数据:

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

    /aws/service/ami-windows-latest/Windows_Server-2022-English-Core-ECS_Optimized
  • Windows Server 2019 Full 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 2016 Full AMI 元数据:

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

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

/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

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

您可将 Amazon CLI 与以下 Amazon CLI 命令结合使用来检索latest stable的经 Amazon ECS 优化的 AMI。

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

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

    aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2022-English-Core-ECS_Optimized --region us-east-1
  • 对于经 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 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 CloudFormation 模板中使用最新推荐的经 Amazon ECS 优化的 AMI

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

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