RemoveRoleFromDBInstance - Amazon Relational Database Service
Request ParametersErrorsExamplesSee Also
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

RemoveRoleFromDBInstance

Disassociates an Amazon Identity and Access Management (IAM) role from a DB instance.

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

DBInstanceIdentifier

The name of the DB instance to disassociate the IAM role from.

Type: String

Required: Yes

FeatureName

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

Type: String

Required: Yes

RoleArn

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

Type: String

Required: Yes

Errors

For information about the errors that are common to all actions, see Common Errors.

DBInstanceNotFound

DBInstanceIdentifier doesn't refer to an existing DB instance.

HTTP Status Code: 404

DBInstanceRoleNotFound

The specified RoleArn value doesn't match the specified feature for the DB instance.

HTTP Status Code: 404

InvalidDBInstanceState

The DB instance isn't in a valid state.

HTTP Status Code: 400

Examples

Example

This example illustrates one usage of RemoveRoleFromDBInstance.

Sample Request

https://rds.us-east-1.amazonaws.com/
    ?Action=RemoveRoleFromDBInstance
    &DBInstanceIdentifier=sample-instance
    &RoleArn=arn%3Aaws%3Aiam%3A%3A123456789012%3Arole%2Fsample-role
    &FeatureName=s3Import

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: