- NAME
-
- gcloud alpha artifacts docker images describe - describe an Artifact Registry container image
- SYNOPSIS
-
-
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
] [--show-sbom-references
] [GCLOUD_WIDE_FLAG …
]
-
- DESCRIPTION
-
(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 run the command
(
roles/artifactregistry.reader
,roles/containeranalysis.admin
androles/serviceusage.serviceUsageViewer
).
- EXAMPLES
-
To describe an image digest
abcxyz
under imagebusy-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 tagmy-tag
:gcloud alpha 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.
--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 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
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-09-04 UTC.