Amazon RDS Rds Role API
The Rds Role API from Amazon RDS — 4 operation(s) for rds role.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/amazon-rds:amazon-rds-role-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Amazon Relational Database Service Role API
version: '2014-10-31'
description: Generated from AWS's published Smithy model for Amazon Relational Database Service. 4 operation(s).
contact:
name: Amazon Web Services
url: https://aws.amazon.com/contact-us/
license:
name: Apache 2.0
identifier: Apache-2.0
url: https://github.com/aws/api-models-aws/blob/main/LICENSE
servers:
- url: https://rds.{region}.amazonaws.com
variables:
region:
default: us-east-1
security:
- sigv4: []
tags:
- name: Role
paths:
/?Action=AddRoleToDBCluster:
post:
operationId: AddRoleToDBCluster
summary: Add Role To DBCluster
description: Associates an Identity and Access Management (IAM) role with a DB cluster.
responses:
'200':
description: Success
content:
text/xml:
schema:
type: string
'404':
description: DBClusterNotFoundFault
content:
text/xml:
schema:
$ref: '#/components/schemas/DBClusterNotFoundFault'
'400':
description: DBClusterRoleAlreadyExistsFault; DBClusterRoleQuotaExceededFault; InvalidDBClusterStateFault
content:
text/xml:
schema:
$ref: '#/components/schemas/DBClusterRoleAlreadyExistsFault'
requestBody:
required: true
content:
application/x-www-form-urlencoded:
schema:
allOf:
- type: object
required:
- Action
- Version
properties:
Action:
type: string
const: AddRoleToDBCluster
Version:
type: string
const: '2014-10-31'
- $ref: '#/components/schemas/AddRoleToDBClusterMessage'
example:
DBClusterIdentifier: mydbcluster
RoleArn: arn:aws:iam::123456789012:role/RDSLoadFromS3
tags:
- Role
/?Action=AddRoleToDBInstance:
post:
operationId: AddRoleToDBInstance
summary: Add Role To DBInstance
description: 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.
responses:
'200':
description: Success
content:
text/xml:
schema:
type: string
'404':
description: DBInstanceNotFoundFault
content:
text/xml:
schema:
$ref: '#/components/schemas/DBInstanceNotFoundFault'
'400':
description: DBInstanceRoleAlreadyExistsFault; DBInstanceRoleQuotaExceededFault; InvalidDBInstanceStateFault
content:
text/xml:
schema:
$ref: '#/components/schemas/DBInstanceRoleAlreadyExistsFault'
requestBody:
required: true
content:
application/x-www-form-urlencoded:
schema:
allOf:
- type: object
required:
- Action
- Version
properties:
Action:
type: string
const: AddRoleToDBInstance
Version:
type: string
const: '2014-10-31'
- $ref: '#/components/schemas/AddRoleToDBInstanceMessage'
example:
DBInstanceIdentifier: test-instance
RoleArn: arn:aws:iam::111122223333:role/rds-s3-integration-role
FeatureName: S3_INTEGRATION
tags:
- Role
/?Action=RemoveRoleFromDBCluster:
post:
operationId: RemoveRoleFromDBCluster
summary: Remove Role From DBCluster
description: Removes the asssociation of an Amazon Web Services Identity and Access Management (IAM) role from a DB cluster. For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide. For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
responses:
'200':
description: Success
content:
text/xml:
schema:
type: string
'404':
description: DBClusterNotFoundFault; DBClusterRoleNotFoundFault
content:
text/xml:
schema:
$ref: '#/components/schemas/DBClusterNotFoundFault'
'400':
description: InvalidDBClusterStateFault
content:
text/xml:
schema:
$ref: '#/components/schemas/InvalidDBClusterStateFault'
requestBody:
required: true
content:
application/x-www-form-urlencoded:
schema:
allOf:
- type: object
required:
- Action
- Version
properties:
Action:
type: string
const: RemoveRoleFromDBCluster
Version:
type: string
const: '2014-10-31'
- $ref: '#/components/schemas/RemoveRoleFromDBClusterMessage'
example:
DBClusterIdentifier: mydbcluster
RoleArn: arn:aws:iam::123456789012:role/RDSLoadFromS3
tags:
- Role
/?Action=RemoveRoleFromDBInstance:
post:
operationId: RemoveRoleFromDBInstance
summary: Remove Role From DBInstance
description: Disassociates an Amazon Web Services Identity and Access Management (IAM) role from a DB instance.
responses:
'200':
description: Success
content:
text/xml:
schema:
type: string
'404':
description: DBInstanceNotFoundFault; DBInstanceRoleNotFoundFault
content:
text/xml:
schema:
$ref: '#/components/schemas/DBInstanceNotFoundFault'
'400':
description: InvalidDBInstanceStateFault
content:
text/xml:
schema:
$ref: '#/components/schemas/InvalidDBInstanceStateFault'
requestBody:
required: true
content:
application/x-www-form-urlencoded:
schema:
allOf:
- type: object
required:
- Action
- Version
properties:
Action:
type: string
const: RemoveRoleFromDBInstance
Version:
type: string
const: '2014-10-31'
- $ref: '#/components/schemas/RemoveRoleFromDBInstanceMessage'
tags:
- Role
components:
schemas:
InvalidDBInstanceStateFault:
type: object
properties:
message:
type: string
AddRoleToDBClusterMessage:
type: object
properties:
DBClusterIdentifier:
type: string
description: The name of the DB cluster to associate the IAM role with.
RoleArn:
type: string
description: The Amazon Resource Name (ARN) of the IAM role to associate with the Aurora DB cluster, for example arn:aws:iam::123456789012:role/AuroraAccessRole.
FeatureName:
type: string
description: The name of the feature for the DB cluster that the IAM role is to be associated with. For information about supported feature names, see DBEngineVersion.
required:
- DBClusterIdentifier
- RoleArn
DBClusterNotFoundFault:
type: object
properties:
message:
type: string
RemoveRoleFromDBClusterMessage:
type: object
properties:
DBClusterIdentifier:
type: string
description: The name of the DB cluster to disassociate the IAM role from.
RoleArn:
type: string
description: The Amazon Resource Name (ARN) of the IAM role to disassociate from the Aurora DB cluster, for example arn:aws:iam::123456789012:role/AuroraAccessRole.
FeatureName:
type: string
description: The name of the feature for the DB cluster that the IAM role is to be disassociated from. For information about supported feature names, see DBEngineVersion.
required:
- DBClusterIdentifier
- RoleArn
InvalidDBClusterStateFault:
type: object
properties:
message:
type: string
RemoveRoleFromDBInstanceMessage:
type: object
properties:
DBInstanceIdentifier:
type: string
description: The name of the DB instance to disassociate the IAM role from.
RoleArn:
type: string
description: The Amazon Resource Name (ARN) of the IAM role to disassociate from the DB instance, for example, arn:aws:iam::123456789012:role/AccessRole.
FeatureName:
type: string
description: 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.
required:
- DBInstanceIdentifier
- RoleArn
- FeatureName
DBInstanceNotFoundFault:
type: object
properties:
message:
type: string
DBClusterRoleAlreadyExistsFault:
type: object
properties:
message:
type: string
DBInstanceRoleAlreadyExistsFault:
type: object
properties:
message:
type: string
AddRoleToDBInstanceMessage:
type: object
properties:
DBInstanceIdentifier:
type: string
description: The name of the DB instance to associate the IAM role with.
RoleArn:
type: string
description: The Amazon Resource Name (ARN) of the IAM role to associate with the DB instance, for example arn:aws:iam::123456789012:role/AccessRole.
FeatureName:
type: string
description: 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 DBEngineVersion.
required:
- DBInstanceIdentifier
- RoleArn
- FeatureName
securitySchemes:
sigv4:
type: apiKey
in: header
name: Authorization
description: AWS Signature Version 4. The Authorization header carries an AWS4-HMAC-SHA256 signature over the canonical request, with X-Amz-Date (and X-Amz-Security-Token for temporary credentials). Not a bearer token.
x-aws-sigv4:
signingName: rds
x-provenance:
method: harvested
publisher: Amazon Web Services
source: https://raw.githubusercontent.com/aws/api-models-aws/582e55931c45b944739742a2c1620b6026dd2d13/models/rds/service/2014-10-31/rds-2014-10-31.json
note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)