Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Ajouter des mappages de périphériques en mode bloc à une AMI
Chaque AMI comporte un mappage de périphérique de stockage en mode bloc qui spécifie les périphériques de stockage en mode bloc à attacher à une instance lancée à partir de l’AMI. Pour ajouter d’autres périphériques de stockage en mode bloc à une AMI, vous devez créer votre propre AMI.
**Topics**
+ [Spécifier un mappage de périphérique de stockage en mode bloc pour une AMI](#create-ami-bdm)
+ [Afficher les volumes EBS dans un mappage de périphérique de stockage en mode bloc d’une AMI](#view-ami-bdm)
## Spécifier un mappage de périphérique de stockage en mode bloc pour une AMI
Lorsque vous créez une AMI, il existe deux façons de spécifier des volumes en plus du volume racine. Si vous avez déjà attaché des volumes à une instance en cours d’exécution avant de créer une AMI à partir de l’instance, le mappage de périphérique de stockage en mode bloc pour l’AMI comprend ces mêmes volumes. Pour les volumes EBS, les données existantes sont enregistrées dans un nouvel instantané. C’est ce nouvel instantané qui est spécifié dans le mappage de périphérique de stockage en mode bloc. Pour les volumes de stockage d’instance, les données ne sont pas conservées.
Pour une AMI basée sur des volumes EBS, vous pouvez ajouter des volumes EBS et des volumes de stockage d’instance à l’aide d’un mappage de périphérique de stockage en mode bloc. Pour une AMI basée sur Amazon S3, vous pouvez ajouter des volumes de stockage d’instances uniquement en modifiant les entrées du mappage de périphérique de stockage en mode bloc dans le fichier manifest des images lors de l’enregistrement de l’image.
**Note**
Pour les instances M3, vous devez spécifier les volumes de stockage d’instance dans le mappage de périphérique de stockage en mode bloc de l’instance lorsque cette dernière est lancée. Lorsque vous lancez une instance M3, les volumes de stockage d’instance spécifiés dans le mappage de périphérique de stockage en mode bloc de l’AMI peuvent être ignorés s’ils ne sont pas spécifiés dans le cadre du mappage de périphérique de stockage en mode bloc de l’instance.
------
#### [ Console ]
**Pour ajouter des volumes à une AMI**
1. Ouvrez la console Amazon EC2.
1. Dans le panneau de navigation, choisissez **Instances**.
1. Sélectionnez une instance, puis **Actions**, **Image and templates (Image et modèles)**, **Create image (Créer une image)**.
1. Saisissez un nom et une description pour l’image.
1. Les volumes d’instance apparaissent sous **Instance volumes (Volumes d’instance)**. Pour ajouter un autre volume, sélectionnez **Add volume (Ajouter un volume)**.
1. Pour **Volume type (Type de volume)**, sélectionnez le type de volume. Pour **Device (Périphérique)**, sélectionnez le nom du périphérique. Pour un volume EBS, vous pouvez spécifier des informations supplémentaires, telles qu’un instantané, la taille du volume, le type de volume, les IOPS et l’état de chiffrement.
1. Choisissez **Create image (Créer une image)**.
------
#### [ AWS CLI ]
**Pour ajouter des volumes à une AMI**
Utilisez la commande [create-image](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-image.html) pour spécifier un mappage de périphérique de stockage en mode bloc pour une AMI basée sur EBS. Utilisez la commande [register-image](https://docs.aws.amazon.com/cli/latest/reference/ec2/register-image.html) afin de spécifier un mappage de périphérique de stockage en mode bloc pour une AMI basée sur Amazon S3.
Spécifiez le mappage de périphérique de stockage en mode bloc à l’aide du paramètre `--block-device-mappings`. Vous pouvez spécifier des arguments encodés en JSON directement depuis la ligne de commande ou en faisant référence à un fichier JSON, comme indiqué ici.
```
--block-device-mappings file://mapping.json
```
Pour ajouter un volume de stockage d’instance, utilisez le mappage suivant : Notez que les volumes de stockage d' NVMeinstance sont ajoutés automatiquement.
```
{
"DeviceName": "device_name",
"VirtualName": "ephemeral0"
}
```
Pour ajouter un volume vide de 100 Gio, utilisez le mappage suivant :
```
{
"DeviceName": "device_name",
"Ebs": {
"VolumeSize": 100
}
}
```
Pour ajouter un volume EBS basé sur un instantané, utilisez le mappage suivant :
```
{
"DeviceName": "device_name",
"Ebs": {
"SnapshotId": "snap-1234567890abcdef0"
}
}
```
Pour omettre un mappage pour un périphérique, utilisez le mappage suivant :
```
{
"DeviceName": "device_name",
"NoDevice": ""
}
```
------
#### [ PowerShell ]
Utilisez l'[New-EC2Image](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2Image.html)applet de commande pour spécifier un mappage de périphériques en mode bloc pour une AMI basée sur EBS. Utilisez l'[Register-EC2Image](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-EC2Image.html)applet de commande pour spécifier un mappage de périphériques en mode bloc pour une AMI basée sur Amazon S3.
Ajoutez l’option `-BlockDeviceMapping` en spécifiant les mises à jour dans `bdm` :
```
-BlockDeviceMapping $bdm
```
Le mappage suivant ajoute un volume basé sur un instantané.
```
$ebd = New-Object -TypeName Amazon.EC2.Model.EbsBlockDevice
$ebd.SnapshotId = "snap-1234567890abcdef0"
$bdm = New-Object -TypeName Amazon.EC2.Model.BlockDeviceMapping
$bdm.DeviceName = "device_name"
$bdm.Ebs = $ebd
```
Le mappage suivant ajoute un volume vide de 100 Go.
```
$ebd = New-Object -TypeName Amazon.EC2.Model.EbsBlockDevice
$ebd.VolumeSize = 100
$bdm = New-Object -TypeName Amazon.EC2.Model.BlockDeviceMapping
$bdm.DeviceName = "device_name"
$bdm.Ebs = $ebd
```
------
## Afficher les volumes EBS dans un mappage de périphérique de stockage en mode bloc d’une AMI
Vous pouvez facilement énumérer les volumes EBS du mappage de périphérique de stockage en mode bloc pour une AMI.
------
#### [ Console ]
**Pour afficher les volumes EBS pour une AMI**
1. Ouvrez la console Amazon EC2.
1. Dans le panneau de navigation, sélectionnez **AMIs**.
1. Choisissez **les images EBS** dans la liste des **filtres** pour obtenir une liste des images soutenues par AMIs EBS.
1. Sélectionnez l’AMI souhaitée et consultez l’onglet **Details**. Au minimum, les informations suivantes sont disponibles pour le volume racine (où le terme **périphérique racine** est équivalent à **volume racine**) :
+ **Type de périphérique racine** (`ebs`)
+ **Nom du périphérique racine** (par exemple, `/dev/sda1`)
+ **Block Devices** (par exemple, `/dev/sda1=snap-1234567890abcdef0:8:true`)
Si l’AMI a été créée avec des volumes EBS supplémentaires à l’aide d’un mappage de périphérique de stockage en mode bloc, le champ **Block Devices** affiche également le mappage pour ces volumes supplémentaires. Notez que cet écran n’affiche pas les volumes de stockage d’instance.
------
#### [ AWS CLI ]
**Pour afficher les volumes EBS pour une AMI**
Utilisez la commande [describe-images](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-images.html).
```
aws ec2 describe-images \
--image-ids ami-0abcdef1234567890 \
--query Image[0].BlockDeviceMappings
```
------
#### [ PowerShell ]
**Pour afficher les volumes EBS pour une AMI**
Utilisez l’applet de commande [Get-EC2Image](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2Image.html).
```
(Get-EC2Image -ImageId ami-0abcdef1234567890).BlockDeviceMappings
```
------