- NAME
-
- gcloud alpha container images list-tags - list tags and digests for the specified image
- SYNOPSIS
-
-
gcloud alpha container images list-tags
IMAGE_NAME
[--occurrence-filter
=OCCURRENCE_FILTER
; default='kind = "BUILD" OR kind = "IMAGE" OR kind = "DISCOVERY"'] [--no-show-occurrences
] [--show-occurrences-from
=SHOW_OCCURRENCES_FROM
; default=10] [--filter
=EXPRESSION
] [--limit
=LIMIT
] [--page-size
=PAGE_SIZE
] [--sort-by
=[FIELD
,…]; default="~timestamp"] [GCLOUD_WIDE_FLAG …
]
-
- DESCRIPTION
-
(ALPHA)
The container images list-tags command of gcloud lists metadata about tags and digests for the specified container image. Images must be hosted by the Google Container Registry. - EXAMPLES
-
List the tags in a specified image:
gcloud alpha container images list-tags gcr.io/myproject/myimage
To receive the full, JSON-formatted output (with untruncated digests):
gcloud alpha container images list-tags gcr.io/myproject/myimage --format=json
To list digests without corresponding tags:
gcloud alpha container images list-tags gcr.io/myproject/myimage --filter="NOT tags:*"
To list images that have a tag with the value '30e5504145':
gcloud container images list-tags --filter="'tags:30e5504145'"
The last example encloses the filter expression in single quotes because the value '30e5504145' could be interpreted as a number in scientific notation.
- POSITIONAL ARGUMENTS
-
IMAGE_NAME
- The name of the image to list tags for. The name format should be *.gcr.io/PROJECT_ID/IMAGE_PATH.
- FLAGS
-
--occurrence-filter
=OCCURRENCE_FILTER
; default='kind = "BUILD" OR kind = "IMAGE" OR kind = "DISCOVERY"'- A filter for the Occurrences which will be summarized.
--show-occurrences
-
Whether to show summaries of the various Occurrence types. Enabled by default,
use
--no-show-occurrences
to disable. --show-occurrences-from
=SHOW_OCCURRENCES_FROM
; default=10- How many of the most recent images for which to summarize Occurences.
- LIST COMMAND FLAGS
-
--filter
=EXPRESSION
-
Apply a Boolean filter
EXPRESSION
to each resource item to be listed. If the expression evaluatesTrue
, then that item is listed. For more details and examples of filter expressions, run $ gcloud topic filters. This flag interacts with other flags that are applied in this order:--flatten
,--sort-by
,--filter
,--limit
. --limit
=LIMIT
-
Maximum number of resources to list. The default is
unlimited
. This flag interacts with other flags that are applied in this order:--flatten
,--sort-by
,--filter
,--limit
. --page-size
=PAGE_SIZE
-
Some services group resource list output into pages. This flag specifies the
maximum number of resources per page. The default is determined by the service
if it supports paging, otherwise it is
unlimited
(no paging). Paging may be applied before or after--filter
and--limit
depending on the service. --sort-by
=[FIELD
,…]; default="~timestamp"-
Comma-separated list of resource field key names to sort by. The default order
is ascending. Prefix a field with ``~´´ for descending order on that
field. This flag interacts with other flags that are applied in this order:
--flatten
,--sort-by
,--filter
,--limit
. The default is~timestamp
.
- 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 list-tags
gcloud beta container images list-tags
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-02-06 UTC.
[{
"type": "thumb-down",
"id": "hardToUnderstand",
"label":"Hard to understand"
},{
"type": "thumb-down",
"id": "incorrectInformationOrSampleCode",
"label":"Incorrect information or sample code"
},{
"type": "thumb-down",
"id": "missingTheInformationSamplesINeed",
"label":"Missing the information/samples I need"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Other"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Easy to understand"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Solved my problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Other"
}]
{
"last_modified": "Last updated 2024-02-06 UTC.",
"state": ""
}