RemoveRoleFromDBInstance
Disassociates an AWS 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 AWS SDKs, see the following: