AWS::RDS::DBInstance DBInstanceRole - AWS CloudFormation
SyntaxPropertiesExamples

This is the new AWS CloudFormation Template Reference Guide. Please update your bookmarks and links. For help getting started with CloudFormation, see the AWS CloudFormation User Guide.

AWS::RDS::DBInstance DBInstanceRole

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

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{
  "FeatureName" : String,
  "RoleArn" : String
}

YAML

  FeatureName: String
  RoleArn: String

Properties

FeatureName

The name of the feature associated with the AWS Identity and Access Management (IAM) role. IAM roles that are associated with a DB instance grant permission for the DB instance to access other AWS services on your behalf. For the list of supported feature names, see the SupportedFeatureNames description in DBEngineVersion in the Amazon RDS API Reference.

Required: Yes

Type: String

Update requires: No interruption

RoleArn

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

Required: Yes

Type: String

Update requires: No interruption

Examples

The following specifies a role to associate with a DB instance.

JSON

"AssociatedRoles": [
    {
        "FeatureName": "s3Import",
        "RoleArn": "arn:aws:iam::123456789012:role/RDSLoadFromS3"               
    }
]

YAML

AssociatedRoles:
    - FeatureName: s3Import
      RoleArn: 'arn:aws:iam::123456789012:role/RDSLoadFromS3'