Utilizar CreateImage con una CLI - Amazon Elastic Compute Cloud

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Utilizar CreateImage con una CLI

Los siguientes ejemplos de código muestran cómo utilizar CreateImage.

CLI
AWS CLI

Ejemplo 1: creación de una AMI a partir de una instancia con respaldo de Amazon EBS

En el siguiente ejemplo de create-image, se crea una AMI a partir de la instancia especificada.

aws ec2 create-image \ --instance-id i-1234567890abcdef0 \ --name "My server" \ --description "An AMI for my server"

Salida:

{ "ImageId": "ami-abcdef01234567890" }

Para obtener más información sobre cómo especificar una asignación de dispositivos de bloques para la AMI, consulte Asignaciones de dispositivos de bloques para volúmenes en instancias de Amazon EC2 en la Guía del usuario de Amazon EC2.

Ejemplo 2: creación de una AMI a partir de una instancia con respaldo de Amazon EBS sin reinicio

En el siguiente ejemplo de create-image, se crea una AMI y se establece el parámetro --no-reboot para que la instancia no se reinicie antes de crear la imagen.

aws ec2 create-image \ --instance-id i-1234567890abcdef0 \ --name "My server" \ --no-reboot

Salida:

{ "ImageId": "ami-abcdef01234567890" }

Para obtener más información sobre cómo especificar una asignación de dispositivos de bloques para la AMI, consulte Asignaciones de dispositivos de bloques para volúmenes en instancias de Amazon EC2 en la Guía del usuario de Amazon EC2.

Ejemplo 3: etiquetado de una AMI y de las instantáneas al crearlas

En el siguiente ejemplo de create-image, se crea una AMI y se etiquetan la propia AMI y las instantáneas con la misma etiqueta cost-center=cc123

aws ec2 create-image \ --instance-id i-1234567890abcdef0 \ --name "My server" \ --tag-specifications "ResourceType=image,Tags=[{Key=cost-center,Value=cc123}]" "ResourceType=snapshot,Tags=[{Key=cost-center,Value=cc123}]"

Salida:

{ "ImageId": "ami-abcdef01234567890" }

Para obtener más información sobre cómo etiquetar los recursos al crearlos, consulte Etiquetar los recursos en la Guía del usuario de Amazon EC2.

  • Para obtener más información sobre la API, consulte CreateImagela Referencia de AWS CLI comandos.

PowerShell
Herramientas para la PowerShell versión 4

Ejemplo 1: En este ejemplo se crea una AMI con el nombre y la descripción especificados desde la instancia especificada. Amazon EC2 intenta cerrar la instancia de forma limpia antes de crear la imagen y la reinicia una vez finalizada.

New-EC2Image -InstanceId i-12345678 -Name "my-web-server" -Description "My web server AMI"

Ejemplo 2: En este ejemplo se crea una AMI con el nombre y la descripción especificados desde la instancia especificada. Amazon EC2 crea la imagen sin cerrar ni reiniciar la instancia; por lo tanto, no se puede garantizar la integridad del sistema de archivos de la imagen creada.

New-EC2Image -InstanceId i-12345678 -Name "my-web-server" -Description "My web server AMI" -NoReboot $true

Ejemplo 3: En este ejemplo se crea una AMI con tres volúmenes. El primer volumen se basa en una instantánea de Amazon EBS. El segundo volumen es un volumen de Amazon EBS vacío de 100 GiB. El tercer volumen es un volumen de almacén de instancias. La sintaxis utilizada en este ejemplo requiere PowerShell la versión 3 o superior.

$ebsBlock1 = @{SnapshotId="snap-1a2b3c4d"} $ebsBlock2 = @{VolumeSize=100} New-EC2Image -InstanceId i-12345678 -Name "my-web-server" -Description "My web server AMI" -BlockDeviceMapping @( @{DeviceName="/dev/sdf";Ebs=$ebsBlock1}, @{DeviceName="/dev/sdg";Ebs=$ebsBlock2}, @{DeviceName="/dev/sdc";VirtualName="ephemeral0"})
Herramientas para la versión 5 PowerShell

Ejemplo 1: En este ejemplo se crea una AMI con el nombre y la descripción especificados desde la instancia especificada. Amazon EC2 intenta cerrar la instancia de forma limpia antes de crear la imagen y la reinicia una vez finalizada.

New-EC2Image -InstanceId i-12345678 -Name "my-web-server" -Description "My web server AMI"

Ejemplo 2: En este ejemplo se crea una AMI con el nombre y la descripción especificados desde la instancia especificada. Amazon EC2 crea la imagen sin cerrar ni reiniciar la instancia; por lo tanto, no se puede garantizar la integridad del sistema de archivos de la imagen creada.

New-EC2Image -InstanceId i-12345678 -Name "my-web-server" -Description "My web server AMI" -NoReboot $true

Ejemplo 3: En este ejemplo se crea una AMI con tres volúmenes. El primer volumen se basa en una instantánea de Amazon EBS. El segundo volumen es un volumen de Amazon EBS vacío de 100 GiB. El tercer volumen es un volumen de almacén de instancias. La sintaxis utilizada en este ejemplo requiere la PowerShell versión 3 o superior.

$ebsBlock1 = @{SnapshotId="snap-1a2b3c4d"} $ebsBlock2 = @{VolumeSize=100} New-EC2Image -InstanceId i-12345678 -Name "my-web-server" -Description "My web server AMI" -BlockDeviceMapping @( @{DeviceName="/dev/sdf";Ebs=$ebsBlock1}, @{DeviceName="/dev/sdg";Ebs=$ebsBlock2}, @{DeviceName="/dev/sdc";VirtualName="ephemeral0"})

Para obtener una lista completa de guías para desarrolladores del AWS SDK y ejemplos de código, consulte. Creación de recursos de Amazon EC2 mediante una AWS SDK En este tema también se incluye información sobre cómo comenzar a utilizar el SDK y detalles sobre sus versiones anteriores.