Oracle Cloud Infrastructure Documentation

Getting an Image's Details

Find out how to get details of an image in a repository in Container Registry.

To make sure you pull the correct image or to identify images that you no longer need, you can get detailed information about the images in Container Registry.

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

  • To get details of an image in Container Registry using the Console:

    1. Open the navigation menu and click Developer Services. Under Containers & Artifacts, click Container Registry.
    2. Select the region that contains the registry.

    3. Select the compartment that contains the image.

      The Repositories and images field lists the repositories in the selected region and compartment to which you have access.

    4. Click the plus (+) button beside the name of the repository that contains the images you want to get detailed information about.

      Below the name of the repository, the images in the repository are listed, identified by the version identifier of each image.

    5. From the list, select the image for which you want to see detailed information, as follows:

      • Display the Image information tab to see the size of the image, when it was pushed and by which user, and the number of times the image has been pulled.
      • Display the Layers tab to see the SHA message digest of each layer in the selected image.
      • Display the Versions tab to see the full path for the image with the version identifier you select. Note that if you select a different version identifier, the summary details change accordingly.
      • Display the Tags tab to see the free-form tags and defined tags applied to the image. For more information, see Applying Free-form Tags and Defined Tags to Repositories, Images, and Image Signatures.
      • Display the Signatures tab to see details of signature(s) created if the image was signed. For more information, see Signing Images for Security.
      • Display the Scan Results tab to see a summary of each scan of the image for the last 13 months. For more information, see Scanning Images for Vulnerabilities.

    6. (Optional) If you want to pull an image, click Copy pull command. The command you copy includes the fully qualified path to the image's location in Container Registry, in the format <registry-domain>/<tenancy-namespace>/<repo-name>:<version>. For example, docker pull ocir.us-ashburn-1.oci.oraclecloud.com/ansh81vru1zp/project01/acme-web-app:v2.0.test. See Pulling Images Using the Docker CLI.

  • Use the oci artifacts container image get command and required parameters to get details of an image:

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

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

  • Run the GetContainerImage operation to get image details.