add_role_to_db_instance

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

Request Syntax

response = client.add_role_to_db_instance(
    DBInstanceIdentifier='string',
    RoleArn='string',
    FeatureName='string'
)

Parameters

• DBInstanceIdentifier (string) --

  [REQUIRED]

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

• RoleArn (string) --

  [REQUIRED]

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

• FeatureName (string) --

  [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

• RDS.Client.exceptions.DBInstanceNotFoundFault
• RDS.Client.exceptions.DBInstanceRoleAlreadyExistsFault
• RDS.Client.exceptions.InvalidDBInstanceStateFault
• RDS.Client.exceptions.DBInstanceRoleQuotaExceededFault