NAME
    gcloud debug snapshots list - list the debug snapshots for a Cloud Debugger
        debug target (debuggee)

SYNOPSIS
    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 ...]

DESCRIPTION
    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.

EXAMPLES
    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>

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 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 variant is also available:

        $ gcloud beta debug snapshots list

