Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Use UpdateRole with a CLI - AWS SDK Code Examples

There are more AWS SDK examples available in the AWS Doc SDK Examples GitHub repo.

There are more AWS SDK examples available in the AWS Doc SDK Examples GitHub repo.

Use UpdateRole with a CLI

The following code examples show how to use UpdateRole.

CLI
AWS CLI

To change an IAM role's description or session duration

The following update-role command changes the description of the IAM role production-role to Main production role and sets the maximum session duration to 12 hours.

aws iam update-role \ --role-name production-role \ --description 'Main production role' \ --max-session-duration 43200

This command produces no output.

For more information, see Modifying a role in the AWS IAM User Guide.

  • For API details, see UpdateRole in AWS CLI Command Reference.

PowerShell
Tools for PowerShell

Example 1: This example updates the role description and the maximum session duration value(in seconds) for which a role's session can be requested.

Update-IAMRole -RoleName MyRoleName -Description "My testing role" -MaxSessionDuration 43200
  • For API details, see UpdateRole in AWS Tools for PowerShell Cmdlet Reference.

AWS CLI

To change an IAM role's description or session duration

The following update-role command changes the description of the IAM role production-role to Main production role and sets the maximum session duration to 12 hours.

aws iam update-role \ --role-name production-role \ --description 'Main production role' \ --max-session-duration 43200

This command produces no output.

For more information, see Modifying a role in the AWS IAM User Guide.

  • For API details, see UpdateRole in AWS CLI Command Reference.

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.