View a markdown version of this page

Referência às AMIs mais recentes usando parâmetros públicos do Systems Manager - Amazon Elastic Compute Cloud
Encontre o parâmetro SSM para uma AMI públicaListar as AMIs do Amazon LinuxListar as AMIs do WindowsIniciar uma instância usando um parâmetro público

Referência às AMIs mais recentes usando parâmetros públicos do Systems Manager

O AWS Systems Manager fornece parâmetros públicos para as AMIs públicas mantidas pela AWS. É possível usar os parâmetros públicos ao iniciar instâncias para garantir que você esteja usando as AMIs mais recentes. Por exemplo, o parâmetro público /aws/service/ami-amazon-linux-latest/al2023-ami-kernel-default-arm64 está disponível em todas as regiões e sempre direciona para a versão mais recente da AMI do Amazon Linux 2023 para a arquitetura de arm64 em uma determinada região.

Os parâmetros públicos estão disponíveis ao usar os seguintes caminhos:

  • Linux – /aws/service/ami-amazon-linux-latest

  • Windows – /aws/service/ami-windows-latest

Para obter mais informações, consulte Trabalhar com parâmetros públicos no Guia do usuário do AWS Systems Manager

Encontre o parâmetro SSM para uma AMI pública

Quando você descreve uma AMI pública, a resposta inclui o parâmetro associado AWS Systems Manager (SSM) no campo PublicSsmParameterName. Use esse parâmetro para identificar o parâmetro SSM que sempre aponta para a versão mais recente dessa AMI.

Console
Encontre o parâmetro SSM para uma AMI pública

  1. Abra o console do Amazon EC2 em https://console.aws.amazon.com/ec2/.

  2. No painel de navegação, selecione AMIs.

  3. Selecione uma AMI pública.

  4. Na guia Detalhes, localize o nome do parâmetro SSM público.

AWS CLI
Encontre o parâmetro SSM para uma AMI pública

Use o comando describe-images. A resposta inclui o campo PublicSsmParameterName para AMIs públicas que têm um parâmetro SSM associado.

aws ec2 describe-images \
    --image-ids ami-0abcdef1234567890

A saída do exemplo a seguir mostra o campo PublicSsmParameterName. Alguns campos são omitidos por questões de brevidade.

{
    "Images": [
        {
            "ImageId": "ami-0abcdef1234567890",
            "Name": "al2023-ami-2023.7.20260601.0-kernel-6.1-x86_64",
            ...
            "PublicSsmParameterName": "aws/service/ami-amazon-linux-latest/al2023-ami-kernel-default-x86_64"
        }
    ]
}
PowerShell
Encontre o parâmetro SSM para uma AMI pública

Use o cmdlet Get-EC2Image. A resposta inclui o campo PublicSsmParameterName para AMIs públicas que têm um parâmetro SSM associado.

Get-EC2Image -ImageId ami-0abcdef1234567890

A saída do exemplo a seguir mostra o campo PublicSsmParameterName. Alguns campos são omitidos por questões de brevidade.

ImageId                : ami-0abcdef1234567890
Name                   : al2023-ami-2023.7.20260601.0-kernel-6.1-x86_64
...
PublicSsmParameterName : aws/service/ami-amazon-linux-latest/al2023-ami-kernel-default-x86_64

Listar as AMIs do Amazon Linux

AWS CLI
Para listar as AMIs do Linux na região atual da AWS

Use o seguinte comando get-parameters-by-path. O valor do parâmetro --path é específico para as AMIs do Linux.

aws ssm get-parameters-by-path \
    --path /aws/service/ami-amazon-linux-latest \
    --query "Parameters[].Name"
PowerShell
Para listar as AMIs do Linux na região atual da AWS

Use o cmdlet Get-SSMParametersByPath.

Get-SSMParametersByPath `
    -Path "/aws/service/ami-amazon-linux-latest" | `
    Sort-Object Name | Format-Table Name

Listar as AMIs do Windows

AWS CLI
Para listar as AMIs do Windows na região atual da AWS

Use o seguinte comando get-parameters-by-path. O valor do parâmetro --path é específico para as AMIs do Windows.

aws ssm get-parameters-by-path \
    --path /aws/service/ami-windows-latest \
    --query "Parameters[].Name"
PowerShell
Para listar as AMIs do Windows na região atual da AWS

Use o cmdlet Get-SSMParametersByPath.

Get-SSMParametersByPath `
    -Path "/aws/service/ami-windows-latest" | `
    Sort-Object Name | Format-Table Name

Iniciar uma instância usando um parâmetro público

Para especificar o parâmetro público ao iniciar uma instância, use a seguinte sintaxe: resolve:ssm:public-parameter, em que resolve:ssm é o prefixo padrão e public-parameter é o caminho e o nome do parâmetro público.

AWS CLI
Como executar uma instância usando um parâmetro público

Use o comando run-instances com a opção --image-id. O exemplo especifica um parâmetro público do Systems Manager para o ID da imagem com a finalidade de iniciar uma instância usando a mais nova AMI do Amazon Linux 2023

--image-id resolve:ssm:/aws/service/ami-amazon-linux-latest/al2023-ami-kernel-default-x86_64
PowerShell
Como executar uma instância usando um parâmetro público

Use o cmdlet New-EC2Instance com o parâmetro -ImageId. O exemplo especifica um parâmetro público do Systems Manager para o ID da imagem com a finalidade de iniciar uma instância usando a mais nova AMI do Windows Server 2022.

-ImageId "resolve:ssm:/aws/service/ami-windows-latest/Windows_Server-2022-English-Full-Base"

Para obter mais exemplos que usam parâmetros do Systems Manager, consulte Query for the latest Amazon Linux AMI IDs Using AWS Systems Manager Parameter Store e Query for the Latest Windows AMI Using AWS Systems Manager Parameter Store.