gcloud_alpha_iam_roles_list (1)
NAME
- gcloud alpha iam roles list - list the roles defined at a parent organization or a project
SYNOPSIS
-
gcloud alpha iam roles list [--organization=ORGANIZATION] [--show-deleted] [--filter=EXPRESSION] [--limit=LIMIT] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) This command lists the roles with given parent organization or
FLAGS
-
- --organization=ORGANIZATION
-
The organization of the role you want to list.
- --show-deleted
-
Show deleted roles by specifying this flag.
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: --account, --configuration, --flags-file, --flatten, --format, --help, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity. Run $ gcloud help for details.
EXAMPLES
To list the roles for an organization, run:
- $ gcloud alpha iam roles list --organization 12345
To list the roles for a project, run:
- $ gcloud alpha iam roles list --project myproject
To list the curated roles, run:
- $ gcloud alpha iam roles list
NOTES
This command is currently in ALPHA and may change without notice. If this command fails with API permission errors despite specifying the right project, you will have to apply for early access and have your projects registered on the API whitelist to use it. To do so, contact Support at cloud.google.com/support These variants are also available:
- $ gcloud iam roles list $ gcloud beta iam roles list