DatabaseInstanceProps

class aws_cdk.aws_docdb.DatabaseInstanceProps(*, cluster, instance_type, auto_minor_version_upgrade=None, availability_zone=None, db_instance_name=None, preferred_maintenance_window=None, removal_policy=None)

Bases: object

Construction properties for a DatabaseInstanceNew.

Parameters:

  • cluster (IDatabaseCluster) – The DocumentDB database cluster the instance should launch into.

  • instance_type (InstanceType) – The name of the compute and memory capacity classes.

  • auto_minor_version_upgrade (Optional[bool]) – Indicates that minor engine upgrades are applied automatically to the DB instance during the maintenance window. Default: true

  • availability_zone (Optional[str]) – The name of the Availability Zone where the DB instance will be located. Default: - no preference

  • db_instance_name (Optional[str]) – A name for the DB instance. If you specify a name, AWS CloudFormation converts it to lowercase. Default: - a CloudFormation generated name

  • preferred_maintenance_window (Optional[str]) – The weekly time range (in UTC) during which system maintenance can occur. Format: ddd:hh24:mi-ddd:hh24:mi Constraint: Minimum 30-minute window Default: - a 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. To see the time blocks available, see https://docs.aws.amazon.com/documentdb/latest/developerguide/db-instance-maintain.html#maintenance-window

  • removal_policy (Optional[RemovalPolicy]) – The CloudFormation policy to apply when the instance is removed from the stack or replaced during an update. Default: RemovalPolicy.Retain

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
import aws_cdk.aws_docdb as docdb
import aws_cdk.aws_ec2 as ec2
import aws_cdk.core as cdk

# database_cluster: docdb.DatabaseCluster
# instance_type: ec2.InstanceType

database_instance_props = docdb.DatabaseInstanceProps(
    cluster=database_cluster,
    instance_type=instance_type,

    # the properties below are optional
    auto_minor_version_upgrade=False,
    availability_zone="availabilityZone",
    db_instance_name="dbInstanceName",
    preferred_maintenance_window="preferredMaintenanceWindow",
    removal_policy=cdk.RemovalPolicy.DESTROY
)

Attributes

auto_minor_version_upgrade

Indicates that minor engine upgrades are applied automatically to the DB instance during the maintenance window.

Default:

true

availability_zone

The name of the Availability Zone where the DB instance will be located.

Default:

  • no preference

cluster

The DocumentDB database cluster the instance should launch into.

db_instance_name

A name for the DB instance.

If you specify a name, AWS CloudFormation converts it to lowercase.

Default:

  • a CloudFormation generated name

instance_type

The name of the compute and memory capacity classes.

preferred_maintenance_window

The weekly time range (in UTC) during which system maintenance can occur.

Format: ddd:hh24:mi-ddd:hh24:mi Constraint: Minimum 30-minute window

Default:

  • a 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. To see the time blocks available, see https://docs.aws.amazon.com/documentdb/latest/developerguide/db-instance-maintain.html#maintenance-window

removal_policy

The CloudFormation policy to apply when the instance is removed from the stack or replaced during an update.

Default:

RemovalPolicy.Retain