gcloud alpha artifacts docker images describe - describe an Artifact Registry container image
gcloud alpha 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 ...]
(ALPHA) 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:
The repository format is invalid.
The specified image does not exist.
The active account does not have permission to view images.
To describe an image digest abcxyz under image busy-box:
$ gcloud alpha 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 alpha artifacts docker images describe \ us-west1-docker.pkg.dev/my-project/my-repository/busy-box:my-tag
- 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
- --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.
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.
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 artifacts docker images describe
$ gcloud beta artifacts docker images describe