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.

When using the CLI and the API, you can use the image OCID or the image URI to identify the image that you want to get information about.

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.

1. On the Container Registry list page, select the repository that you want to work with from the Repositories and images list. If you need help finding the list page or the repository, see Listing Repositories.
  The repository's details section opens.
2. Select the repository in the Repositories and images list a second time.
  The images in the repository, including their version identifiers, are listed under the repository in the Repositories and images list.
3. Select the image you want.
  The image's details section opens.
4. Perform the following tasks to see the image's details:
  
  Select 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.
  
  Select the Layers tab to see the SHA message digest of each layer in the selected image.
  
  Select 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.
  
  Select 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.
  
  Select the Signatures tab to see details of signatures created if the image was signed. For more information, see Signing Images for Security.
  
  Select 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.
5. (Optional) To pull an image, select 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.
For a complete list of flags and variable options for CLI commands, see the Command Line Reference.

Using the image's OCID to get image details:

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...
Using the image's URI to get image details:

Use the oci artifacts container image lookup command and required parameters to get details of an image:
oci artifacts container image lookup --image-uri <image-uri> [OPTIONS]
where image-uri identifies a particular image in a registry, and includes a version identifier, or an image digest, or both. Note that image-uri does not include a registry domain.

For example:
oci artifacts container image lookup --image-uri ansh81vru1zp/project01/acme-web-app:v2.0.test
oci artifacts container image lookup --image-uri ansh81vru1zp/project01/acme-web-app@sha256:abcd1234efgh5678...
oci artifacts container image lookup --image-uri ansh81vru1zp/project01/acme-web-app:v2.0.test@sha256:abcd1234efgh5678...
To use the image's OCID to get image details, run the GetContainerImage operation.

To use the image's URI to get image details, run the LookupContainerImageByUri operation.

Oracle Cloud Infrastructure Documentation

Getting an Image's Details