InstanceUpdateBehaviour

class aws_cdk.aws_rds.InstanceUpdateBehaviour(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: Enum

The orchestration of updates of multiple instances.

ExampleMetadata:

infused

Example:

# vpc: ec2.Vpc

cluster = rds.DatabaseCluster(self, "Database",
    engine=rds.DatabaseClusterEngine.aurora_mysql(version=rds.AuroraMysqlEngineVersion.VER_3_01_0),
    writer=rds.ClusterInstance.provisioned("Instance",
        instance_type=ec2.InstanceType.of(ec2.InstanceClass.BURSTABLE3, ec2.InstanceSize.SMALL)
    ),
    readers=[rds.ClusterInstance.provisioned("reader")],
    instance_update_behaviour=rds.InstanceUpdateBehaviour.ROLLING,  # Optional - defaults to rds.InstanceUpdateBehaviour.BULK
    vpc=vpc
)

Attributes

BULK

In a bulk update, all instances of the cluster are updated at the same time.

This results in a faster update procedure. During the update, however, all instances might be unavailable at the same time and thus a downtime might occur.

ROLLING

In a rolling update, one instance after another is updated.

This results in at most one instance being unavailable during the update. If your cluster consists of more than 1 instance, the downtime periods are limited to the time a primary switch needs.