gcloud beta artifacts docker images describe

NAME
gcloud beta artifacts docker images describe - describe an Artifact Registry container image
SYNOPSIS
gcloud beta artifacts docker images describeIMAGE[--metadata-filter=METADATA_FILTER][--show-all-metadata][--show-build-details][--show-deployment][--show-image-basis][--show-package-vulnerability][--show-provenance][--show-sbom-references][GCLOUD_WIDE_FLAG …]
DESCRIPTION
(BETA) Reference an image by tag or digest using the format:
LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY-ID/IMAGE:tagLOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY-ID/IMAGE@sha256:digest

This command can fail for the following reasons:

  • The repository format is invalid.
  • The specified image does not exist.
  • The active account does not have permission to run the command(roles/artifactregistry.reader,roles/containeranalysis.admin androles/serviceusage.serviceUsageViewer).
EXAMPLES
To describe an image digestabcxyz under imagebusy-box:
gcloudbetaartifactsdockerimagesdescribeus-west1-docker.pkg.dev/my-project/my-repository/busy-box@sha256:abcxyz

To describe an imagebusy-box with tagmy-tag:

gcloudbetaartifactsdockerimagesdescribeus-west1-docker.pkg.dev/my-project/my-repository/busy-box:my-tag
POSITIONAL ARGUMENTS
IMAGE
A container image.

A valid container image has the format ofLOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY-ID/IMAGE

A valid container image that can be referenced by tag or digest, has the formatof LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY-ID/IMAGE:tagLOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY-ID/IMAGE@sha256:digest

FLAGS
--metadata-filter=METADATA_FILTER
Additional filter to fetch metadata for a given qualified image reference.
--show-all-metadata
Include all metadata in the output. Metadata will be grouped by Grafeas kind,with an additional section for intoto provenance metadata.
--show-build-details
Include build metadata in the output.
--show-deployment
Include deployment metadata in the output.
--show-image-basis
Include base image metadata in the output.
--show-package-vulnerability
Include vulnerability metadata in the output.
--show-provenance
Include intoto provenance metadata in the output, in the provenance_summarysection. To see all build metadata in the output, use --show-all-metadata or--show-build-details.
--show-sbom-references
Include SBOM metadata in the output.
GCLOUD WIDE FLAGS
These flags are available to all commands:--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.

Run$gcloud help for details.

NOTES
This command is currently in beta and might change without notice. Thesevariants are also available:
gcloudartifactsdockerimagesdescribe
gcloudalphaartifactsdockerimagesdescribe

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-07-22 UTC.