Skip to content

Resource: awsDbInstanceRoleAssociation

Manages an RDS DB Instance association with an IAM Role. Example use cases:

-> To manage the RDS DB Instance IAM Role for Enhanced Monitoring, see the awsDbInstance resource monitoringRoleArn argument instead.

Example Usage

/*Provider bindings are generated by running cdktf get.
See https://cdk.tf/provider-generation for more details.*/
import * as aws from "./.gen/providers/aws";
new aws.dbInstanceRoleAssociation.DbInstanceRoleAssociation(this, "example", {
  dbInstanceIdentifier: "${aws_db_instance.example.id}",
  featureName: "S3_INTEGRATION",
  roleArn: "${aws_iam_role.example.arn}",
});

Argument Reference

The following arguments are supported:

  • dbInstanceIdentifier - (Required) DB Instance Identifier to associate with the IAM Role.
  • featureName - (Required) Name of the feature for association. This can be found in the AWS documentation relevant to the integration or a full list is available in the supportedFeatureNames list returned by AWS CLI rds describe-db-engine-versions.
  • roleArn - (Required) Amazon Resource Name (ARN) of the IAM Role to associate with the DB Instance.

Attributes Reference

In addition to all arguments above, the following attributes are exported:

  • id - DB Instance Identifier and IAM Role ARN separated by a comma (,)

Import

awsDbInstanceRoleAssociation can be imported using the DB Instance Identifier and IAM Role ARN separated by a comma (,), e.g.,

$ terraform import aws_db_instance_role_association.example my-db-instance,arn:aws:iam::123456789012:role/my-role