gcloud beta iam list-grantable-roles

NAME
gcloud beta iam list-grantable-roles - list IAM grantable roles for a resource
SYNOPSIS
gcloud beta iam list-grantable-rolesRESOURCE[--filter=EXPRESSION][--page-size=PAGE_SIZE; default=300][GCLOUD_WIDE_FLAG …]
DESCRIPTION
(BETA) This command displays the list of grantable roles for aresource. The resource can be referenced either via the full resource name orvia a URI. User can then add IAM policy bindings to grant the roles.
EXAMPLES
List grantable roles for a project:
gcloudbetaiamlist-grantable-roles//cloudresourcemanager.googleapis.com/projects/PROJECT_ID

List grantable roles for a resource identified via full resource name:

gcloudbetaiamlist-grantable-roles//compute.googleapis.com/projects/example-project/zones/us-central1-f/instances/example-instance

List grantable roles for a resource identified via URI:

gcloudbetaiamlist-grantable-roleshttps://www.googleapis.com/compute/v1/projects/example-project/\zones/us-central1-f/instances/example-instance
POSITIONAL ARGUMENTS
RESOURCE
The full resource name or URI to get the list of roles for.

See"ResourceNames" for details. To get a URI from mostlist commands ingcloud, pass the--uri flag. For example:

gcloudcomputeinstanceslist--projectprj--urihttps://compute.googleapis.com/compute/v1/projects/prj/zones/us-east1-c/instances/i1https://compute.googleapis.com/compute/v1/projects/prj/zones/us-east1-d/instances/i2
LIST COMMAND FLAGS
--filter=EXPRESSION
Apply a Boolean filterEXPRESSION to each resource itemto be listed. If the expression evaluatesTrue, then that item islisted. For more details and examples of filter expressions, run $gcloud topic filters. This flaginteracts with other flags that are applied in this order:--flatten,--sort-by,--filter,--limit.
--page-size=PAGE_SIZE; default=300
Some services group resource list output into pages. This flag specifies themaximum number of resources per page. The default is300. Pagingmay be applied before or after--filter and--limitdepending on the service.
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 beta and might change without notice. Thesevariants are also available:
gcloudiamlist-grantable-roles
gcloudalphaiamlist-grantable-roles

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-05-07 UTC.