gcloud_beta_container_images_describe (1)

NAME

gcloud beta container images describe - lists container analysis data for a given image

SYNOPSIS

gcloud beta container images describe IMAGE_NAME [--metadata-filter=METADATA_FILTER] [--show-all-metadata] [--show-build-details] [--show-deployment] [--show-image-basis] [--show-package-vulnerability] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION

(BETA) Lists container analysis data for a valid image.

POSITIONAL ARGUMENTS

IMAGE_NAME

The fully qualified name(s) of image(s) to describe. The name(s) should be formatted as *.gcr.io/PROJECT_ID/IMAGE_PATH@sha256:DIGEST or *.gcr.io/PROJECT_ID/IMAGE_PATH:TAG.

FLAGS

--metadata-filter=METADATA_FILTER

Additional filter to fetch metadata for a given fully qualified image reference.

--show-all-metadata

Include all metadata in the output.

--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.

GCLOUD WIDE FLAGS

These flags are available to all commands: --account, --configuration, --flags-file, --flatten, --format, --help, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity. Run $ gcloud help for details.

EXAMPLES

Describe the specified image:

$ gcloud beta container images describe \
    gcr.io/myproject/myimage@digest
      OR $ gcloud beta container images describe gcr.io/myproject/myimage:tag

Find the digest for a tag:

$ gcloud beta container images describe \
    gcr.io/myproject/myimage:tag \
  --format='value(image_summary.digest)'
      OR $ gcloud beta container images describe \
    gcr.io/myproject/myimage:tag \
  --format='value(image_summary.fully_qualified_digest)'

See package vulnerabilities found by the Container Analysis API for the specified image:

$ gcloud beta container images describe \
    gcr.io/myproject/myimage@digest --show-package-vulnerability

NOTES

This command is currently in BETA and may change without notice. These variants are also available:

$ gcloud container images describe $ gcloud alpha container images describe