Recuperar os metadados da AMI otimizada para Amazon ECS

Você pode recuperar programaticamente os metadados da AMI otimizados para Amazon ECS. Os metadados incluem o nome da AMI, a versão do agente de contêiner do Amazon ECS e a versão de tempo de execução do Amazon ECS, que inclui a versão Docker.

O ID da AMI, o nome da imagem, o sistema operacional, a versão do agente de contêiner, o nome da imagem da fonte e a versão do runtime para cada variante das AMIs otimizadas para Amazon ECS podem ser recuperados de maneira programática, consultando a API da Systems Manager Parameter Store. Para obter mais informações sobre a API Systems Manager Parameter Store, consulte GetParametersGetParametersByPathe.

nota

O usuário administrador precisa ter as seguintes permissões do IAM para recuperar os metadados da AMI otimizada para Amazon ECS. Essas permissões foram adicionadas à política AmazonECS_FullAccess do IAM.

• sms: GetParameters

• sms: GetParameter

• sms: GetParametersByPath

Formato de parâmetro do Systems Manager Parameter Store

Veja a seguir o formato do nome do parâmetro para cada variante da AMI otimizada para Amazon ECS.

AMIs do Linux otimizadas para Amazon ECS

• Metadados da AMI do Amazon Linux 2023:

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

• Metadados da AMI do Amazon Linux 2023 (arm64):

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

• Metadados da AMI do Amazon Linux 2023 (Neuron):

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

• Metadados da AMI do Amazon Linux 2:

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

• Metadados da AMI do Amazon Linux 2 kernel 5.10:

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

• Metadados da AMI do Amazon Linux 2 (arm64):

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

• Metadados da AMI do Amazon Linux 2 kernel 5.10 (arm64):

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

• Metadados da AMI do kernel 5.10 otimizados para GPU do Amazon ECS:

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

• Metadados da AMI do Amazon Linux 2 (GPU):

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

• Metadados da AMI do kernel 5.10 otimizados para Amazon ECS do Amazon Linux 2 (Neuron):

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

• Metadados da AMI do Amazon Linux 2 (Neuron):

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

O seguinte formato de nome de parâmetro recupera o ID de imagem da versão estável mais recente da AMI do Amazon Linux 2 otimizada para Amazon ECS usando o subparâmetro image_id.

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

O seguinte formato de nome de parâmetro recupera os metadados de uma versão específica da AMI otimizada para Amazon ECS especificando o nome da AMI.

• Metadados da AMI do Amazon Linux 2 otimizada para Amazon ECS:

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

nota

Todas as versões da AMI do Amazon Linux 2 otimizada para Amazon ECS estão disponíveis para recuperação. Somente versões amzn-ami-2017.09.l-amazon-ecs-optimized e posteriores da AMI otimizada para Amazon ECS (Linux) podem ser recuperadas.

Exemplos

Os exemplos a seguir mostram maneiras como você pode recuperar os metadados de cada variante da AMI otimizada para Amazon ECS.

Recuperar os metadados da AMI otimizada para Amazon ECS estável mais recente

Você pode recuperar a última AMI estável otimizada para Amazon ECS usando AWS CLI o com os AWS CLI seguintes comandos.

AMIs do Linux otimizadas para Amazon ECS

• Para as AMIs do Amazon Linux 2023 otimizadas para Amazon ECS:

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

• Para as AMIs do Amazon Linux 2023 (arm64) otimizadas para Amazon ECS:

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

• Para as AMIs do Amazon Linux 2 kernel 5.10 otimizadas 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 as AMIs do Amazon Linux 2 otimizadas para Amazon ECS:

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

• Para as AMIs do Amazon Linux 2 kernel 5.10 (arm64) otimizadas 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 as AMIs do Amazon Linux 2 (arm64) otimizadas para Amazon ECS:

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

• Para as AMIs do kernel 5.10 otimizadas para GPU do Amazon ECS:

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

• Para as AMIs otimizadas para GPU do Amazon ECS:

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

• Para as AMIs do kernel 5.10 do Amazon Linux 2 (Neuron) otimizadas para Amazon ECS:

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

• Para as AMIs do Amazon Linux 2 (Neuron) otimizadas para Amazon ECS:

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

Recuperar o ID de imagem da AMI do Amazon Linux 2023 otimizada para Amazon ECS mais recente e recomendada

É possível recuperar o ID de imagem da AMI do Amazon Linux 2023 otimizada para Amazon ECS mais recente e recomendada usando o subparâmetro image_id.

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

Para recuperar o valor image_id somente, você pode consultar o valor de parâmetro específico; por exemplo:

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

Recuperar os metadados de uma versão específica da AMI do Amazon Linux 2 otimizada para Amazon ECS

Recupere os metadados de uma versão específica do Amazon Linux AMI otimizada para Amazon ECS usando AWS CLI o comando a seguir. AWS CLI Substitua o nome da AMI pelo nome da AMI do Amazon Linux otimizada para Amazon ECS a ser recuperado.

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

Recuperação dos metadados da AMI do kernel Amazon Linux 2 5.10 otimizados para Amazon ECS usando a API Systems Manager GetParametersByPath

Recupere os metadados do Amazon Linux 2 AMI otimizados para Amazon ECS com a API Systems GetParametersByPath Manager usando AWS CLI o comando a seguir.

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

Recuperando o ID da imagem da última AMI recomendada do Amazon Linux 2 kernel 5.10 otimizada para Amazon ECS

Você pode recuperar a ID da imagem da última ID de AMI recomendada do Amazon Linux 2 kernel 5.10 otimizada para Amazon ECS usando o subparâmetro. image_id

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

Para recuperar o valor image_id somente, você pode consultar o valor de parâmetro específico; por exemplo:

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

Usando a última AMI otimizada para Amazon ECS recomendada em um modelo AWS CloudFormation

É possível referenciar a mais recente e recomendada AMI otimizada para Amazon ECS em um modelo do AWS CloudFormation fazendo referência ao nome do armazenamento de parâmetros do Systems Manager.

Exemplo do Linux

Parameters:kernel-5.10
  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