NAME
    gcloud alpha resource-manager folders list - list folders accessible by the
        active account

SYNOPSIS
    gcloud alpha resource-manager folders list [--folder=FOLDER_ID]
        [--organization=ORGANIZATION_ID] [--show-deleted] [--filter=EXPRESSION]
        [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri]
        [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (ALPHA) List all folders to which the active account has access under the
    specified parent (either an organization or a folder). Exactly one of
    --folder or --organization must be provided.

    The active account can be a user account or a service account. If the
    active account is a service account, then the list of folders might be
    incomplete. Specifically, the list excludes folders that the active account
    only has access to because they're in a service account principal set
    (https://cloud.google.com/iam/help/service-accounts/principal-sets) with
    access to the folder.

EXAMPLES
    The following command lists folders under org with ID 123456789:

        $ gcloud alpha resource-manager folders list --organization=123456789

    The following command lists folders under folder with ID 123456789:

        $ gcloud alpha resource-manager folders list --folder=123456789

    The following command lists all the folders including the delete requested
    ones under the folder with ID 123456789:

        $ gcloud alpha resource-manager folders list --folder=123456789 \
            --show-deleted

    The following command lists only the deleted folders under folder with ID
    123456789:

        $ gcloud alpha resource-manager folders list --folder=123456789 \
            --show-deleted \

        --filter='lifecycleState:DELETE_REQUESTED':

FLAGS
     --folder=FOLDER_ID
        ID for the folder to list folders under

     --organization=ORGANIZATION_ID
        ID for the organization to list folders under

     --show-deleted
        Put --show-deleted flag to include folders for which delete is
        requested.

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.

     --page-size=PAGE_SIZE
        Some services group resource list output into pages. This flag
        specifies the maximum number of resources per page. The default is
        determined by the service if it supports paging, otherwise it is
        unlimited (no paging). Paging may be applied before or after --filter
        and --limit depending on the service.

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

     --uri
        Print a list of resource URIs instead of the default output, and change
        the command output to a list of URIs. If this flag is used with
        --format, the formatting is applied on this URI list. To display URIs
        alongside other keys instead, use the uri() transform.

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 alpha and might change without notice. If this
    command fails with API permission errors despite specifying the correct
    project, you might be trying to access an API with an invitation-only early
    access allowlist. These variants are also available:

        $ gcloud resource-manager folders list

        $ gcloud beta resource-manager folders list

