AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

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

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.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to AddRoleToDBInstanceAsync.

Namespace: Amazon.RDS
Assembly: AWSSDK.RDS.dll
Version: 3.x.y.z

Syntax

C#
public abstract AddRoleToDBInstanceResponse AddRoleToDBInstance(
         AddRoleToDBInstanceRequest request
)

Parameters

request
Type: Amazon.RDS.Model.AddRoleToDBInstanceRequest

Container for the necessary parameters to execute the AddRoleToDBInstance service method.

Return Value


The response from the AddRoleToDBInstance service method, as returned by RDS.

Exceptions

ExceptionCondition
DBInstanceNotFoundException DBInstanceIdentifier doesn't refer to an existing DB instance.
DBInstanceRoleAlreadyExistsException The specified RoleArn or FeatureName value is already associated with the DB instance.
DBInstanceRoleQuotaExceededException You can't associate any more Amazon Web Services Identity and Access Management (IAM) roles with the DB instance because the quota has been reached.
InvalidDBInstanceStateException The DB instance isn't in a valid state.

Version Information

.NET Framework:
Supported in: 4.5 and newer, 3.5

See Also