GET

/#Action=AddRoleToDBInstance

http://rds.{region}.amazonaws.com/#Action=AddRoleToDBInstance

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 <code>available</code>. </note> This command doesn't apply to RDS Custom.

Access Token Required: API Key

Query Params

DBInstanceIdentifierstringrequired

The name of the DB instance to associate the IAM role with.

RoleArnstringrequired

The Amazon Resource Name (ARN) of the IAM role to associate with the DB instance, for example <code>arn:aws:iam::123456789012:role/AccessRole</code>.

FeatureNamestringrequired

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 <a>DBEngineVersion</a>.

Actionstringrequired

Allowed:

Versionstringrequired

Allowed:

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'http://rds.{region}.amazonaws.com/#Action=AddRoleToDBInstance' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}