NAME

gcloud artifacts docker images describe - describe an Artifact Registry container image

SYNOPSIS

gcloud artifacts docker images describe IMAGE [--metadata-filter=METADATA_FILTER] [--show-all-metadata] [--show-build-details] [--show-deployment] [--show-image-basis] [--show-package-vulnerability] [--show-provenance] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION

Reference an image by tag or digest using the format:

LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY-ID/IMAGE:tag LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY-ID/IMAGE@sha256:digest

This command can fail for the following reasons:

EXAMPLES

To describe an image digest abcxyz under image busy-box:

$ gcloud artifacts docker images describe \ us-west1-docker.pkg.dev/my-project/my-repository/\ busy-box@sha256:abcxyz

To describe an image busy-box with tag my-tag:

$ gcloud artifacts docker images describe \ us-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 of LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY-ID/IMAGE

A valid container image that can be referenced by tag or digest, has the format of LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY-ID/IMAGE:tag LOCATION-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_summary section. To see all build metadata in the output, use --show-all-metadata or --show-build-details.

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

These variants are also available:

$ gcloud alpha artifacts docker images describe

$ gcloud beta artifacts docker images describe