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