:doc:`RDS <../../rds>` / Client / add_role_to_db_instance

***********************
add_role_to_db_instance
***********************



.. py:method:: RDS.Client.add_role_to_db_instance(**kwargs)

  

  Associates an Amazon Web Services Identity and Access Management (IAM) role with a DB instance.

   

  .. note::

    

    To add a role to a DB instance, the status of the DB instance must be ``available``.

    

   

  This command doesn't apply to RDS Custom.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/AddRoleToDBInstance>`_  


  **Request Syntax**
  ::

    response = client.add_role_to_db_instance(
        DBInstanceIdentifier='string',
        RoleArn='string',
        FeatureName='string'
    )
    
  :type DBInstanceIdentifier: string
  :param DBInstanceIdentifier: **[REQUIRED]** 

    The name of the DB instance to associate the IAM role with.

    

  
  :type RoleArn: string
  :param RoleArn: **[REQUIRED]** 

    The Amazon Resource Name (ARN) of the IAM role to associate with the DB instance, for example ``arn:aws:iam::123456789012:role/AccessRole``.

    

  
  :type FeatureName: string
  :param FeatureName: **[REQUIRED]** 

    The name of the feature for the DB instance that the IAM role is to be associated with. For information about supported feature names, see  DBEngineVersion.

    

  
  
  :returns: None
  **Exceptions**
  
  *   :py:class:`RDS.Client.exceptions.DBInstanceRoleQuotaExceededFault`

  
  *   :py:class:`RDS.Client.exceptions.DBInstanceNotFoundFault`

  
  *   :py:class:`RDS.Client.exceptions.InvalidDBInstanceStateFault`

  
  *   :py:class:`RDS.Client.exceptions.DBInstanceRoleAlreadyExistsFault`

  