---
title: "iamrole list"
slug: "iamrole-list"
tags: ["5.4"]
updated: 2026-10-28T01:53:01Z
published: 2026-10-28T01:53:01Z
canonical: "docs.vastdata.com/iamrole-list"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vastdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# iamrole list

This command lists all IAM roles.

## Usage

```plaintext
iamrole list
```

## Example

This example lists all IAM roles:

```plaintext
vcli: admin> iamrole list
+----+------------------+-------------+--------------------------------+-------------+---------------------------------------------------------------------------------+
| ID | Name             | Description | Max Session Duration (seconds) | Tenant name | Trust-policy                                                                    |
+----+------------------+-------------+--------------------------------+-------------+---------------------------------------------------------------------------------+
| 1  | role1            |  insecure   | 1 day, 12 hours                | default     | {                                                                               |
|    |                  |             |                                |             | "Version": "2012-10-17",                                                        |
|    |                  |             |                                |             |   "Statement": [                                                                |
|    |                  |             |                                |             |     {                                                                           |
|    |                  |             |                                |             |       "Effect": "Allow",                                                        |
|    |                  |             |                                |             |       "Principal": "*",                                                         |
|    |                  |             |                                |             |       "Action": "sts:*"                                                         |
|    |                  |             |                                |             |     }                                                                           |
|    |                  |             |                                |             |   ]                                                                             |
|    |                  |             |                                |             | }                                                                               |
| 2  | role2            |  insecure   | 1 day, 12 hours                | default     | {                                                                               |
|    |                  |             |                                |             | "Version": "2012-10-17",                                                        |
|    |                  |             |                                |             |   "Statement": [                                                                |
|    |                  |             |                                |             |     {                                                                           |
|    |                  |             |                                |             |       "Effect": "Allow",                                                        |
|    |                  |             |                                |             |       "Principal": "*",                                                         |
|    |                  |             |                                |             |       "Action": "sts:*"                                                         |
|    |                  |             |                                |             |     }                                                                           |
|    |                  |             |                                |             |   ]                                                                             |
|    |                  |             |                                |             | }                                                                               |
| 3  | role3            | secure      | 1 day, 12 hours                | test        | {                                                                               |
|    |                  |             |                                |             |   "Version": "2012-10-17",                                                      |
|    |                  |             |                                |             |   "Statement": [                                                                |
|    |                  |             |                                |             |     {                                                                           |
|    |                  |             |                                |             |       "Effect": "Allow",                                                        |
|    |                  |             |                                |             |       "Principal": {                                                            |
|    |                  |             |                                |             |         "Federated": "oidc-provider/integrator-1234567.okta.com/oauth2/default" |
|    |                  |             |                                |             |       },                                                                        |
|    |                  |             |                                |             |       "Action": "sts:AssumeRoleWithWebIdentity",                                |
|    |                  |             |                                |             |       "Condition": {                                                            |
|    |                  |             |                                |             |         "StringEquals": {                                                       |
|    |                  |             |                                |             |           "user-OIDC:email": "user.user@vastdata.com"                  |
|    |                  |             |                                |             |         }                                                                       |
|    |                  |             |                                |             |       }                                                                         |
|    |                  |             |                                |             |     }                                                                           |
|    |                  |             |                                |             |   ]                                                                             |
|    |                  |             |                                |             | }                                                                               |
+----+------------------+-------------+--------------------------------+-------------+---------------------------------------------------------------------------------+
```