Interface IDatabaseClusterProps
(experimental) Properties for a new database cluster.
Namespace: Amazon.CDK.AWS.Neptune
Assembly: Amazon.CDK.AWS.Neptune.dll
Syntax (csharp)
public interface IDatabaseClusterProps
Syntax (vb)
Public Interface IDatabaseClusterProps
Remarks
Stability: Experimental
ExampleMetadata: infused
Examples
var cluster = new DatabaseCluster(this, "Database", new DatabaseClusterProps {
Vpc = vpc,
InstanceType = InstanceType.R5_LARGE,
Instances = 2
});
Synopsis
Properties
AssociatedRoles | (experimental) A list of AWS Identity and Access Management (IAM) role that can be used by the cluster to access other AWS services. |
AutoMinorVersionUpgrade | (experimental) If set to true, Neptune will automatically update the engine of the entire cluster to the latest minor version after a stabilization window of 2 to 3 weeks. |
BackupRetention | (experimental) How many days to retain the backup. |
ClusterParameterGroup | (experimental) Additional parameters to pass to the database engine. |
DbClusterName | (experimental) An optional identifier for the cluster. |
DeletionProtection | (experimental) Indicates whether the DB cluster should have deletion protection enabled. |
EngineVersion | (experimental) What version of the database to start. |
IamAuthentication | (experimental) Map AWS Identity and Access Management (IAM) accounts to database accounts. |
InstanceIdentifierBase | (experimental) Base identifier for instances. |
Instances | (experimental) Number of Neptune compute instances. |
InstanceType | (experimental) What type of instance to start for the replicas. |
KmsKey | (experimental) The KMS key for storage encryption. |
ParameterGroup | (experimental) The DB parameter group to associate with the instance. |
Port | (experimental) The port the Neptune cluster will listen on. |
PreferredBackupWindow | (experimental) A daily time range in 24-hours UTC format in which backups preferably execute. |
PreferredMaintenanceWindow | (experimental) A weekly time range in which maintenance should preferably execute. |
RemovalPolicy | (experimental) The removal policy to apply when the cluster and its instances are removed or replaced during a stack update, or when the stack is deleted. |
SecurityGroups | (experimental) Security group. |
StorageEncrypted | (experimental) Whether to enable storage encryption. |
SubnetGroup | (experimental) Existing subnet group for the cluster. |
Vpc | (experimental) What subnets to run the Neptune instances in. |
VpcSubnets | (experimental) Where to place the instances within the VPC. |
Properties
AssociatedRoles
(experimental) A list of AWS Identity and Access Management (IAM) role that can be used by the cluster to access other AWS services.
virtual IRole[] AssociatedRoles { get; }
Property Value
IRole[]
Remarks
Default: - No role is attached to the cluster.
Stability: Experimental
AutoMinorVersionUpgrade
(experimental) If set to true, Neptune will automatically update the engine of the entire cluster to the latest minor version after a stabilization window of 2 to 3 weeks.
virtual Nullable<bool> AutoMinorVersionUpgrade { get; }
Property Value
System.Nullable<System.Boolean>
Remarks
Default: - false
Stability: Experimental
BackupRetention
(experimental) How many days to retain the backup.
virtual Duration BackupRetention { get; }
Property Value
Remarks
Default: - cdk.Duration.days(1)
Stability: Experimental
ClusterParameterGroup
(experimental) Additional parameters to pass to the database engine.
virtual IClusterParameterGroup ClusterParameterGroup { get; }
Property Value
Remarks
Default: - No parameter group.
Stability: Experimental
DbClusterName
(experimental) An optional identifier for the cluster.
virtual string DbClusterName { get; }
Property Value
System.String
Remarks
Default: - A name is automatically generated.
Stability: Experimental
DeletionProtection
(experimental) Indicates whether the DB cluster should have deletion protection enabled.
virtual Nullable<bool> DeletionProtection { get; }
Property Value
System.Nullable<System.Boolean>
Remarks
Default: - true if removalPolicy
is RETAIN, false otherwise
Stability: Experimental
EngineVersion
(experimental) What version of the database to start.
virtual EngineVersion EngineVersion { get; }
Property Value
Remarks
Default: - The default engine version.
Stability: Experimental
IamAuthentication
(experimental) Map AWS Identity and Access Management (IAM) accounts to database accounts.
virtual Nullable<bool> IamAuthentication { get; }
Property Value
System.Nullable<System.Boolean>
Remarks
Default: - false
Stability: Experimental
InstanceIdentifierBase
(experimental) Base identifier for instances.
virtual string InstanceIdentifierBase { get; }
Property Value
System.String
Remarks
Every replica is named by appending the replica number to this string, 1-based.
Default: - dbClusterName
is used with the word "Instance" appended. If dbClusterName
is not provided, the
identifier is automatically generated.
Stability: Experimental
Instances
(experimental) Number of Neptune compute instances.
virtual Nullable<double> Instances { get; }
Property Value
System.Nullable<System.Double>
Remarks
Default: 1
Stability: Experimental
InstanceType
(experimental) What type of instance to start for the replicas.
InstanceType InstanceType { get; }
Property Value
Remarks
Stability: Experimental
KmsKey
(experimental) The KMS key for storage encryption.
virtual IKey KmsKey { get; }
Property Value
Remarks
Default: - default master key.
Stability: Experimental
ParameterGroup
(experimental) The DB parameter group to associate with the instance.
virtual IParameterGroup ParameterGroup { get; }
Property Value
Remarks
Default: no parameter group
Stability: Experimental
Port
(experimental) The port the Neptune cluster will listen on.
virtual Nullable<double> Port { get; }
Property Value
System.Nullable<System.Double>
Remarks
Default: - The default engine port
Stability: Experimental
PreferredBackupWindow
(experimental) A daily time range in 24-hours UTC format in which backups preferably execute.
virtual string PreferredBackupWindow { get; }
Property Value
System.String
Remarks
Must be at least 30 minutes long.
Example: '01:00-02:00'
Default: - a 30-minute window selected at random from an 8-hour block of time for each AWS Region. To see the time blocks available, see
Stability: Experimental
PreferredMaintenanceWindow
(experimental) A weekly time range in which maintenance should preferably execute.
virtual string PreferredMaintenanceWindow { get; }
Property Value
System.String
Remarks
Must be at least 30 minutes long.
Example: 'tue:04:17-tue:04:47'
Default: - 30-minute window selected at random from an 8-hour block of time for each AWS Region, occurring on a random day of the week.
Stability: Experimental
RemovalPolicy
(experimental) The removal policy to apply when the cluster and its instances are removed or replaced during a stack update, or when the stack is deleted.
virtual Nullable<RemovalPolicy> RemovalPolicy { get; }
Property Value
System.Nullable<RemovalPolicy>
Remarks
This removal policy also applies to the implicit security group created for the cluster if one is not supplied as a parameter.
Default: - Retain cluster.
Stability: Experimental
SecurityGroups
(experimental) Security group.
virtual ISecurityGroup[] SecurityGroups { get; }
Property Value
Remarks
Default: a new security group is created.
Stability: Experimental
StorageEncrypted
(experimental) Whether to enable storage encryption.
virtual Nullable<bool> StorageEncrypted { get; }
Property Value
System.Nullable<System.Boolean>
Remarks
Default: true
Stability: Experimental
SubnetGroup
(experimental) Existing subnet group for the cluster.
virtual ISubnetGroup SubnetGroup { get; }
Property Value
Remarks
Default: - a new subnet group will be created.
Stability: Experimental
Vpc
(experimental) What subnets to run the Neptune instances in.
IVpc Vpc { get; }
Property Value
Remarks
Must be at least 2 subnets in two different AZs.
Stability: Experimental
VpcSubnets
(experimental) Where to place the instances within the VPC.
virtual ISubnetSelection VpcSubnets { get; }
Property Value
Remarks
Default: private subnets
Stability: Experimental