Recuperación de metadatos de las AMI optimizadas para Amazon ECS

Para recuperar el ID de la AMI, el nombre de la imagen, el sistema operativo, la versión del agente de contenedor, el nombre de la imagen de origen y la versión del tiempo de ejecución de las AMI optimizada para Amazon ECS mediante programación, consulte la API del Parameter Store de Systems Manager. Para obtener más información sobre la API de almacenamiento de parámetros de Systems Manager, consulte GetParametersy GetParametersByPath.

nota

La cuenta administrativa debe tener los siguientes permisos de IAM para recuperar los metadatos de la AMI optimizada para Amazon ECS. Estos permisos se han añadido a la política de IAM AmazonECS_FullAccess.

• ssm:GetParameters

• ssm:GetParameter

• ssm:GetParametersByPath

Formato de los parámetros de Parameter Store de Systems Manager

A continuación, se muestra el formato del nombre del parámetro para cada variante de AMI optimizada para Amazon ECS.

AMI de Linux optimizadas para Amazon ECS

• Metadatos de AMI de Amazon Linux 2:

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

• Metadatos de AMI de Amazon Linux 2 con kernel 5.10:

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

• Metadatos de AMI de Amazon Linux 2 (arm64):

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

• Metadatos de AMI de Amazon Linux 2 con kernel 5.10 (arm64):

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

• Metadatos de AMI de Amazon Linux 2 (GPU):

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

• Metatos de AMI de Amazon Linux 2 (Neuron):

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

• Metatos de AMI de Amazon Linux 2023:

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

• Metatos de AMI de Amazon Linux 2023 (arm64):

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

• Metatos de AMI de Amazon Linux 2023 (Neuron):

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

• Metadatos de AMI de Amazon Linux:

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

  importante

  La AMI de Amazon Linux optimizada para Amazon ECS está obsoleta desde el 15 de abril de 2021. Después de esa fecha, Amazon ECS continuará proporcionando actualizaciones de seguridad críticas e importantes para la AMI, pero no agregará soporte para nuevas características.

El siguiente formato de nombre de parámetro recupera el ID de imagen de la última versión estable de la AMI Amazon Linux 2 optimizada para Amazon ECS mediante el parámetro secundario image_id.

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

El siguiente formato de nombre de parámetro recupera los metadatos de una versión específica de la AMI optimizada para Amazon ECS mediante la especificación del nombre de la AMI.

• Metadatos de AMI de Amazon Linux 2 optimizada para Amazon ECS:

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

nota

Todas las versiones de AMI Amazon Linux 2 optimizadas para Amazon ECS están disponibles para su recuperación. Solo se pueden recuperar las versiones amzn-ami-2017.09.l-amazon-ecs-optimized de AMI (Linux) optimizadas para Amazon ECS y versiones posteriores.

Ejemplos

Los siguientes ejemplos muestran formas en las que pueden recuperar los metadatos de cada variante de AMI optimizada para Amazon ECS.

Recuperación de los metadatos de la AMI optimizada para Amazon ECS estable más reciente

Utilice los siguientes comandos de la AWS CLI para recuperar la AMI optimizada para Amazon ECS estable más reciente mediante la AWS CLI.

AMI de Linux optimizadas para Amazon ECS

• Para las AMI de Amazon Linux 2 optimizadas para Amazon ECS:

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

• Para las AMI de Amazon Linux 2 con kernel 5.10 optimizadas para Amazon ECS:

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

• Para las AMI de Amazon Linux 2 (arm64) optimizadas para Amazon ECS:

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

• Para las AMI de Amazon Linux 2 con kernel 5.10 (arm64) optimizadas para Amazon ECS:

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

• Para las AMI optimizadas para GPU de Amazon ECS:

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

• Para las AMI de Amazon Linux 2 (Neuron) optimizadas para las AMI de Amazon ECS:

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

• Para las AMI de Amazon Linux 2023 optimizadas para las AMI de Amazon ECS:

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

• Para las AMI de Amazon Linux 2023 (arm64) optimizadas para Amazon ECS:

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

• Para las AMI de Amazon Linux optimizadas para Amazon ECS:

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

  importante

  La AMI de Amazon Linux optimizada para Amazon ECS está obsoleta desde el 15 de abril de 2021. Después de esa fecha, Amazon ECS continuará proporcionando actualizaciones de seguridad críticas e importantes para la AMI, pero no agregará soporte para nuevas características.

Recuperación de los metadatos de una versión específica de AMI de Amazon Linux 2 optimizada para Amazon ECS

Utilice el siguiente comando de la AWS CLI para recuperar los metadatos de una versión específica de AMI de Amazon Linux optimizada para Amazon ECS mediante la AWS CLI. Sustituya el nombre de la AMI por el nombre de la AMI de Amazon Linux optimizada para Amazon ECS que va a recuperar.

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

Recuperación de los metadatos de la AMI de Amazon Linux 2 optimizada para Amazon ECS mediante laGetParametersByPath API de Systems Manager

Utilice el siguiente comando de la API de Amazon AMI 2 optimizada para Amazon ECSAWS CLI mediante laGetParametersByPath API de Systems Manager.

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

Recuperación del ID de imagen de la AMI de Amazon Linux 2 optimizada para Amazon ECS más reciente recomendada

Puede recuperar el ID de imagen del ID de la AMI de Amazon Linux 2 optimizada para Amazon ECS más reciente recomendada mediante el parámetro secundario image_id.

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

Para recuperar solo el valor de image_id, puede consultar el valor de parámetro específico; por ejemplo:

aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/recommended/image_id --region us-east-1 --query "Parameters[0].Value"

Recuperación del ID de imagen de la AMI de Amazon ECS más reciente recomendada optimizada para Amazon ECS

Puede recuperar el ID de imagen del ID de la AMI de Amazon Linux 2023 optimizada para Amazon ECS más reciente recomendada mediante el parámetro secundarioimage_id.

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

Para recuperar solo el valor de image_id, puede consultar el valor de parámetro específico; por ejemplo:

aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/recommended/image_id --region us-east-1 --query "Parameters[0].Value"

Utilización de la AMI optimizada para Amazon ECS más reciente recomendada en una plantilla de AWS CloudFormation

Para hacer referencia a la AMI optimizada para Amazon ECS recomendada en una plantilla de AWS CloudFormation, pude hacer referencia al nombre del almacén de parámetros de Systems Manager.

Ejemplo de 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