Stay organized with collections
Save and categorize content based on your preferences.
NAME
gdcloud iam roles describe - Describe a role[custom/predefined].
SYNOPSIS
gdcloud iam roles describe ROLE_NAME [--project=PROJECT] [flags]
DESCRIPTION
Describe role[custom/predefined] permissions. This command retrieves and displays the global and zonal permissions of a role[custom/predefined]. If the --project flag is provided, it describes permissions of a project-scoped role; otherwise, it describes permissions of an organization-scoped role.
EXAMPLES
To describe a role at organization scope, run:
gdcloud iam roles describe org-role
To describe a role at project scope, run:
gdcloud iam roles describe project-role --project my-project
GDCLOUD WIDE FLAGS
These flags are available to all commands: --configuration, --format, --help, --project, --quiet.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-01 UTC."],[[["This command, `gdcloud iam roles describe`, provides details about a specified IAM role, whether custom or predefined."],["The command can describe roles scoped to either an organization or a specific project, controlled by using the `--project` flag."],["Running `gdcloud iam roles describe org-role` will show information for a role at the organization level."],["To see the permissions of a project-scoped role, you can use `gdcloud iam roles describe project-role --project my-project`."],["The command includes wide flags that can be used, such as `--configuration`, `--format`, `--help`, `--project`, and `--quiet`."]]],[]]
