Use UpdateRole with a CLI - AWS SDK Code Examples

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 V4

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 (V4).

Tools for PowerShell V5

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 (V5).