Oracle Cloud Infrastructure Documentation

Importing an Image from a URL

On Compute Cloud@Customer, you can import an image into a compartment by specifying the URL of the image file.

Alternatively, you can import an image from an Object Storage bucket as described in Importing an Image from an Object Storage Bucket.

Before You Begin

Get the URL that you need for this procedure. Ensure that the URL is accessible from your tenancy.

    1. In the Compute Cloud@Customer Console navigation menu, click Compute, then click Custom Images.

    2. On the Custom Images page, click Import Image.

    3. In the Import Image dialog box, enter the following information:

      • Name: Enter a descriptive name for the image.

        Avoid entering confidential information.

      • Create in Compartment: Select the compartment where the image will be placed.

      • Source Type: Select the Import from an Object Storage URL option.

      • Object Storage URL: Enter the URL of the image. The URL does not need to be an Object Storage URL. It can be any URL that provides access to the image.

      • Image Type: Select one of the following options based on the type of image you are importing.

        • VMDK: Virtual machine disk file format (.vmdk), used for virtual machine disk images.

        • QCOW2: For disk image files (.qcow2) used by QEMU copy on write.

        • OCI: For Oracle Cloud Infrastructure files with a QCOW2 image and OCI metadata (.oci).

      • Launch Mode: Paravirtualized is the default and can't be changed.

      • Tagging: (Optional) Add one or more tags to this resource. Tags can also be applied later. For more information about tagging resources, see Resource Tags.

    4. Click Import Image.

      The imported image appears in the Custom Images list for the compartment, with a state of Importing. To track the progress of the operation, view the associated work request.

      When the import completes successfully, the image state changes to Available, and the image can be used to create instances as described in Creating an Instance.

  • Use the oci compute image import from-object-uri command and required parameters to import an image from a URL.

    oci compute image import from-object-uri --compartment-id compartment_OCID --uri URL_for_image[OPTIONS]
    Important

    If you are importing a Microsoft Windows image, specify the --operating-system option and include the case-insensitive string "Windows" in the value to ensure optimal performance of the instance.

    If you specify the --operating-system option and this is not a Microsoft Windows image, make sure the value does not contain the case-insensitive string "Windows".

    For a complete list of CLI commands, flags, and options, see the Command Line Reference.

  • This operation can't be performed using the API.

    For information about using the API and signing requests, see REST APIs and Security Credentials. For information about SDKs, see Software Development Kits and Command Line Interface.