gcloud iam policy-bindings describe

NAME
gcloud iam policy-bindings describe - get PolicyBinding instance
SYNOPSIS
gcloud iam policy-bindings describe(POLICY_BINDING :--folder=FOLDER--location=LOCATION--organization=ORGANIZATION)[GCLOUD_WIDE_FLAG]
DESCRIPTION
Get PolicyBinding instance.
EXAMPLES
To get the details of a single policy bindingmy-binding inorganization123 run:
gcloudiampolicy-bindingsdescribemy-binding--organization=123--location=global
POSITIONAL ARGUMENTS
PolicyBinding resource - The name of the policy binding to retrieve.

Format:

  • projects/{project_id}/locations/{location}/policyBindings/{policy_binding_id}
  • projects/{project_number}/locations/{location}/policyBindings/{policy_binding_id}
  • folders/{folder_id}/locations/{location}/policyBindings/{policy_binding_id}
  • organizations/{organization_id}/locations/{location}/policyBindings/{policy_binding_id}The arguments in this group can be used to specify the attributes of thisresource. (NOTE) Some attributes are not given arguments in this group but canbe set in other ways.

To set theproject attribute:

  • provide the argumentpolicy_binding on the command line with afully specified name;
  • provide the argument--project on the command line;
  • set the propertycore/project. This resource can be one of thefollowing types: [iam.folders.locations.policyBindings,iam.organizations.locations.policyBindings,iam.projects.locations.policyBindings].

This must be specified.

POLICY_BINDING
ID of the policyBinding or fully qualified identifier for the policyBinding.

To set thepolicy_binding attribute:

  • provide the argumentpolicy_binding on the command line.

This positional argument must be specified if any of the other arguments in thisgroup are specified.

--folder=FOLDER
The folder id of the policyBinding resource.

To set thefolder attribute:

  • provide the argumentpolicy_binding on the command line with afully specified name;
  • provide the argument--folder on the command line. Must bespecified for resource of type [iam.folders.locations.policyBindings].
--location=LOCATION
The location id of the policyBinding resource.

To set thelocation attribute:

  • provide the argumentpolicy_binding on the command line with afully specified name;
  • provide the argument--location on the command line.
--organization=ORGANIZATION
The organization id of the policyBinding resource.

To set theorganization attribute:

  • provide the argumentpolicy_binding on the command line with afully specified name;
  • provide the argument--organization on the command line. Must bespecified for resource of type [iam.organizations.locations.policyBindings].
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.

API REFERENCE
This command uses theiam/v3 API. The full documentation for thisAPI can be found at:https://cloud.google.com/iam/
NOTES
This variant is also available:
gcloudbetaiampolicy-bindingsdescribe

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.