pulumi-aws-kotlin/com.pulumi.aws.rds.kotlin/RoleAssociationArgs

RoleAssociationArgs

data class RoleAssociationArgs(val dbInstanceIdentifier: Output<String>? = null, val featureName: Output<String>? = null, val roleArn: Output<String>? = null) : ConvertibleToJava<RoleAssociationArgs>

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 aws.rds.Instance resource monitoring_role_arn argument instead.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const example = new aws.rds.RoleAssociation("example", {
    dbInstanceIdentifier: exampleAwsDbInstance.identifier,
    featureName: "S3_INTEGRATION",
    roleArn: exampleAwsIamRole.arn,
});

import pulumi
import pulumi_aws as aws
example = aws.rds.RoleAssociation("example",
    db_instance_identifier=example_aws_db_instance["identifier"],
    feature_name="S3_INTEGRATION",
    role_arn=example_aws_iam_role["arn"])

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
    var example = new Aws.Rds.RoleAssociation("example", new()
    {
        DbInstanceIdentifier = exampleAwsDbInstance.Identifier,
        FeatureName = "S3_INTEGRATION",
        RoleArn = exampleAwsIamRole.Arn,
    });
});

package main
import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/rds"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := rds.NewRoleAssociation(ctx, "example", &rds.RoleAssociationArgs{
			DbInstanceIdentifier: pulumi.Any(exampleAwsDbInstance.Identifier),
			FeatureName:          pulumi.String("S3_INTEGRATION"),
			RoleArn:              pulumi.Any(exampleAwsIamRole.Arn),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.rds.RoleAssociation;
import com.pulumi.aws.rds.RoleAssociationArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        var example = new RoleAssociation("example", RoleAssociationArgs.builder()
            .dbInstanceIdentifier(exampleAwsDbInstance.identifier())
            .featureName("S3_INTEGRATION")
            .roleArn(exampleAwsIamRole.arn())
            .build());
    }
}

resources:
  example:
    type: aws:rds:RoleAssociation
    properties:
      dbInstanceIdentifier: ${exampleAwsDbInstance.identifier}
      featureName: S3_INTEGRATION
      roleArn: ${exampleAwsIamRole.arn}

Import

Using pulumi import, import aws_db_instance_role_association using the DB Instance Identifier and IAM Role ARN separated by a comma (,). For example:

$ pulumi import aws:rds/roleAssociation:RoleAssociation example my-db-instance,arn:aws:iam::123456789012:role/my-role

Constructors

RoleAssociationArgs

fun RoleAssociationArgs(dbInstanceIdentifier: Output<String>? = null, featureName: Output<String>? = null, roleArn: Output<String>? = null)

Functions

toJava

open override fun toJava(): RoleAssociationArgs

Properties

dbInstanceIdentifier

val dbInstanceIdentifier: Output<String>? = null

DB Instance Identifier to associate with the IAM Role.

featureName

val featureName: Output<String>? = null

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

val roleArn: Output<String>? = null

Amazon Resource Name (ARN) of the IAM Role to associate with the DB Instance.