Utilisation de CreateImage avec une CLI - Exemples de code de kit AWS SDK

D’autres exemples de kits AWS SDK sont disponibles dans le référentiel GitHub AWS Doc SDK Examples.

Utilisation de CreateImage avec une CLI

Les exemples de code suivants illustrent comment utiliser CreateImage.

CLI
AWS CLI

Exemple 1 : pour créer une AMI à partir d’une instance basée sur Amazon EBS

L’exemple create-image suivant crée une AMI à partir de l’instance spécifiée.

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

Sortie :

{ "ImageId": "ami-abcdef01234567890" }

Pour plus d’informations sur la spécification d’un mappage de périphérique de stockage en mode bloc, consultez Spécification d’un mappage de périphérique de stockage en mode bloc pour une AMI dans le Guide de l’utilisateur Amazon EC2.

Exemple 2 : pour créer une AMI à partir d’une instance basée sur Amazon EBS sans redémarrage

L’exemple create-image suivant crée une AMI et définit le paramètre --no-reboot afin que l’instance ne soit pas redémarrée avant la création de l’image.

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

Sortie :

{ "ImageId": "ami-abcdef01234567890" }

Pour plus d’informations sur la spécification d’un mappage de périphérique de stockage en mode bloc, consultez Spécification d’un mappage de périphérique de stockage en mode bloc pour une AMI dans le Guide de l’utilisateur Amazon EC2.

Exemple 3 : pour baliser une AMI et des instantanés lors de leur création

L’exemple create-image suivant crée une AMI et balise l’AMI et les instantanés avec la même balise 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}]"

Sortie :

{ "ImageId": "ami-abcdef01234567890" }

Pour plus d’informations sur le balisage de vos ressources lors de leur création, consultez Ajouter des balises lors de la création de ressources dans le Guide de l’utilisateur Amazon EC2.

  • Pour plus de détails sur l’API, consultez CreateImage dans la Référence des commandes de l’AWS CLI.

PowerShell
Outils pour PowerShell V4

Exemple 1 : cet exemple crée une AMI avec le nom et la description spécifiés, à partir de l’instance spécifiée. Amazon EC2 tente d’arrêter correctement l’instance avant de créer l’image et redémarre l’instance une fois l’opération terminée.

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

Exemple 2 : cet exemple crée une AMI avec le nom et la description spécifiés, à partir de l’instance spécifiée. Amazon EC2 crée l’image sans arrêter ni redémarrer l’instance ; par conséquent, l’intégrité du système de fichiers sur l’image créée ne peut être garantie.

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

Exemple 3 : cet exemple crée une AMI avec trois volumes. Le premier volume est basé sur un instantané Amazon EBS. Le deuxième volume est un volume Amazon EBS vide de 100 GiO. Le troisième volume est un volume de stockage d’instances. La syntaxe utilisée par cet exemple nécessite PowerShell version 3 ou ultérieure.

$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"})
  • Pour plus de détails sur l’API, consultez CreateImage dans la Référence des applets de commande pour les Outils AWS pour PowerShell (V4).

Outils pour PowerShell V5

Exemple 1 : cet exemple crée une AMI avec le nom et la description spécifiés, à partir de l’instance spécifiée. Amazon EC2 tente d’arrêter correctement l’instance avant de créer l’image et redémarre l’instance une fois l’opération terminée.

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

Exemple 2 : cet exemple crée une AMI avec le nom et la description spécifiés, à partir de l’instance spécifiée. Amazon EC2 crée l’image sans arrêter ni redémarrer l’instance ; par conséquent, l’intégrité du système de fichiers sur l’image créée ne peut être garantie.

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

Exemple 3 : cet exemple crée une AMI avec trois volumes. Le premier volume est basé sur un instantané Amazon EBS. Le deuxième volume est un volume Amazon EBS vide de 100 GiO. Le troisième volume est un volume de stockage d’instances. La syntaxe utilisée par cet exemple nécessite PowerShell version 3 ou ultérieure.

$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"})
  • Pour plus de détails sur l’API, consultez CreateImage dans la Référence des applets de commande pour les Outils AWS pour PowerShell (V5).