gcloud: Tue Mar 1 04:29:52 UTC 2022

2026-07-20 13:10:18 +00:00 · 2022-03-01 04:29:52 +00:00 · 2022-03-01 04:29:52 +00:00 · 1456dab6c7
commit 1456dab6c7
parent aab53307a8
9791 changed files with 814712 additions and 0 deletions
--- a/gcloud/beta/debug/snapshots/list
+++ b/gcloud/beta/debug/snapshots/list
@ -0,0 +1,98 @@
+NAME
+    gcloud beta debug snapshots list - list the debug snapshots for a Cloud
+        Debugger debug target (debuggee)
+
+SYNOPSIS
+    gcloud beta debug snapshots list [ID ...] [--all-users]
+        [--include-inactive=INCLUDE_INACTIVE; default=300]
+        [--location=LOCATION-REGEXP] [--target=(ID|DESCRIPTION_REGEXP)]
+        [--filter=EXPRESSION] [--limit=LIMIT] [--sort-by=[FIELD,...]]
+        [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    (BETA) gcloud beta debug snapshots list is used to display the debug
+    snapshots for a Cloud Debugger debug target (debuggee). By default all
+    active snapshots as well as any recently completed snapshots are returned.
+    To obtain older completed snapshots specify the --include-inactive option.
+
+EXAMPLES
+    To list the active and recently completed debug snapshots of the debug
+    target (debuggee), run:
+
+        $ gcloud beta debug snapshots list --target=<debuggee_id>
+
+    To list all (both active and inactive) snapshots of the debug target
+    (debuggee), run:
+
+        $ gcloud beta debug snapshots list --include-inactive=unlimited \
+            --target=<debuggee_id>
+
+    To list snapshots created by all users of the debug target (debuggee), run:
+
+        $ gcloud beta debug snapshots list --all-users --target=<debuggee_id>
+
+POSITIONAL ARGUMENTS
+     [ID ...]
+        Zero or more snapshot resource identifiers. The specified snapshots
+        will be displayed.
+
+FLAGS
+     --all-users
+        If set, display snapshots from all users, rather than only the current
+        user.
+
+     --include-inactive=INCLUDE_INACTIVE; default=300
+        Include snapshots which have completed in the last INCLUDE_INACTIVE
+        seconds. If the value is "unlimited", all inactive snapshots will be
+        included.
+
+     --location=LOCATION-REGEXP
+        A regular expression to match against snapshot locations. All snapshots
+        matching this value will be displayed. You may specify --location
+        multiple times.
+
+        EXAMPLE:
+
+            gcloud beta debug snapshots list \
+                --location foo.py:[1-3] --location bar.py:4
+
+     --target=(ID|DESCRIPTION_REGEXP)
+        The debug target. It may be a target ID or name obtained from 'debug
+        targets list', or it may be a regular expression uniquely specifying a
+        debuggee based on its description or name. For App Engine projects, if
+        not specified, the default target is the most recent deployment of the
+        default module and version.
+
+LIST COMMAND FLAGS
+     --filter=EXPRESSION
+        Apply a Boolean filter EXPRESSION to each resource item to be listed.
+        If the expression evaluates True, 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.
+
+     --sort-by=[FIELD,...]
+        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.
+
+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 beta and might change without notice. This
+    variant is also available:
+
+        $ gcloud debug snapshots list
+