Oracle Cloud Infrastructure Documentation

Importing a Custom Image from a URL for a Roving Edge Infrastructure Device

Describes how to import a custom image from an object storage URL for use in launching an instance on your Roving Edge Infrastructure device.

Roving Edge Infrastructure supports importing QCOW2 type images. Roving Edge Infrastructure also supports importing some OCI type images, but in some instances importing an OCI type image fails.

Roving Edge Infrastructure supports importing an image from a Roving Edge Infrastructure source URL and OCI Pre-authenticated request (PAR) URL only. See Using Pre-Authenticated Requests in the Oracle Cloud Infrastructure documentation for more information on this feature.

    1. Open the navigation menu and select Compute > Images. The Custom Images page appears. All custom images are listed in tabular form.
    2. Select Import Image. The Import Image dialog box appears.
    3. Enter a Name for the image.
    4. Select the Operating System:

      • For Linux images, select Linux.

      • For Windows images, select Windows. Select the Operating System Version, and then certify that the selected operating system complies with Microsoft licensing agreements.

    5. Select the Import from an Object Storage URL option.
    6. Enter the URL to the image in the Object Storage URL box.
    7. Select the Image Type option:

      • QCOW2

      • OCI

    8. Select Import Image.

    After you select Import Image, you'll see the imported image in the Custom Images list for the compartment, with a state of Importing. To track the progress of the operation, you can monitor the associated work request.

    When the import completes successfully, the state changes to Available. If the state does not change, or no entry appears in the Custom Images list, the import failed. If the import failed, ensure you have read access to the Object Storage object, and that the object contains a supported image.

  • Use the oci compute image import from-object-uri command and required parameters to import a custom image from a URI for use in launching an instance on your Roving Edge Infrastructure devices:

    oci compute image import from-object-uri --compartment-id compartment_ocid --uri uri --name name [OPTIONS]

    To determine your Roving Edge Infrastructure device compartment OCID, see Compartments.

    Refer to your Roving Edge Infrastructure device's CLI help for a list of parameters available for this command. See Accessing Command Line Interface Help.

    For CLI setup information on your Roving Edge Infrastructure device, see Using the Command Line Interface.

  • Run the CreateImage operation and specify ImageSourceDetails in the request body to import an image from object storage.