Struct aws_sdk_rds::client::fluent_builders::PromoteReadReplica

pub struct PromoteReadReplica { /* private fields */ }

Fluent builder constructing a request to PromoteReadReplica.

Promotes a read replica DB instance to a standalone DB instance.

• Backup duration is a function of the amount of changes to the database since the previous backup. If you plan to promote a read replica to a standalone instance, we recommend that you enable backups and complete at least one backup prior to promotion. In addition, a read replica cannot be promoted to a standalone instance when it is in the backing-up status. If you have enabled backups on your read replica, configure the automated backup window so that daily backups do not interfere with read replica promotion.

• This command doesn't apply to Aurora MySQL, Aurora PostgreSQL, or RDS Custom.

Implementations

impl PromoteReadReplica

pub async fn customize(
    self
) -> Result<CustomizableOperation<PromoteReadReplica, AwsResponseRetryClassifier>, SdkError<PromoteReadReplicaError>>

Consume this builder, creating a customizable operation that can be modified before being sent. The operation’s inner http::Request can be modified as well.

pub async fn send(
    self
) -> Result<PromoteReadReplicaOutput, SdkError<PromoteReadReplicaError>>

Sends the request and returns the response.

If an error occurs, an SdkError will be returned with additional details that can be matched against.

By default, any retryable failures will be retried twice. Retry behavior is configurable with the RetryConfig, which can be set when configuring the client.

pub fn db_instance_identifier(self, input: impl Into<String>) -> Self

The DB instance identifier. This value is stored as a lowercase string.

Constraints:

• Must match the identifier of an existing read replica DB instance.

Example: mydbinstance

pub fn set_db_instance_identifier(self, input: Option<String>) -> Self

The DB instance identifier. This value is stored as a lowercase string.

Constraints:

• Must match the identifier of an existing read replica DB instance.

Example: mydbinstance

pub fn backup_retention_period(self, input: i32) -> Self

The number of days for which automated backups are retained. Setting this parameter to a positive number enables backups. Setting this parameter to 0 disables automated backups.

Default: 1

Constraints:

• Must be a value from 0 to 35.

• Can't be set to 0 if the DB instance is a source to read replicas.

pub fn set_backup_retention_period(self, input: Option<i32>) -> Self

The number of days for which automated backups are retained. Setting this parameter to a positive number enables backups. Setting this parameter to 0 disables automated backups.

Default: 1

Constraints:

• Must be a value from 0 to 35.

• Can't be set to 0 if the DB instance is a source to read replicas.

pub fn preferred_backup_window(self, input: impl Into<String>) -> Self

The daily time range during which automated backups are created if automated backups are enabled, using the BackupRetentionPeriod parameter.

The default is a 30-minute window selected at random from an 8-hour block of time for each Amazon Web Services Region. To see the time blocks available, see Adjusting the Preferred Maintenance Window in the Amazon RDS User Guide.

Constraints:

• Must be in the format hh24:mi-hh24:mi.

• Must be in Universal Coordinated Time (UTC).

• Must not conflict with the preferred maintenance window.

• Must be at least 30 minutes.

pub fn set_preferred_backup_window(self, input: Option<String>) -> Self

The daily time range during which automated backups are created if automated backups are enabled, using the BackupRetentionPeriod parameter.

The default is a 30-minute window selected at random from an 8-hour block of time for each Amazon Web Services Region. To see the time blocks available, see Adjusting the Preferred Maintenance Window in the Amazon RDS User Guide.

Constraints:

• Must be in the format hh24:mi-hh24:mi.

• Must be in Universal Coordinated Time (UTC).

• Must not conflict with the preferred maintenance window.

• Must be at least 30 minutes.

Trait Implementations

impl Clone for PromoteReadReplica

fn clone(&self) -> PromoteReadReplica

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PromoteReadReplica

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.