# 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](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-public-parameters.html) 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/](https://console.aws.amazon.com/ec2/).
1. No painel de navegação, selecione **AMIs**.
1. Selecione uma AMI pública.
1. 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](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-images.html). 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](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2Image.html). 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](https://docs.aws.amazon.com/cli/latest/reference/ssm/get-parameters-by-path.html). 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](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-SSMParametersByPath.html).
```
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](https://docs.aws.amazon.com/cli/latest/reference/ssm/get-parameters-by-path.html). 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](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-SSMParametersByPath.html).
```
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](https://docs.aws.amazon.com/cli/latest/reference/ec2/run-instances.html) 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](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2Instance.html) 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](https://aws.amazon.com/blogs/compute/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](https://aws.amazon.com/blogs/mt/query-for-the-latest-windows-ami-using-systems-manager-parameter-store/).