## NAME

gdcloud iam roles describe - Describe a role\[custom/predefined\].

## SYNOPSIS

```text
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

```text

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/gdcag/resources/gdcloud-reference/gdcloud.md.txt) page.