rebootDBInstance method

Future<RebootDBInstanceResult> rebootDBInstance({
  1. required String dBInstanceIdentifier,
  2. bool? forceFailover,
})

You might need to reboot your instance, usually for maintenance reasons. For example, if you make certain changes, or if you change the cluster parameter group that is associated with the instance, you must reboot the instance for the changes to take effect.

Rebooting an instance restarts the database engine service. Rebooting an instance results in a momentary outage, during which the instance status is set to rebooting.

May throw InvalidDBInstanceStateFault. May throw DBInstanceNotFoundFault.

Parameter dBInstanceIdentifier : The instance identifier. This parameter is stored as a lowercase string.

Constraints:

  • Must match the identifier of an existing DBInstance.

Parameter forceFailover : When true, the reboot is conducted through a Multi-AZ failover.

Constraint: You can't specify true if the instance is not configured for Multi-AZ.

Implementation

Future<RebootDBInstanceResult> rebootDBInstance({
  required String dBInstanceIdentifier,
  bool? forceFailover,
}) async {
  ArgumentError.checkNotNull(dBInstanceIdentifier, 'dBInstanceIdentifier');
  final $request = <String, dynamic>{};
  $request['DBInstanceIdentifier'] = dBInstanceIdentifier;
  forceFailover?.also((arg) => $request['ForceFailover'] = arg);
  final $result = await _protocol.send(
    $request,
    action: 'RebootDBInstance',
    version: '2014-10-31',
    method: 'POST',
    requestUri: '/',
    exceptionFnMap: _exceptionFns,
    shape: shapes['RebootDBInstanceMessage'],
    shapes: shapes,
    resultWrapper: 'RebootDBInstanceResult',
  );
  return RebootDBInstanceResult.fromXml($result);
}