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

gcloud/alpha/artifacts/files/list

@@ -14,34 +14,88 @@ DESCRIPTION
     To specify the maximum number of files to list, use the --limit flag.
 
 EXAMPLES
-    To list files in the current project under repository my-repo in
-    us-central1:
+    To list files in the current project under repository my-repo in us:
 
         $ gcloud alpha artifacts files list --repository=my-repo \
-          --location=us-central1
+          --location=us
 
     The following command lists a maximum of five files:
 
         $ gcloud alpha artifacts files list --repository=my-repo \
-          --location=us-central1 --limit=5
+          --location=us --limit=5
 
-    To list files in the current project under repository my-repo in
-    us-central1 owned by package my-package:
+    To list files in the current project under repository my-repo in us owned
+    by package my-package:
 
         $ gcloud alpha artifacts files list --repository=my-repo \
-          --location=us-central1 --package=my-package
+          --location=us --package=my-package
 
-    To list files in the current project under repository my-repo in
-    us-central1 owned by package my-package and version 1.0.0:
+    To list files in the current project under repository my-repo in us owned
+    by package my-package and version 1.0.0:
 
         $ gcloud alpha artifacts files list --repository=my-repo \
-          --location=us-central1 --package=my-package --version=1.0.0
+          --location=us --package=my-package --version=1.0.0
 
-    To list files in the current project under repository my-repo in
-    us-central1 owned by package my-package and tag name my-tag:
+    To list files in the current project under repository my-repo in us owned
+    by package my-package and tag name my-tag:
 
         $ gcloud alpha artifacts files list --repository=my-repo \
-          --location=us-central1 --package=my-package --tag=my-tag
+          --location=us --package=my-package --tag=my-tag
+
+    To list files with name as my-file:
+
+        $ gcloud alpha artifacts files list \
+          --filter='name="projects/my-project/locations/us/repositories/my\
+        -repo/files/my-file"'
+
+    To list files with a given partial name, use * to match any character in
+    name:
+
+        $ gcloud alpha artifacts files list \
+          --filter='name="projects/my-project/locations/us/repositories/my\
+        -repo/files/*file"'
+
+        $ gcloud alpha artifacts files list \
+          --filter='name="projects/my-project/locations/us/repositories/my\
+        -repo/files/my-*"'
+
+    To list files that have annotations:
+
+        $ gcloud alpha artifacts files list --filter=annotations:*
+
+    To list files with annotations pair as [annotation_key: annotation_value]
+
+        $ gcloud alpha artifacts files list \
+          --filter='annotations.annotation_key:annotation_value'
+
+    To list files with annotations containing key as my_key:
+
+        $ gcloud alpha artifacts files list --filter='annotations.my_key'
+
+        If the key or value contains special characters, such as `my.key` and `my.value`, backtick("`") is required:
+
+        $ gcloud alpha artifacts files list --filter='annotations.`my.key`'
+
+        $ gcloud alpha artifacts files list \
+          --filter='annotations.`my.key`:`my.value`'
+
+    To list files with given partial annotation key or value, use * to match
+    any character:
+
+        $ gcloud alpha artifacts files list \
+          --filter='annotations.*key:`*.value`'
+
+    To list files in the current project under repository my-repo in us,
+    ordering by create_time:
+
+        $ gcloud alpha artifacts files list --repository=my-repo \
+          --location=us --sort-by=create_time
+
+    To list files in the current project under repository my-repo in us,
+    ordering by update_time reversely:
+
+        $ gcloud alpha artifacts files list --repository=my-repo \
+          --location=us --sort-by=~update_time
 
 FLAGS
      --package=PACKAGE