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

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 (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 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