gcloud_beta_iam_list-grantable-roles (1)
NAME
- gcloud beta iam list-grantable-roles - list IAM grantable roles for a resource
SYNOPSIS
-
gcloud beta iam list-grantable-roles RESOURCE [--filter=EXPRESSION] [--page-size=PAGE_SIZE; default=100] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) This command displays the list of grantable roles for a resource.
POSITIONAL ARGUMENTS
-
- RESOURCE
-
The full resource name or URI to get the list of roles for.
See "Resource Names" (cloud.google.com/apis/design/resource_names for details. To get a URI from most list commands in gcloud, pass the --uri flag. For example:
- $ gcloud compute instances list --project prj --uri www.googleapis.com/compute/v1/projects/prj/zones/us-east1-c/instances/i1 www.googleapis.com/compute/v1/projects/prj/zones/us-east1-d/instances/i2
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.
- --page-size=PAGE_SIZE; default=100
-
Some services group resource list output into pages. This flag specifies the
maximum number of resources per page. The default is 100. Paging may be
applied before or after --filter and --limit depending on the
service.
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
List grantable roles for a project:
-
$ gcloud beta iam list-grantable-roles \
//cloudresourcemanager.googleapis.com/projects/PROJECT_ID
List grantable roles for a resource identified via full resource name:
-
$ gcloud beta iam list-grantable-roles \
//compute.googleapis.com/projects/example-project/zones/\ us-central1-f/instances/example-instance
List grantable roles for a resource identified via URI:
-
$ gcloud beta iam list-grantable-roles \
www.googleapis.com/compute/v1/projects/example-project zones/us-central1-f/instances/example-instance
NOTES
This command is currently in BETA and may change without notice. These variants are also available:
- $ gcloud iam list-grantable-roles $ gcloud alpha iam list-grantable-roles