## NAME

gdcloud iam roles list - List roles\[custom/predefined/all\].

## SYNOPSIS

```text
gdcloud iam roles list (custom | predefined | all) [--project=PROJECT] [flags]
```

## DESCRIPTION

This command lists the roles of a specified type: 'custom', 'predefined' or 'all'. Optionally, you can specify a project to filter the results.

### EXAMPLES

```text

To list all roles, run:

    gdcloud iam roles list

To list predefined roles, run:

    gdcloud iam roles list --type=predefined

To list custom roles, run:

    gdcloud iam roles list --type=custom

To list all roles for a specific project, run:

    gdcloud iam roles list --project=my-project

To list predefined roles for a specific project, run:

    gdcloud iam roles list --type=predefined --project=my-project

To list custom roles for a specific project, run:

    gdcloud iam roles list --type=custom --project=my-project
```

### OPTIONAL FLAGS

```text
      --type string   Type of roles to list. Valid values are 'custom', 'predefined', or 'all'. (default "all")
```

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