Show / Hide Table of Contents

Interface IInstanceProps

Instance properties for database instances.

Namespace: Amazon.CDK.AWS.RDS
Assembly: Amazon.CDK.AWS.RDS.dll
Syntax (csharp)
public interface IInstanceProps
Syntax (vb)
Public Interface IInstanceProps
Remarks

ExampleMetadata: infused

Examples
Vpc vpc;

var cluster = new DatabaseCluster(this, "Database", new DatabaseClusterProps {
    Engine = DatabaseClusterEngine.AURORA,
    InstanceProps = new InstanceProps { Vpc = vpc }
});

var proxy = new DatabaseProxy(this, "Proxy", new DatabaseProxyProps {
    ProxyTarget = ProxyTarget.FromCluster(cluster),
    Secrets = new [] { cluster.Secret },
    Vpc = vpc
});

var role = new Role(this, "DBProxyRole", new RoleProps { AssumedBy = new AccountPrincipal(Account) });
proxy.GrantConnect(role, "admin");

Synopsis

Properties

AllowMajorVersionUpgrade

Whether to allow upgrade of major version for the DB instance.

AutoMinorVersionUpgrade

Whether to enable automatic upgrade of minor version for the DB instance.

DeleteAutomatedBackups

Whether to remove automated backups immediately after the DB instance is deleted for the DB instance.

EnablePerformanceInsights

Whether to enable Performance Insights for the DB instance.

InstanceType

What type of instance to start for the replicas.

ParameterGroup

The DB parameter group to associate with the instance.

Parameters

The parameters in the DBParameterGroup to create automatically.

PerformanceInsightEncryptionKey

The AWS KMS key for encryption of Performance Insights data.

PerformanceInsightRetention

The amount of time, in days, to retain Performance Insights data.

PubliclyAccessible

Indicates whether the DB instance is an internet-facing instance.

SecurityGroups

Security group.

Vpc

What subnets to run the RDS instances in.

VpcSubnets

Where to place the instances within the VPC.

Properties

AllowMajorVersionUpgrade

Whether to allow upgrade of major version for the DB instance.

virtual Nullable<bool> AllowMajorVersionUpgrade { get; }
Property Value

System.Nullable<System.Boolean>

Remarks

Default: - false

AutoMinorVersionUpgrade

Whether to enable automatic upgrade of minor version for the DB instance.

virtual Nullable<bool> AutoMinorVersionUpgrade { get; }
Property Value

System.Nullable<System.Boolean>

Remarks

Default: - true

DeleteAutomatedBackups

Whether to remove automated backups immediately after the DB instance is deleted for the DB instance.

virtual Nullable<bool> DeleteAutomatedBackups { get; }
Property Value

System.Nullable<System.Boolean>

Remarks

Default: - true

EnablePerformanceInsights

Whether to enable Performance Insights for the DB instance.

virtual Nullable<bool> EnablePerformanceInsights { get; }
Property Value

System.Nullable<System.Boolean>

Remarks

Default: - false, unless performanceInsightRentention or performanceInsightEncryptionKey is set.

InstanceType

What type of instance to start for the replicas.

virtual InstanceType InstanceType { get; }
Property Value

InstanceType

Remarks

Default: - t3.medium (or, more precisely, db.t3.medium)

ParameterGroup

The DB parameter group to associate with the instance.

virtual IParameterGroup ParameterGroup { get; }
Property Value

IParameterGroup

Remarks

Default: no parameter group

Parameters

The parameters in the DBParameterGroup to create automatically.

virtual IDictionary<string, string> Parameters { get; }
Property Value

System.Collections.Generic.IDictionary<System.String, System.String>

Remarks

You can only specify parameterGroup or parameters but not both. You need to use a versioned engine to auto-generate a DBParameterGroup.

Default: - None

PerformanceInsightEncryptionKey

The AWS KMS key for encryption of Performance Insights data.

virtual IKey PerformanceInsightEncryptionKey { get; }
Property Value

IKey

Remarks

Default: - default master key

PerformanceInsightRetention

The amount of time, in days, to retain Performance Insights data.

virtual Nullable<PerformanceInsightRetention> PerformanceInsightRetention { get; }
Property Value

System.Nullable<PerformanceInsightRetention>

Remarks

Default: 7

PubliclyAccessible

Indicates whether the DB instance is an internet-facing instance.

virtual Nullable<bool> PubliclyAccessible { get; }
Property Value

System.Nullable<System.Boolean>

Remarks

Default: - true if vpcSubnets is subnetType: SubnetType.PUBLIC, false otherwise

SecurityGroups

Security group.

virtual ISecurityGroup[] SecurityGroups { get; }
Property Value

ISecurityGroup[]

Remarks

Default: a new security group is created.

Vpc

What subnets to run the RDS instances in.

IVpc Vpc { get; }
Property Value

IVpc

Remarks

Must be at least 2 subnets in two different AZs.

VpcSubnets

Where to place the instances within the VPC.

virtual ISubnetSelection VpcSubnets { get; }
Property Value

ISubnetSelection

Remarks

Default: - the Vpc default strategy if not specified.

Back to top Generated by DocFX