gcloud: Wed Sep 11 09:52:17 UTC 2024

gcloud/artifacts/versions/list

@@ -2,71 +2,112 @@ NAME
     gcloud artifacts versions list - list Artifact Registry package versions
 
 SYNOPSIS
-    gcloud artifacts versions list
-        (--package=PACKAGE : --location=LOCATION --repository=REPOSITORY)
-        [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE]
-        [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...]
+    gcloud artifacts versions list --package=PACKAGE
+        [--location=LOCATION --repository=REPOSITORY] [--filter=EXPRESSION]
+        [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]]
+        [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
-    List all Artifact Registry package versions in the specified package.
+    List all Artifact Registry versions in the specified package.
 
     To specify the maximum number of versions to list, use the --limit flag.
 
 EXAMPLES
-    The following command lists a maximum of five versions:
+    The following command lists a maximum of five packages versions:
 
         $ gcloud artifacts versions list --limit=5
 
-    The following command lists versions in my-package by specifying the
-    fully-qualified path:
+    To list versions of package my_pkg with name as 1.0-SNAPSHOT:
+
+        $ gcloud artifacts versions list --package=my_pkg \
+          --filter='name="projects/my-project/locations/us/repositories/my\
+        -repo/packages/my_pkg/versions/1.0-SNAPSHOT"'
+
+    To list versions of package my_pkg with a given partial name, use * to
+    match any character in name:
+
+        $ gcloud artifacts versions list --package=my_pkg \
+          --filter='name="projects/my-project/locations/us/repositories/my\
+        -repo/packages/my_pkg/versions/1.0*"'
+
+        $ gcloud artifacts versions list --package=my_pkg \
+          --filter='name="projects/my-project/locations/us/repositories/my\
+        -repo/packages/my_pkg/versions/*SNAPSHOT"'
+
+    To list versions of package my_pkg that have annotations:
+
+        $ gcloud artifacts versions list --package=my_pkg \
+          --filter=annotations:*
+
+    To list versions of package my_pkg with annotations pair as
+    [annotation_key: annotation_value]:
+
+        $ gcloud artifacts versions list --package=my_pkg \
+          --filter='annotations.annotation_key:annotation_value'
+
+    To list versions of package my_pkg with annotations containing key as
+    my_key:
+
+        $ gcloud artifacts versions list --package=my_pkg \
+          --filter=annotations.my_key
+
+        If the key or value contains special characters, such as `my.key` and `my.value`, backtick("`") is required:
+
+        $ gcloud artifacts versions list --filter='annotations.`my.key`'
 
         $ gcloud artifacts versions list \
-          --package=projects/my-project/locations/my-location/\
-        repositories/my-repo/packages/my-package
+          --filter='annotations.`my.key`:`my.value`'
+
+    To list versions of package my_pkg with given partial annotation key or
+    value, use * to match any character:
+
+        $ gcloud artifacts versions list \
+          --filter='annotations.*key:`*.value`'
+
+    To list versions of package my_pkg ordered by create_time:
+
+        $ gcloud artifacts versions list --package=my_pkg \
+            --sort-by=create_time
+
+    To list versions of package my_pkg ordered by update_time reversely:
+
+        $ gcloud artifacts versions list --package=my_pkg \
+            --sort-by=~update_time
 
 REQUIRED FLAGS
-     Package resource - The parent package for the list of versions. The
-     arguments in this group can be used to specify the attributes of this
-     resource. (NOTE) Some attributes are not given arguments in this group but
-     can be set in other ways.
+     --package=PACKAGE
+        List all versions in a specified artifact, such as a container image or
+        a language package.
+
+FLAGS
+     Repository resource - The Artifact Registry repository. If not specified,
+     the current artifacts/repository is used. The arguments in this group can
+     be used to specify the attributes of this resource. (NOTE) Some attributes
+     are not given arguments in this group but can be set in other ways.
 
      To set the project attribute:
-      ◆ provide the argument --package on the command line with a fully
+      ◆ provide the argument --repository on the command line with a fully
         specified name;
+      ◆ set the property artifacts/repository with a fully specified name;
       ◆ provide the argument --project on the command line;
       ◆ set the property core/project.
 
-     This must be specified.
-
-       --package=PACKAGE
-          ID of the package or fully qualified identifier for the package.
-
-          To set the package attribute:
-          ▸ provide the argument --package on the command line.
-
-          This flag argument must be specified if any of the other arguments in
-          this group are specified.
-
        --location=LOCATION
-          Location of the package. Overrides the default artifacts/location
-          property value for this command invocation. To configure the default
-          location, use the command: gcloud config set artifacts/location.
+          Location of the repository.
 
           To set the location attribute:
-          ▸ provide the argument --package on the command line with a fully
-            specified name;
+          ▸ provide the argument --repository on the command line with a
+            fully specified name;
+          ▸ set the property artifacts/repository with a fully specified
+            name;
           ▸ provide the argument --location on the command line;
           ▸ set the property artifacts/location.
 
        --repository=REPOSITORY
-          The repository associated with the package. Overrides the default
-          artifacts/repository property value for this command invocation. To
-          configure the default repository, use the command: gcloud config set
-          artifacts/repository.
+          ID of the repository or fully qualified identifier for the
+          repository.
 
           To set the repository attribute:
-          ▸ provide the argument --package on the command line with a fully
-            specified name;
           ▸ provide the argument --repository on the command line;
           ▸ set the property artifacts/repository.
 
@@ -104,10 +145,6 @@ GCLOUD WIDE FLAGS
 
     Run $ gcloud help for details.
 
-API REFERENCE
-    This command uses the artifactregistry/v1 API. The full documentation for
-    this API can be found at: https://cloud.google.com/artifacts/docs/
-
 NOTES
     These variants are also available: