Hay más ejemplos de AWS SDK disponibles en el repositorio de GitHub de ejemplos de AWS SDK de documentos
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-idi-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-idi-1234567890abcdef0\ --name"My server"\ --no-rebootSalida:
{ "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 etiquetacost-center=cc123aws ec2 create-image \ --instance-idi-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 información sobre la API, consulte CreateImage
en la Referencia de comandos de la AWS CLI.
-
- PowerShell
-
- Herramientas para PowerShell V4
-
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 $trueEjemplo 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 versión 3 o posterior de PowerShell.
$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 información sobre la API, consulte CreateImage en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).
-
- Herramientas para PowerShell V5
-
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 $trueEjemplo 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 versión 3 o posterior de PowerShell.
$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 información sobre la API, consulte CreateImage en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V5).
-