Référence des fichiers manifestes

Un fichier manifeste est un fichier qui est nécessaire pour importer une image machine OUTSCALE (OMI) depuis un bucket OUTSCALE Object Storage (OOS). Pour en savoir plus, voir Copier une OMI vers d’autres Régions.

Un fichier manifeste peut être créé de deux façons :

  • Automatiquement : Lorsque vous pouvez exportez une OMI vers un bucket via Cockpit ou la méthode API CreateImageExportTask, le fichier manifeste et toutes les snapshots nécessaires sont automatiquement créés directement dans le bucket.

  • Manuellement : Vous pouvez aussi manuellement rédiger le fichier manifeste correspondant à l’OMI, puis le déposer manuellement ainsi que toutes les snapshots nécessaires dans le bucket, mais cela requiert davantages d’étapes.

Une fois que le fichier manifeste existe dans le bucket, l’OMI peut être importée.

Pour rédiger manuellement un fichier manifeste, vous devez créer un fichier JSON en suivant cette structure :

Exemple de fichier manifeste
{
  "Version": 1,
  "Image": {
    "Name": "image-example",
    "Description": "",
    "Architecture": "x86_64",
    "Type": "machine",
    "ProductTypes": [
      "0001"
    ],
    "Public": false,
    "Snapshots": [
      {
        "DeleteOnTermination": false,
        "Device": "/dev/sda1",
        "Filename": "snap-11111111-aaaaaaaa.qcow2.gz",
        "Iops": null,
        "PreSignedUrl": "https://oos.eu-west-2.outscale.com/<BUCKET>/snap-11111111-aaaaaaaa.qcow2.gz?<...>",
        "Size": 10737418240,
        "VolumeType": "standard"
      },
      {
        "DeleteOnTermination": false,
        "Device": "/dev/sda2",
        "Filename": "snap-22222222-aaaaaaaa.qcow2.gz",
        "Iops": null,
        "PreSignedUrl": "https://oos.eu-west-2.outscale.com/<BUCKET>/snap-22222222-aaaaaaaa.qcow2.gz?<...>",
        "Size": 21474836480,
        "VolumeType": "standard"
      }
    ]
  }
}

Ce fichier contient les attributs suivants :

Attribute Required Description

Version

Oui

La version du fichier manifeste (toujours 1).

Image

Oui

Informations à propos de l’OMI que vous voulez exporter.

Name

Non

Le nom de l’OMI.

Ce nom doit être unique et doit contenir entre 3 et 128 caractères. Les caractères autorisés sont a-z, A-Z, 0-9, l’espace et [_()/.-].

Description

Non

Une description pour l’OMI.

Cette description peut contenir n’importe quel caractère Unicode, sans limite de longueur.

Architecture

Non

L’architecture de l’OMI (i386 ou x86_64).

Type

Non

Le type d’OMI (toujours machine).

ProductTypes

Oui

Les codes produit associés à l’OMI.

Public

Non

Si l’OMI est publique ou privée.

Snapshots

Oui

Informations à propos des snapshots associés à l’OMI.

DeleteOnTermination

Non

Si true, le volume est supprimé quand la VM est terminée. Si false, le snapshot n’est pas supprimé quand la VM est terminée.

Device

Oui

Le nom de périphérique du volume. Pour un volume système, vous devez utiliser /dev/sda1. Pour d’autres volumes, vous devez utiliser /dev/sdX, /dev/sdXX, /dev/xvdX, ou /dev/xvdXX (où le premier X est une lettre entre b et z, et le second X est une lettre entre a et z).

Filename

Oui

Le nom de fichier du snapshot dans le bucket.

Iops

Non

Le nombre d’opérations de lecture/écriture par seconde (IOPS) (uniquement pour les volumes io1). Le nombre maxium d’IOPS autorisé est de 13000 avec un ratio de performance maximum de 300 IOPS par gibioctet.

PreSignedUrl

Oui

L’URL pré-signée du fichier du snapshot. Pour en savoir plus, voir Créer une URL pré-signée.

Size

Oui

La taille du snapshot décompressé, en octets.

VolumeType

Non

Le type de volume (standard | gp2 | io1). Pour en savoir plus, voir À propos des volumes > Types de volumes et IOPS.

Pages connexes

Exporter en PDF