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-imagesuivant crée une AMI à partir de l’instance spécifiée.aws ec2 create-image \ --instance-idi-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-imagesuivant 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-idi-1234567890abcdef0\ --name"My server"\ --no-rebootSortie :
{ "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-imagesuivant crée une AMI et balise l’AMI et les instantanés avec la même balisecost-center=cc123.aws 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}]"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 $trueExemple 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 $trueExemple 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).
-