Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

DBInstanceRole - Amazon Relational Database Service

DBInstanceRole

Information about an AWS Identity and Access Management (IAM) role that is associated with a DB instance.

Contents

Note

In the following list, the required parameters are described first.

FeatureName

The name of the feature associated with the AWS Identity and Access Management (IAM) role. For information about supported feature names, see DBEngineVersion.

Type: String

Required: No

RoleArn

The Amazon Resource Name (ARN) of the IAM role that is associated with the DB instance.

Type: String

Required: No

Status

Information about the state of association between the IAM role and the DB instance. The Status property returns one of the following values:

  • ACTIVE - the IAM role ARN is associated with the DB instance and can be used to access other AWS services on your behalf.

  • PENDING - the IAM role ARN is being associated with the DB instance.

  • INVALID - the IAM role ARN is associated with the DB instance, but the DB instance is unable to assume the IAM role in order to access other AWS services on your behalf.

Type: String

Required: No

See Also

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

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.