Définir des block device mappings

À l’aide de block device mappings, vous pouvez attacher directement des volumes Block Storage Unit (BSU) à une machine virtuelle (VM) lorsque vous la créez 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 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 la VM est terminée

Définir des block device mappings avec OSC CLI

Voir les exemples de commande CreateVms et CreateImage dans la documentation de l’API OUTSCALE.

Définir des block device mappings avec AWS CLI

Pour définir un block device mapping, paramétrez l’attribut block-device-mappings de la commande run-instances ou register-image en 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 ou /dev/xvdXX. 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 : Par défaut ou si paramétré sur true, le volume est supprimé lorsque vous terminez l’instance. Si paramétré sur false, il n’est pas supprimé lorsque vous terminez l’instance.

    • (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 13000 avec un ratio de performance maximum de 300 IOPS par gibioctet.

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

  • (optionnel) NoDevice : 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": ""
   }
]

Pages connexes

Méthodes API correspondantes

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