Amazon ECS に最適化された AMI メタデータを取得する

Amazon ECS に最適化された AMI の各バリアントの AMI ID、イメージ名、オペレーティングシステム、コンテナエージェントバージョン、ソースイメージ名、ランタイムバージョンは、Systems Manager Parameter Store API にクエリすることでプログラムで取得できます。Systems Manager パラメータストア API の詳細については、「GetParameters」および「GetParametersByPath」を参照してください。

注記

Amazon ECS に最適化された AMI メタデータを取得するには、ご使用のユーザーアカウントに次の IAM アクセス権限が必要です。AmazonECS_FullAccess IAM ポリシーには、次の許可が追加されています。

• ssm:GetParameters

• ssm:GetParameter

• ssm:GetParametersByPath

Systems Manager パラメータストアのパラメータフォーマット

以下は、各 Amazon ECS に最適化された AMI バリアントのパラメータ名のフォーマットです。

Linux Amazon ECS に最適化された AMI

• Amazon Linux 2 AMI メタデータ:

  /aws/service/ecs/optimized-ami/amazon-linux-2/<version>

• Amazon Linux 2 (arm64) AMI メタデータ:

  /aws/service/ecs/optimized-ami/amazon-linux-2/arm64/<version>

• Amazon Linux 2 (GPU) AMI メタデータ:

  /aws/service/ecs/optimized-ami/amazon-linux-2/gpu/<version>

• Amazon Linux 2 (推定) AMI メタデータ:

  /aws/service/ecs/optimized-ami/amazon-linux-2/inf/<version>

• Amazon Linux 2022 AMI メタデータ:

  重要

  Amazon ECS に最適化された Amazon Linux 2022 AMI はプレビュー中のため、変更される場合があります。

  /aws/service/ecs/optimized-ami/amazon-linux-2022/<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 バージョン」を参照してください。

例

以下の例は、それぞれの Amazon ECS に最適化された AMI バリアントのメタデータを取得する方法を示しています。

安定している最新の Amazon ECS に最適化された AMI メタデータを取得する

安定している最新の Amazon ECS に最適化された AMI を取得するには、AWS CLI で次の AWS CLI コマンドを使用します。

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 に最適化された 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 に最適化された 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 (推定) AMI の場合:

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

• Amazon ECS に最適化された Amazon Linux 2022 AMI はプレビュー中のため、変更される場合があります。

  Amazon ECS に最適化された Amazon Linux 2022 AMI の場合:

  aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2022/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 ECS に最適化された特定の Amazon Linux AMI バージョンのメタデータを取得するには、AWS CLI で次の AWS CLI コマンドを使用します。AMI 名を、Amazon ECS に最適化された 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

Systems Manager の getParametersByPath API を使用した Amazon ECS に最適化された Amazon Linux 2 AMI メタデータの取得

Systems Manager の GetParametersByPath API を使用して、Amazon ECS に最適化された Amazon Linux 2 AMI メタデータを取得します。AWS CLI で次のコマンドを使用します。

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

推奨される最新の Amazon ECS に最適化された Amazon Linux AMI のイメージ ID を取得する

推奨される最新の Amazon ECS に最適化された Amazon Linux 2 AMI ID のイメージ ID を取得するには、サブパラメータ image_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"

AWS CloudFormation テンプレートの推奨される最新の Amazon ECS に最適化された AMI を使用する

Systems Manager パラメータストア名を参照することにより、AWS 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