检索经 Amazon ECS 优化的 AMI 元数据 - Amazon Elastic Container Service
Systems Manager Parameter Store 参数格式示例

检索经 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 变体参数名称的格式。

  • 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 的元数据

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

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

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