Copier une OMI dans la même Région

Vous pouvez copier une image machine OUTSCALE (OMI) dans la même Région que votre compte.

L’OMI source peut soit appartenir à votre compte, soit être une OMI partagée appartenant à un autre compte.

La copie de l’OMI appartient à votre compte, est indépendante de l’OMI source et a son propre ID. Tout snapshot utilisé par l’OMI source est également copié dans votre compte.

Pour copier une OMI située dans une Région différente de celle de votre compte, voir Copier une OMI vers d’autres Régions.

Copier une image dans une même Région avec Cockpit v2

Avant de commencer : Si l’image que vous voulez copier ne vous appartient pas, son propriétaire doit la partager avec vous. Pour en savoir plus, voir Modifier les attributs d’une OMI.

  1. Cliquez dans le dashboard Images pour faire apparaître des cases à cocher.

  2. Cochez la case de l’image que vous voulez copier.
    L’image est sélectionnée et un menu d’actions apparaît.

  3. Cliquez sur IconAddFull Copier.
    La boîte de dialogue COPIER UNE IMAGE apparaît.

  4. Dans le champ Nom, tapez un nom pour la copie de l’image.

    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 [_()/.-].

  5. (optionnel) Dans le champ Description, tapez une description pour la copie de l’image.

  6. Cliquez sur Copier.
    L’image est copiée dans votre compte.

Copier une OMI dans une même Région avec OSC CLI

Avant de commencer : Si l’OMI que vous voulez copier ne vous appartient pas, son propriétaire doit la partager avec vous. Pour en savoir plus, voir Modifier les attributs d’une OMI.

À ce jour, cette section est disponible en anglais uniquement.

The CreateImage command creates an OUTSCALE machine image (OMI).
You can use this method in different ways:

  • Creating from a VM: You create an OMI from one of your virtual machines (VMs).

  • Copying an OMI: You copy an existing OMI. The source OMI can be one of your own OMIs, or an OMI owned by another account that has granted you permission via the UpdateImage method.

  • Registering from a snapshot: You register an OMI from an existing snapshot. The source snapshot can be one of your own snapshots, or a snapshot owned by another account that has granted you permission via the UpdateSnapshot method.

  • Registering from a bucket by using a manifest file: You register an OMI from the manifest file of an OMI that was exported to an OUTSCALE Object Storage (OOS) bucket. First, the owner of the source OMI must export it to the bucket by using the CreateImageExportTask method. Then, they must grant you permission to read the manifest file via a pre-signed URL or Access Control Lists. For more information, see Managing Access to Your Buckets and Objects.

  • Registering from a bucket without using a manifest file: This is similar to the previous case but you manually specify all the information that would be in a manifest file instead of using a manifest file.

Registering from a bucket enables you to copy an OMI across Regions.

For more information, see About OMIs.

Request sample: Copying an OMI
$ osc-cli api CreateImage --profile "default" \
    --ImageName "copy-image-example" \
    --SourceImageId "ami-12345678" \
    --SourceRegionName "eu-west-2"

This command contains the following attributes that you need to specify:

  • Description: (optional) A description for the new OMI.

  • DryRun: (optional) If true, checks whether you have the required permissions to perform the action.

  • ImageName: (optional) A unique name for the new OMI.
    Constraints: 3-128 alphanumeric characters, underscores (_), spaces (` ), parentheses (()), slashes (/), periods (.), or dashes (-`).

  • ProductCodes: (optional) The product codes associated with the OMI.

  • SourceImageId: (optional) (when copying an OMI) The ID of the OMI you want to copy.

  • SourceRegionName: (optional) (when copying an OMI) The name of the source Region (always the same as the Region of your account).

The CreateImage command returns the following elements:

  • Image: Information about the OMI.

  • ResponseContext: Information about the context of the response.

Result sample: Copying an OMI
{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "Image": {
    "StateComment": {},
    "State": "available",
    "RootDeviceType": "bsu",
    "RootDeviceName": "/dev/sda1",
    "ProductCodes": [
      "0001"
    ],
    "PermissionsToLaunch": {
      "GlobalPermission": false,
      "AccountIds": []
    },
    "AccountId": "123456789012",
    "Tags": [],
    "Description": "",
    "ImageId": "ami-12345678",
    "BlockDeviceMappings": [
      {
        "DeviceName": "/dev/sda1",
        "Bsu": {
          "VolumeType": "standard",
          "DeleteOnVmDeletion": true,
          "VolumeSize": 50,
          "SnapshotId": "snap-12345678"
        }
      }
    ],
    "ImageType": "machine",
    "CreationDate": "2010-10-01T12:34:56.789Z",
    "FileLocation": "123456789012/copy-image-example",
    "Architecture": "x86_64",
    "ImageName": "copy-image-example"
  }
}

Copier une OMI dans une même Région avec AWS CLI

Avant de commencer : Si l’OMI que vous voulez copier ne vous appartient pas, son propriétaire doit la partager avec vous. Pour en savoir plus, voir Modifier les attributs d’une OMI.

Pour copier une OMI dans votre compte, utilisez la commande copy-image en suivant cette syntaxe :

Requête
$ aws ec2 copy-image \
    --profile YOUR_PROFILE \
    --source-region eu-west-2 \
    --source-image-id ami-12345678 \
    --name OMI_name \
    --description Description of the OMI \
    --endpoint https://fcu.eu-west-2.outscale.com

Cette commande contient les attributs suivants que vous devez spécifier :

  • (optionnel) profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.

  • source-region : Le nom de la Région source, qui doit être la même que la Région de votre compte.

  • source-image-id : L’ID de l’OMI que vous voulez copier.

  • name : Le nom de la copie de l’OMI.

    Ce nom doit être unique et peut contenir n’importe quel caractère Unicode, sans limite de longueur.

    Toutefois, si vous spécifiez explicitement une chaîne vide, le nom de l’OMI source est utilisé.

  • (optionnel) description : Une description pour la copie de l’OMI (par défaut, la même description que l’OMI source).

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

  • endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête.

La commande copy-image renvoie l’élément suivant :

  • ImageId : L’ID de la nouvelle OMI.

Résultat
{
    "ImageId": "ami-87654321"
}

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.