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

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

This command modifies an existing IAM Role.

## Usage

```plaintext
iamrole modify --id ID
              [--description DESCRIPTION]
              [--trust-policy TRUSTPOLICY]
              [--identity-policies-ids POLICY_IDS]
              [--max-session-duration DURATION]
```

## Required Parameters

| `--id ID` | Specifies the ID of the IAM Role to modify. |
| --- | --- |

## Options

| `--description DESCRIPTION` | Description of IAM Role |
| --- | --- |
| `--trust-policy TRUSTPOLICY` | Trust policy, in JSON format. |
| `--identity-policies-ids POLICY_IDS` | Specifies which Identity Policies to attach. Specify POLICY_IDS as a comma-separated list of IDs. |
| `--max-session-duration DURATION` | > [!NOTE] > This option is introduced in VAST Cluster 5.4.3. Limits the maximum duration for which a temporary access key can be granted to a requesting user, in seconds. Maximum (default): 129,600 (36 hours) Minimum: 900 (15 minutes) |

## Example

This example modifies an IAM Role:

```plaintext
vcli: admin> iamrole modify --id 5 --description "updated description" --trust-policy '{"Version": "2012-10-17"}'
```