À l'aide de block device mappings, vous pouvez attacher directement des volumes Block Storage Unit (BSU) à une instance lorsque vous la lancez grâce au block device mapping de l'OMI utilisée ou créer une OMI depuis un snapshot.

Le block device mapping vous permet de :

  • Définir le nom du périphérique (/dev/sdx) pour le volume BSU
  • Empêcher un volume BSU défini par l'OMI d'être affecté à un nom de périphérique
  • Spécifier si un volume BSU est créé à partir d'un snapshot ou à partir de rien, et si le volume est supprimé ou détaché lorsque l'instance est terminée

Cette fonctionnalité n'est pas disponible depuis Cockpit. Cette documentation décrit uniquement la procédure à l'aide d'AWS CLI. 
  • Pour définir un block device mapping, paramétrez l'attribut block-device-mappings de la commande run-instances ou register-image suivant cette syntaxe :

      {
        "DeviceName": "string",
        "Ebs": {
          "SnapshotId": "string",
          "VolumeSize": integer,
          "DeleteOnTermination": true or false,
          "VolumeType": "standard",
          "Iops": integer,
        },
        "NoDevice": "string"
      }

    Vous pouvez paramétrer cet attribut soit directement dans la commande, soit via un fichier texte (en spécifiant file://MAP_PATH, où MAP_PATH est le chemin de votre fichier définissant le block device mapping).

    Cet attribut contient les éléments suivants que vous devez spécifier :

    • DeviceName : Le nom de périphérique associé au volume.

      Le nom de périphérique utilisé pour le volume système doit être /dev/sda1. Pour tout autre volume, vous devez utiliser un nom de périphérique au format /dev/xvdX. Pour en savoir plus, voir À propos des volumes > Attachement des volumes et noms de périphériques.

    • (optionnel) Ebs : Informations pour affecter un volume à DeviceName. Cet élément requiert les informations suivantes :
      • (optionnel) SnapshotId : L'ID d'un snapshot si vous voulez créer un volume à partir d'un snapshot.
      • (optionnel) VolumeSize : La taille du volume à créer, en gibioctets (Gio).

        - Si vous spécifiez un ID de snapshot, la taille du volume doit être au moins égale à la taille du snapshot.

        - Si vous spécifiez un ID de snapshot mais aucune taille de volume, le volume est créé avec une taille similaire à celle du snapshot.

      • (optionnel) DeleteOnTermination : Si paramétré sur true, le volume est supprimé lorsque vous terminez l'instance à laquelle il est attaché. Si paramétré sur false, il est détaché. Par défaut, le volume système d'une instance est supprimé et les autres volumes sont détachés.

      • (optionnel) VolumeType : Le type de volume (standard | gp2 | io1). Pour en savoir plus, voir À propos des volumes > Types de volumes et IOPS. Par défaut, un volume standard est créé.

      • (optionnel) Iops : Le nombre d'IOPS.


        Le nombre maximal d'IOPS autorisé pour les volumes io1 est 13 000.


        Vous devez spécifier ce paramètre uniquement lorsque vous créez un volume io1.

    • (optionnel) NoDevi ce : Empêche un volume d'être affecté à DeviceName, si l'OMI utilisée en définit un pour DeviceName.

      Pour utiliser ce paramètre, spécifiez n'importe quelle valeur autre que nulle, par exemple une chaîne de texte vide ("").



    Dans l'exemple suivant, les block device mappings :
    • Attachent un volume créé à partir du snapshot snap-123456789, associé à /dev/xvdb
    • Attachent un volume Magnetic vide d'une taille de 100 Gio, associé à /dev/xvdc et qui est supprimé lorsque l'instance est terminée
    • Empêchent un volume défini par l'OMI d'être affecté à /dev/xvde au lancement de l'instance
    Exemple de block device mappings
    [
       {
        "DeviceName": "/dev/xvdb",
        "Ebs": {
                "SnapshotId": "snap-123456789"
               }
        },
       {
        "DeviceName": "/dev/xvdc",
        "Ebs": {
                "VolumeSize": 100,
                "DeleteOnTermination": true
               }
        },
       {
        "DeviceName": "/dev/xvde", 
        "NoDevice": ""
       }
    ]


Méthodes API correspondantes


Windows® est une marque déposée de Microsoft Corporation aux Etats-Unis et/ou dans les autres pays.

AWS™ et Amazon Web Services™ sont des marques de commerce d'Amazon Technologies, Inc. ou de ses affiliées aux Etats-Unis et/ou dans les autres pays.

Voir Mentions légales.