1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-08 10:35:03 +00:00
gcloud-help/gcloud/beta/debug/snapshots/list
2023-02-15 10:13:15 +00:00

103 lines
4 KiB
Text

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) (DEPRECATED) Cloud Debugger is deprecated and will be shutdown May
31, 2023.
See: https://cloud.google.com/debugger/docs/deprecations
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