Recuperar oAmazon ECS-Optimized AMImetadados - Amazon Elastic Container Service

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Recuperar oAmazon ECS-Optimized AMImetadados

OAMIID da, o nome da imagem, o sistema operacional, a versão do agente de contêiner e a versão do tempo de execução para cada variante doAmazon ECS-optimized AMIs podem ser recuperados programaticamente consultando oSystems ManagerAPI do repositório de parâmetros do. Para obter mais informações sobre a API do Parameter Store do Systems Manager, consulte GetParameters e GetParametersByPath.

nota

Sua conta de usuário precisa ter as seguintes permissões do IAM para recuperar os metadados da Amazon ECS-optimized AMI. Essas permissões foram adicionadas à política AmazonECS_FullAccess do IAM.

  • ssm:GetParameters

  • ssm:GetParameter

  • ssm:GetParametersByPath

Systems ManagerFormato do parâmetro Store do

Veja a seguir o formato do nome do parâmetro de cadaAmazon ECS-optimized AMIvariante.

LinuxAmazon ECSOtimizado para oAMIs

  • Metadados da Amazon Linux 2 AMI:

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

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

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

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

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

    O Amazon ECS-optimized Amazon Linux AMI está obsoleto desde 15 de abril de 2021. Após essa data, o Amazon ECS continuará fornecendo as atualizações de segurança essenciais e importantes para a AMI, mas não adicionará suporte a novos recursos.

O seguinte formato de nome de parâmetro recupera o ID de imagem da última versão estável da Amazon ECS-optimized Amazon Linux 2 AMI para Linux 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 Amazon ECS-optimized AMI, especificando o nome da AMI.

  • Metadados da Amazon ECS-optimized Amazon Linux 2 AMI:

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

Todas as versões da Amazon ECS-optimized Amazon Linux 2 AMI estão disponíveis para recuperação. SomenteAmazon ECSOtimizado para oAMIversõesamzn-ami-2017.09.l-amazon-ecs-optimized(Linux) e versões posteriores podem ser recuperadas. Para obter mais informações, consulte Amazon ECSOtimizado para oAMIversões.

Examples

Os exemplos a seguir mostram maneiras como você pode recuperar os metadados de cadaAmazon ECSOtimizado para oAMIvariante.

Recuperar os metadados da mais recente Amazon ECS-optimized AMI estável

Você pode recuperar o mais recente estávelAmazon ECS-optimized AMIUsando oAWS CLICom os seguintes exemplos deAWS CLIComandos do .

LinuxAmazon ECSOtimizado para oAMIs

  • Para oAmazon ECS-optimized Amazon Linux 2 AMIs:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/recommended --region us-east-1
  • Para oAmazon ECS-optimized Amazon Linux 2 (arm64) AMIs:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/arm64/recommended --region us-east-1
  • Para oAmazon ECS GPU-optimized AMIs:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/gpu/recommended --region us-east-1
  • Para oAmazon ECS-optimized Amazon Linux 2 (Inferentia) AMIs:

    aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/inf/recommended --region us-east-1
  • Para oAmazon ECS-optimized Amazon Linux AMIs:

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

    O Amazon ECS-optimized Amazon Linux AMI está obsoleto desde 15 de abril de 2021. Após essa data, o Amazon ECS continuará fornecendo as atualizações de segurança essenciais e importantes para a AMI, mas não adicionará suporte a novos recursos.

Recuperar os metadados de uma versão específica da Amazon ECS-optimized Amazon Linux 2 AMI

Recupere os metadados de uma versão específica da Amazon ECS-optimized Amazon Linux AMI por meio da AWS CLI, usando o comando da AWS CLI a seguir. Substitua o nome da AMI pelo nome da Amazon ECS-optimized Amazon Linux AMI a ser recuperado. Para obter mais informações sobre as versões disponíveis, consulte Amazon ECSOtimizado para oAMIversões.

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

Recuperar os metadados da Amazon ECS-optimized Amazon Linux 2 AMI usando a API GetParametersByPath do Systems Manager

Recupere os metadados da Amazon ECS-optimized Amazon Linux 2 AMI com a API GetParametersByPath do Systems Manager, usando o comando da AWS CLI a seguir.

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

Recuperar o ID de imagem da Amazon ECS-optimized Amazon Linux 2 AMI mais recente e recomendada

Você pode recuperar o ID de imagem do mais recente e recomendado ID da Amazon ECS-optimized Amazon Linux 2 AMI usando o subparâmetro image_id.

aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/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"

Usar a mais recente e recomendada Amazon ECS-optimized AMI em um modelo do AWS CloudFormation

Você pode consultar as últimas recomendaçõesAmazon ECS-optimized AMIem umAWS CloudFormationreferenciando o modeloSystems Managernome da loja de parâmetros.

Exemplo do 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