1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-11 23:49:35 +00:00
gcloud-help/gcloud/alpha/container/images/describe
2022-03-01 21:43:54 +00:00

85 lines
2.7 KiB
Text

NAME
gcloud alpha container images describe - lists container analysis data for
a given image
SYNOPSIS
gcloud alpha 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
(ALPHA) Lists container analysis data for a valid image.
EXAMPLES
Describe the specified image:
$ gcloud alpha container images describe \
gcr.io/myproject/myimage@digest
Or:
$ gcloud alpha container images describe gcr.io/myproject/myimage:tag
Find the digest for a tag:
$ gcloud alpha container images describe \
gcr.io/myproject/myimage:tag \
--format="value(image_summary.digest)"
Or:
$ gcloud alpha 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 alpha container images describe \
gcr.io/myproject/myimage@digest --show-package-vulnerability
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: --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 alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist. These variants are also available:
$ gcloud container images describe
$ gcloud beta container images describe