Recuperação de metadados da AMI do Windows otimizada para o Amazon ECS

O ID da AMI, o nome da imagem, o sistema operacional, a versão do agente de contêiner 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 do Systems Manager Parameter Store. Para obter mais informações sobre a API do Systems Manager Parameter Store, consulte GetParameters e GetParametersByPath.

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.

• ssm:GetParameters

• ssm:GetParameter

• ssm:GetParametersByPath

Formato de parâmetro do Systems Manager Parameter Store

nota

Os parâmetros a seguir da API do Systems Manager Parameter Store estão obsoletos e não devem ser usados para recuperar as AMIs mais recentes do Windows:

• /aws/service/ecs/optimized-ami/windows_server/2016/english/full/recommended/image_id

• /aws/service/ecs/optimized-ami/windows_server/2019/english/full/recommended/image_id

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

• Metadados da AMI do Windows Server 2022 Full:

  /aws/service/ami-windows-latest/Windows_Server-2022-English-Full-ECS_Optimized

• Metadados da AMI do Windows Server 2022 Core:

  /aws/service/ami-windows-latest/Windows_Server-2022-English-Core-ECS_Optimized

• Metadados da AMI do Windows Server 2019 Full:

  /aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized

• Metadados da AMI do Windows Server 2019 Core:

  /aws/service/ami-windows-latest/Windows_Server-2019-English-Core-ECS_Optimized

• Metadados da AMI do Windows Server 2016 Full:

  /aws/service/ami-windows-latest/Windows_Server-2016-English-Full-ECS_Optimized

O formato de nome de parâmetro a seguir recupera os metadados da última versão estável da AMI do Windows Server 2019 Full.

aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized

Veja a seguir um exemplo do objeto JSON retornado para o valor do parâmetro.

{
    "Parameters": [
        {
            "Name": "/aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized",
            "Type": "String",
            "Value": "{\"image_name\":\"Windows_Server-2019-English-Full-ECS_Optimized-2023.06.13\",\"image_id\":\"ami-0debc1fb48e4aee16\",\"ecs_runtime_version\":\"Docker (CE) version 20.10.21\",\"ecs_agent_version\":\"1.72.0\"}",
            "Version": 58,
            "LastModifiedDate": "2023-06-22T19:37:37.841000-04:00",
            "ARN": "arn:aws:ssm:us-east-1::parameter/aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized",
            "DataType": "text"
        }
    ],
    "InvalidParameters": []
}

Cada um dos campos na saída acima está disponível para ser consultado como subparâmetros. Crie o caminho do parâmetro para um subparâmetro anexando o nome do subparâmetro ao caminho para a AMI selecionada. Os seguintes subparâmetros estão disponíveis:

• schema_version

• image_id

• image_name

• os

• ecs_agent_version

• ecs_runtime_version

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

É possível recuperar a AMI otimizada para Amazon ECS estável mais recente por meio da AWS CLI, usando os comandos da AWS CLI a seguir.

• Para a AMI do Windows Server 2022 Full otimizada para Amazon ECS:

  aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2022-English-Full-ECS_Optimized --region us-east-1

• Para a AMI do Windows Server 2022 Core otimizada para Amazon ECS:

  aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2022-English-Core-ECS_Optimized --region us-east-1

• Para a AMI do Windows Server 2019 Full otimizada para Amazon ECS:

  aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized --region us-east-1

• Para a AMI do Windows Server 2019 Core otimizada para Amazon ECS:

  aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Core-ECS_Optimized --region us-east-1

• Para a AMI do Windows Server 2016 Full otimizada para Amazon ECS:

  aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2016-English-Full-ECS_Optimized --region us-east-1

Usar a mais recente e recomendada AMI otimizada para Amazon ECS em um modelo do 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.

Parameters:
  LatestECSOptimizedAMI:
    Description: AMI ID
    Type: AWS::SSM::Parameter::Value<AWS::EC2::Image::Id>
    Default: /aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized/image_id