## 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`.

For more information, see the [gdcloud CLI reference overview](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/resources/gdcloud-reference/gdcloud) page.