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 OMI Within One Region Using Cockpit v1

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.

  1. Click Compute > Outscale Machine Images.

  2. Click the OMI you want to copy.
    The OMI is selected.

  3. Click Copy .
    The COPY OMI dialog box appears.

  4. In the Name field, type the name for the OMI copy.

    This name must be unique and must contain between 3 and 128 Unicode characters.

  5. Click Copy to validate.
    The OMI is copied to your account.

    If you copy a public OMI to your account, your copy is also public.

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.

See the CreateImage command sample in the documentation of the OUTSCALE API.

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.