Recuperación de metadatos de las AMI optimizadas para Amazon ECS - Amazon Elastic Container Service

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 acerca de la API del Parameter Store de Systems Manager, consulte GetParameters y GetParametersByPath.

nota

La cuenta de usuario 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 (arm64):

    /aws/service/ecs/optimized-ami/amazon-linux-2/arm64/<version>
  • Metadatos de AMI de Amazon Linux 2 (GPU):

    /aws/service/ecs/optimized-ami/amazon-linux-2/gpu/<version>
  • Metadatos de AMI de Amazon Linux 2 (Inferentia):

    /aws/service/ecs/optimized-ami/amazon-linux-2/inf/<version>
  • Metadatos de AMI de Amazon Linux 2022:

    importante

    La AMI de Amazon Linux 2022 optimizada para Amazon ECS está en versión preliminar y está sujeta a cambios.

    /aws/service/ecs/optimized-ami/amazon-linux-2022/<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. Para obtener más información, consulte Versiones de AMI optimizadas para Amazon ECS .

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 (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 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 (Inferentia) optimizadas para Amazon ECS:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/inf/recommended --region us-east-1
  • La AMI de Amazon Linux 2022 optimizada para Amazon ECS está en versión preliminar y está sujeta a cambios.

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

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2022/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. Para obtener más información sobre las versiones disponibles, consulte Versiones de AMI optimizadas para Amazon ECS.

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 AMI de Amazon Linux 2 optimizada para Amazon ECS mediante la API GetParametersByPath de Systems Manager

Utilice el siguiente comando de la AWS CLI para recuperar los metadatos de la AMI de Amazon Linux 2 optimizada para Amazon ECS mediante la API GetParametersByPath 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"

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