Oracle Cloud Infrastructure Documentation

Unversioning an Image

Find out how to unversion an image in Container Registry.

When you want to clean up the list of images in a repository without actually deleting images, you can remove the version identifier from images in Oracle Cloud Infrastructure Registry (also known as Container Registry). Removing version identifiers is referred to as 'unversioning'.

Your permissions control the images in Container Registry that you can unversion (see Policies to Control Repository Access). You can unversion images in repositories you've created, and images in repositories that the groups to which you belong have been granted access by identity policies. If you belong to the Administrators group, you can unversion images in any repository in the tenancy.

    1. On the Container Registry list page, select the repository that you want to work with. If you need help finding the list page or the repository, see Listing Repositories.
    2. On the details page, select the Image versions tab.
      All images in the repository, including their version identifiers, are displayed in a table.
    3. Select the image.
      The details page for the image opens.
    4. Select the Versions tab.
    5. Select Delete from the Actions menu (three dots) beside the image that you want to unversion.
    6. When prompted, confirm the removal of the version identifier.

  • Use the oci artifacts container image remove-version command and required parameters to unversion an image:

    oci artifacts container image remove-version --image-id <image-ocid> --image-version <version> [OPTIONS]
    For example: 
    oci artifacts container image remove-version --image-id ocid1.containerimage.oc1.phx.0.ansh81vru1zp.aaaaaaaalqzjyks... --image-version 1.0

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

  • Run the RemoveContainerVersion operation to unversion an image.