aws_sdk_docdbelastic/client/
update_cluster.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2impl super::Client {
3    /// Constructs a fluent builder for the [`UpdateCluster`](crate::operation::update_cluster::builders::UpdateClusterFluentBuilder) operation.
4    ///
5    /// - The fluent builder is configurable:
6    ///   - [`cluster_arn(impl Into<String>)`](crate::operation::update_cluster::builders::UpdateClusterFluentBuilder::cluster_arn) / [`set_cluster_arn(Option<String>)`](crate::operation::update_cluster::builders::UpdateClusterFluentBuilder::set_cluster_arn):<br>required: **true**<br><p>The ARN identifier of the elastic cluster.</p><br>
7    ///   - [`auth_type(Auth)`](crate::operation::update_cluster::builders::UpdateClusterFluentBuilder::auth_type) / [`set_auth_type(Option<Auth>)`](crate::operation::update_cluster::builders::UpdateClusterFluentBuilder::set_auth_type):<br>required: **false**<br><p>The authentication type used to determine where to fetch the password used for accessing the elastic cluster. Valid types are <code>PLAIN_TEXT</code> or <code>SECRET_ARN</code>.</p><br>
8    ///   - [`shard_capacity(i32)`](crate::operation::update_cluster::builders::UpdateClusterFluentBuilder::shard_capacity) / [`set_shard_capacity(Option<i32>)`](crate::operation::update_cluster::builders::UpdateClusterFluentBuilder::set_shard_capacity):<br>required: **false**<br><p>The number of vCPUs assigned to each elastic cluster shard. Maximum is 64. Allowed values are 2, 4, 8, 16, 32, 64.</p><br>
9    ///   - [`shard_count(i32)`](crate::operation::update_cluster::builders::UpdateClusterFluentBuilder::shard_count) / [`set_shard_count(Option<i32>)`](crate::operation::update_cluster::builders::UpdateClusterFluentBuilder::set_shard_count):<br>required: **false**<br><p>The number of shards assigned to the elastic cluster. Maximum is 32.</p><br>
10    ///   - [`vpc_security_group_ids(impl Into<String>)`](crate::operation::update_cluster::builders::UpdateClusterFluentBuilder::vpc_security_group_ids) / [`set_vpc_security_group_ids(Option<Vec::<String>>)`](crate::operation::update_cluster::builders::UpdateClusterFluentBuilder::set_vpc_security_group_ids):<br>required: **false**<br><p>A list of EC2 VPC security groups to associate with the elastic cluster.</p><br>
11    ///   - [`subnet_ids(impl Into<String>)`](crate::operation::update_cluster::builders::UpdateClusterFluentBuilder::subnet_ids) / [`set_subnet_ids(Option<Vec::<String>>)`](crate::operation::update_cluster::builders::UpdateClusterFluentBuilder::set_subnet_ids):<br>required: **false**<br><p>The Amazon EC2 subnet IDs for the elastic cluster.</p><br>
12    ///   - [`admin_user_password(impl Into<String>)`](crate::operation::update_cluster::builders::UpdateClusterFluentBuilder::admin_user_password) / [`set_admin_user_password(Option<String>)`](crate::operation::update_cluster::builders::UpdateClusterFluentBuilder::set_admin_user_password):<br>required: **false**<br><p>The password associated with the elastic cluster administrator. This password can contain any printable ASCII character except forward slash (/), double quote ("), or the "at" symbol (@).</p> <p><i>Constraints</i>: Must contain from 8 to 100 characters.</p><br>
13    ///   - [`client_token(impl Into<String>)`](crate::operation::update_cluster::builders::UpdateClusterFluentBuilder::client_token) / [`set_client_token(Option<String>)`](crate::operation::update_cluster::builders::UpdateClusterFluentBuilder::set_client_token):<br>required: **false**<br><p>The client token for the elastic cluster.</p><br>
14    ///   - [`preferred_maintenance_window(impl Into<String>)`](crate::operation::update_cluster::builders::UpdateClusterFluentBuilder::preferred_maintenance_window) / [`set_preferred_maintenance_window(Option<String>)`](crate::operation::update_cluster::builders::UpdateClusterFluentBuilder::set_preferred_maintenance_window):<br>required: **false**<br><p>The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).</p> <p><i>Format</i>: <code>ddd:hh24:mi-ddd:hh24:mi</code></p> <p><i>Default</i>: a 30-minute window selected at random from an 8-hour block of time for each Amazon Web Services Region, occurring on a random day of the week.</p> <p><i>Valid days</i>: Mon, Tue, Wed, Thu, Fri, Sat, Sun</p> <p><i>Constraints</i>: Minimum 30-minute window.</p><br>
15    ///   - [`backup_retention_period(i32)`](crate::operation::update_cluster::builders::UpdateClusterFluentBuilder::backup_retention_period) / [`set_backup_retention_period(Option<i32>)`](crate::operation::update_cluster::builders::UpdateClusterFluentBuilder::set_backup_retention_period):<br>required: **false**<br><p>The number of days for which automatic snapshots are retained.</p><br>
16    ///   - [`preferred_backup_window(impl Into<String>)`](crate::operation::update_cluster::builders::UpdateClusterFluentBuilder::preferred_backup_window) / [`set_preferred_backup_window(Option<String>)`](crate::operation::update_cluster::builders::UpdateClusterFluentBuilder::set_preferred_backup_window):<br>required: **false**<br><p>The daily time range during which automated backups are created if automated backups are enabled, as determined by the <code>backupRetentionPeriod</code>.</p><br>
17    ///   - [`shard_instance_count(i32)`](crate::operation::update_cluster::builders::UpdateClusterFluentBuilder::shard_instance_count) / [`set_shard_instance_count(Option<i32>)`](crate::operation::update_cluster::builders::UpdateClusterFluentBuilder::set_shard_instance_count):<br>required: **false**<br><p>The number of replica instances applying to all shards in the elastic cluster. A <code>shardInstanceCount</code> value of 1 means there is one writer instance, and any additional instances are replicas that can be used for reads and to improve availability.</p><br>
18    /// - On success, responds with [`UpdateClusterOutput`](crate::operation::update_cluster::UpdateClusterOutput) with field(s):
19    ///   - [`cluster(Option<Cluster>)`](crate::operation::update_cluster::UpdateClusterOutput::cluster): <p>Returns information about the updated elastic cluster.</p>
20    /// - On failure, responds with [`SdkError<UpdateClusterError>`](crate::operation::update_cluster::UpdateClusterError)
21    pub fn update_cluster(&self) -> crate::operation::update_cluster::builders::UpdateClusterFluentBuilder {
22        crate::operation::update_cluster::builders::UpdateClusterFluentBuilder::new(self.handle.clone())
23    }
24}