---
title: "POST /#Action=AddRoleToDBInstance"
method: POST
path: "/#Action=AddRoleToDBInstance"
---

# POST /#Action=AddRoleToDBInstance

`POST /#Action=AddRoleToDBInstance`

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.

## Query parameters

- `Action` 'AddRoleToDBInstance', required
- `Version` '2014-10-31', required

## Response `200`

Success

## Other responses

- `480` — DBInstanceNotFoundFault
- `481` — DBInstanceRoleAlreadyExistsFault
- `482` — InvalidDBInstanceStateFault
- `483` — DBInstanceRoleQuotaExceededFault

---

[API](https://skmtc.net/aws/apis/rds.md) · [All operations](https://skmtc.net/aws/apis/rds/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/rds/versions/e6b3ad7df19b/schema)