gcloud debug snapshots list - list the debug snapshots for a Cloud Debugger debug target (debuggee)
gcloud 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 ...]
gcloud 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.
To list the active and recently completed debug snapshots of the debug target (debuggee), run:
$ gcloud debug snapshots list --target=<debuggee_id>
To list all (both active and inactive) snapshots of the debug target (debuggee), run:
$ gcloud debug snapshots list --include-inactive=unlimited \ --target=<debuggee_id>
To list snapshots created by all users of the debug target (debuggee), run:
$ gcloud debug snapshots list --all-users --target=<debuggee_id>
- [ID ...]
Zero or more snapshot resource identifiers. The specified snapshots will be displayed.
- --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 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.
- --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.
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.
This variant is also available:
$ gcloud beta debug snapshots list