Copying an OMI Within One Region

You can copy an OUTSCALE machine image (OMI) within the same Region as your account.

The source OMI can belong to your account, or it can be a shared OMI belonging to another account.

The copy of the OMI belongs to your account, is independent from the source OMI, and gets its own ID. Any snapshot used by the source OMI is also copied to your account.

To copy an OMI located in a different Region than your account, see Copying an OMI Across Regions.

Copying an Image Within One Region Using Cockpit v2

Before you begin: If the image you want to copy does not belong to you, its owner must share it with you. For more information, see Modifying the Attributes of an OMI.

  1. Click inside the Images dashboard to make checkboxes appear.

  2. Check the box of the image you want to copy.
    The image is selected and an action menu appears.

  3. Click IconAddFull Copy.
    The COPY IMAGE dialog box appears.

  4. In the Name field, type a name for the image copy.

    This name must be unique and must contain between 3 and 128 characters. Allowed characters are a-z, A-Z, 0-9, spaces, and [_()/.-].

  5. (optional) In the Description field, type a description for the image copy.

  6. Click Copy.
    The image is copied to your account.

Copying an OMI Within One Region Using OSC CLI

Before you begin: If the OMI you want to copy does not belong to you, its owner must share it with you. For more information, see Modifying the Attributes of an OMI.

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"
  }
}

Copying an OMI Within One Region Using AWS CLI

Before you begin: If the OMI you want to copy does not belong to you, its owner must share it with you. For more information, see Modifying the Attributes of an OMI.

To copy an OMI to your account, use the copy-image command following this syntax:

Request sample
$ 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

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

  • (optional) profile: The named profile you want to use, created when configuring AWS CLI. For more information, see Installing and Configuring AWS CLI.

  • source-region: The name of the source Region, which must be the same as the Region of your account.

  • source-image-id: The ID of the OMI you want to copy.

  • name: The name for the OMI copy.

    This name must be unique and can contain any Unicode character, with no length limit.

    However, if you explicitly specify an empty string, the name of the source OMI is reused.

  • (optional) description: A description for the OMI copy (by default, the same description as the source OMI).

    This description can contain any Unicode character, with no length limit.

  • endpoint: The endpoint corresponding to the Region you want to send the request to.

The copy-image command returns the following element:

  • ImageId: The ID of the new OMI.

Result sample
{
    "ImageId": "ami-87654321"
}

Related Pages

Corresponding API Methods

AWS™ and Amazon Web Services™ are trademarks of Amazon Technologies, Inc or its affiliates in the United States and/or other countries.