Referencia de AMI a través de los parámetros de Systems Manager
AWS Systems Manager proporciona parámetros públicos para las AMI públicas mantenidas por AWS. Puede utilizar los parámetros públicos al lanzar instancias para asegurarse de que utiliza las AMI más recientes. Por ejemplo, el parámetro público /aws/service/ami-amazon-linux-latest/al2023-ami-kernel-default-arm64 está disponible en todas las regiones y siempre apunta a la versión más reciente de la AMI Amazon Linux 2023 para la arquitectura arm64 en una región determinada.
Los parámetros públicos están disponibles en las siguientes rutas:
Para obtener más información, consulte Trabajar con parámetros públicos en la Guía del usuario de AWS Systems Manager.
Buscar el parámetro de SSM de una AMI pública
Cuando describe una AMI pública, la respuesta incluye el parámetro asociado de AWS Systems Manager (SSM) en el campo PublicSsmParameterName. Utilice este parámetro para identificar el parámetro de SSM que siempre apunta a la versión más reciente de esa AMI.
- Console
-
Para buscar el parámetro de SSM de una AMI pública
-
Abra la consola de Amazon EC2 en https://console.aws.amazon.com/ec2/.
-
En el panel de navegación, seleccione AMIs.
-
Seleccione una AMI pública.
-
En la pestaña Detalles, busque Nombre del parámetro de SSM público.
- AWS CLI
-
Para buscar el parámetro de SSM de una AMI pública
Utilice el comando describe-images . La respuesta incluye el campo PublicSsmParameterName para las AMI públicas que tienen un parámetro de SSM asociado.
aws ec2 describe-images \
--image-ids ami-0abcdef1234567890
El siguiente resultado de ejemplo muestra el campo PublicSsmParameterName. Se omitieron algunos campos para simplificar el ejemplo.
{
"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
-
Para buscar el parámetro de SSM de una AMI pública
Utilice el cmdlet Get-EC2Image. La respuesta incluye el campo PublicSsmParameterName para las AMI públicas que tienen un parámetro de SSM asociado.
Get-EC2Image -ImageId ami-0abcdef1234567890
El siguiente resultado de ejemplo muestra el campo PublicSsmParameterName. Se omitieron algunos campos para simplificar el ejemplo.
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
Enumeración de las AMI de Amazon Linux
- AWS CLI
-
Enumeración de las AMI de Linux en la región de AWS actual
Use el comando get-parameters-by-path. El valor del parámetro --path es específico para las AMI de Linux.
aws ssm get-parameters-by-path \
--path /aws/service/ami-amazon-linux-latest \
--query "Parameters[].Name"
- PowerShell
-
Enumeración de las AMI de Linux en la región de AWS actual
Use el cmdlet Get-SSMParametersByPath.
Get-SSMParametersByPath `
-Path "/aws/service/ami-amazon-linux-latest" | `
Sort-Object Name | Format-Table Name
Enumeración de las AMI de Windows
- AWS CLI
-
Enumeración de las AMI de Windows en la región de AWS actual
Use el comando get-parameters-by-path. El valor del parámetro --path es específico para las AMI de Windows.
aws ssm get-parameters-by-path \
--path /aws/service/ami-windows-latest \
--query "Parameters[].Name"
- PowerShell
-
Enumeración de las AMI de Windows en la región de AWS actual
Use el cmdlet Get-SSMParametersByPath.
Get-SSMParametersByPath `
-Path "/aws/service/ami-windows-latest" | `
Sort-Object Name | Format-Table Name
Lanzamiento de una instancia con un parámetro público
Para especificar el parámetro público en el lanzamiento de una instancia, use la siguiente sintaxis: resolve:ssm:public-parameter, donde resolve:ssm es el prefijo estándar y public-parameter
- AWS CLI
-
Para iniciar una instancia con un parámetro público
Utilice el comando run-instances con la opción --image-id. En este ejemplo, se utiliza el parámetro público de Systems Manager para el ID de imagen a fin de iniciar una instancia con la AMI de Amazon Linux 2023 más reciente
--image-id resolve:ssm:/aws/service/ami-amazon-linux-latest/al2023-ami-kernel-default-x86_64
- PowerShell
-
Para iniciar una instancia con un parámetro público
Utilice el cmdlet New-EC2Instance con el parámetro -ImageId. En este ejemplo, se utiliza el parámetro público de Systems Manager para el ID de imagen a fin de iniciar una instancia con la AMI de Windows Server 2022 más reciente.
-ImageId "resolve:ssm:/aws/service/ami-windows-latest/Windows_Server-2022-English-Full-Base"
Para obtener más ejemplos de parámetros de Systems Manager, consulte Consulta de los últimos ID de AMI de Amazon Linux mediante el Almacén de parámetros de AWS Systems Manager y Consulta de las últimas AMI de Windows mediante el Almacén de parámetros de AWS Systems Manager.
