:doc:`IAM <../../iam>` / Client / update_role

***********
update_role
***********



.. py:method:: IAM.Client.update_role(**kwargs)

  

  Updates the description or maximum session duration setting of a role.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/iam-2010-05-08/UpdateRole>`_  


  **Request Syntax**
  ::

    response = client.update_role(
        RoleName='string',
        Description='string',
        MaxSessionDuration=123
    )
    
  :type RoleName: string
  :param RoleName: **[REQUIRED]** 

    The name of the role that you want to modify.

    

  
  :type Description: string
  :param Description: 

    The new description that you want to apply to the specified role.

    

  
  :type MaxSessionDuration: integer
  :param MaxSessionDuration: 

    The maximum session duration (in seconds) that you want to set for the specified role. If you do not specify a value for this setting, the default value of one hour is applied. This setting can have a value from 1 hour to 12 hours.

     

    Anyone who assumes the role from the CLI or API can use the ``DurationSeconds`` API parameter or the ``duration-seconds`` CLI parameter to request a longer session. The ``MaxSessionDuration`` setting determines the maximum duration that can be requested using the ``DurationSeconds`` parameter. If users don't specify a value for the ``DurationSeconds`` parameter, their security credentials are valid for one hour by default. This applies when you use the ``AssumeRole*`` API operations or the ``assume-role*`` CLI operations but does not apply when you use those operations to create a console URL. For more information, see `Using IAM roles <https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use.html>`__ in the *IAM User Guide*.

     

    .. note::

      

      IAM role credentials provided by Amazon EC2 instances assigned to the role are not subject to the specified maximum session duration.

      

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 
  
  **Exceptions**
  
  *   :py:class:`IAM.Client.exceptions.UnmodifiableEntityException`

  
  *   :py:class:`IAM.Client.exceptions.NoSuchEntityException`

  
  *   :py:class:`IAM.Client.exceptions.ServiceFailureException`

  