1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
pub use crate::operation::modify_volume::_modify_volume_output::ModifyVolumeOutputBuilder;
pub use crate::operation::modify_volume::_modify_volume_input::ModifyVolumeInputBuilder;
impl crate::operation::modify_volume::builders::ModifyVolumeInputBuilder {
/// Sends a request with this input using the given client.
pub async fn send_with(
self,
client: &crate::Client,
) -> ::std::result::Result<
crate::operation::modify_volume::ModifyVolumeOutput,
::aws_smithy_runtime_api::client::result::SdkError<
crate::operation::modify_volume::ModifyVolumeError,
::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
>,
> {
let mut fluent_builder = client.modify_volume();
fluent_builder.inner = self;
fluent_builder.send().await
}
}
/// Fluent builder constructing a request to `ModifyVolume`.
///
/// <p>You can modify several parameters of an existing EBS volume, including volume size, volume type, and IOPS capacity. If your EBS volume is attached to a current-generation EC2 instance type, you might be able to apply these changes without stopping the instance or detaching the volume from it. For more information about modifying EBS volumes, see <a href="https://docs.aws.amazon.com/ebs/latest/userguide/ebs-modify-volume.html">Amazon EBS Elastic Volumes</a> in the <i>Amazon EBS User Guide</i>.</p>
/// <p>When you complete a resize operation on your volume, you need to extend the volume's file-system size to take advantage of the new storage capacity. For more information, see <a href="https://docs.aws.amazon.com/ebs/latest/userguide/recognize-expanded-volume-linux.html">Extend the file system</a>.</p>
/// <p>For more information, see <a href="https://docs.aws.amazon.com/ebs/latest/userguide/monitoring-volume-modifications.html">Monitor the progress of volume modifications</a> in the <i>Amazon EBS User Guide</i>.</p>
/// <p>With previous-generation instance types, resizing an EBS volume might require detaching and reattaching the volume or stopping and restarting the instance.</p>
/// <p>After modifying a volume, you must wait at least six hours and ensure that the volume is in the <code>in-use</code> or <code>available</code> state before you can modify the same volume. This is sometimes referred to as a cooldown period.</p>
#[derive(::std::clone::Clone, ::std::fmt::Debug)]
pub struct ModifyVolumeFluentBuilder {
handle: ::std::sync::Arc<crate::client::Handle>,
inner: crate::operation::modify_volume::builders::ModifyVolumeInputBuilder,
config_override: ::std::option::Option<crate::config::Builder>,
}
impl
crate::client::customize::internal::CustomizableSend<
crate::operation::modify_volume::ModifyVolumeOutput,
crate::operation::modify_volume::ModifyVolumeError,
> for ModifyVolumeFluentBuilder
{
fn send(
self,
config_override: crate::config::Builder,
) -> crate::client::customize::internal::BoxFuture<
crate::client::customize::internal::SendResult<
crate::operation::modify_volume::ModifyVolumeOutput,
crate::operation::modify_volume::ModifyVolumeError,
>,
> {
::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
}
}
impl ModifyVolumeFluentBuilder {
/// Creates a new `ModifyVolumeFluentBuilder`.
pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
Self {
handle,
inner: ::std::default::Default::default(),
config_override: ::std::option::Option::None,
}
}
/// Access the ModifyVolume as a reference.
pub fn as_input(&self) -> &crate::operation::modify_volume::builders::ModifyVolumeInputBuilder {
&self.inner
}
/// 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](aws_smithy_types::retry::RetryConfig), which can be
/// set when configuring the client.
pub async fn send(
self,
) -> ::std::result::Result<
crate::operation::modify_volume::ModifyVolumeOutput,
::aws_smithy_runtime_api::client::result::SdkError<
crate::operation::modify_volume::ModifyVolumeError,
::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
>,
> {
let input = self
.inner
.build()
.map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
let runtime_plugins = crate::operation::modify_volume::ModifyVolume::operation_runtime_plugins(
self.handle.runtime_plugins.clone(),
&self.handle.conf,
self.config_override,
);
crate::operation::modify_volume::ModifyVolume::orchestrate(&runtime_plugins, input).await
}
/// Consumes this builder, creating a customizable operation that can be modified before being sent.
pub fn customize(
self,
) -> crate::client::customize::CustomizableOperation<
crate::operation::modify_volume::ModifyVolumeOutput,
crate::operation::modify_volume::ModifyVolumeError,
Self,
> {
crate::client::customize::CustomizableOperation::new(self)
}
pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
self.set_config_override(::std::option::Option::Some(config_override.into()));
self
}
pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
self.config_override = config_override;
self
}
/// <p>Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.</p>
pub fn dry_run(mut self, input: bool) -> Self {
self.inner = self.inner.dry_run(input);
self
}
/// <p>Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.</p>
pub fn set_dry_run(mut self, input: ::std::option::Option<bool>) -> Self {
self.inner = self.inner.set_dry_run(input);
self
}
/// <p>Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.</p>
pub fn get_dry_run(&self) -> &::std::option::Option<bool> {
self.inner.get_dry_run()
}
/// <p>The ID of the volume.</p>
pub fn volume_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.inner = self.inner.volume_id(input.into());
self
}
/// <p>The ID of the volume.</p>
pub fn set_volume_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.inner = self.inner.set_volume_id(input);
self
}
/// <p>The ID of the volume.</p>
pub fn get_volume_id(&self) -> &::std::option::Option<::std::string::String> {
self.inner.get_volume_id()
}
/// <p>The target size of the volume, in GiB. The target volume size must be greater than or equal to the existing size of the volume.</p>
/// <p>The following are the supported volumes sizes for each volume type:</p>
/// <ul>
/// <li>
/// <p><code>gp2</code> and <code>gp3</code>: 1 - 16,384 GiB</p></li>
/// <li>
/// <p><code>io1</code>: 4 - 16,384 GiB</p></li>
/// <li>
/// <p><code>io2</code>: 4 - 65,536 GiB</p></li>
/// <li>
/// <p><code>st1</code> and <code>sc1</code>: 125 - 16,384 GiB</p></li>
/// <li>
/// <p><code>standard</code>: 1 - 1024 GiB</p></li>
/// </ul>
/// <p>Default: The existing size is retained.</p>
pub fn size(mut self, input: i32) -> Self {
self.inner = self.inner.size(input);
self
}
/// <p>The target size of the volume, in GiB. The target volume size must be greater than or equal to the existing size of the volume.</p>
/// <p>The following are the supported volumes sizes for each volume type:</p>
/// <ul>
/// <li>
/// <p><code>gp2</code> and <code>gp3</code>: 1 - 16,384 GiB</p></li>
/// <li>
/// <p><code>io1</code>: 4 - 16,384 GiB</p></li>
/// <li>
/// <p><code>io2</code>: 4 - 65,536 GiB</p></li>
/// <li>
/// <p><code>st1</code> and <code>sc1</code>: 125 - 16,384 GiB</p></li>
/// <li>
/// <p><code>standard</code>: 1 - 1024 GiB</p></li>
/// </ul>
/// <p>Default: The existing size is retained.</p>
pub fn set_size(mut self, input: ::std::option::Option<i32>) -> Self {
self.inner = self.inner.set_size(input);
self
}
/// <p>The target size of the volume, in GiB. The target volume size must be greater than or equal to the existing size of the volume.</p>
/// <p>The following are the supported volumes sizes for each volume type:</p>
/// <ul>
/// <li>
/// <p><code>gp2</code> and <code>gp3</code>: 1 - 16,384 GiB</p></li>
/// <li>
/// <p><code>io1</code>: 4 - 16,384 GiB</p></li>
/// <li>
/// <p><code>io2</code>: 4 - 65,536 GiB</p></li>
/// <li>
/// <p><code>st1</code> and <code>sc1</code>: 125 - 16,384 GiB</p></li>
/// <li>
/// <p><code>standard</code>: 1 - 1024 GiB</p></li>
/// </ul>
/// <p>Default: The existing size is retained.</p>
pub fn get_size(&self) -> &::std::option::Option<i32> {
self.inner.get_size()
}
/// <p>The target EBS volume type of the volume. For more information, see <a href="https://docs.aws.amazon.com/ebs/latest/userguide/ebs-volume-types.html">Amazon EBS volume types</a> in the <i>Amazon EBS User Guide</i>.</p>
/// <p>Default: The existing type is retained.</p>
pub fn volume_type(mut self, input: crate::types::VolumeType) -> Self {
self.inner = self.inner.volume_type(input);
self
}
/// <p>The target EBS volume type of the volume. For more information, see <a href="https://docs.aws.amazon.com/ebs/latest/userguide/ebs-volume-types.html">Amazon EBS volume types</a> in the <i>Amazon EBS User Guide</i>.</p>
/// <p>Default: The existing type is retained.</p>
pub fn set_volume_type(mut self, input: ::std::option::Option<crate::types::VolumeType>) -> Self {
self.inner = self.inner.set_volume_type(input);
self
}
/// <p>The target EBS volume type of the volume. For more information, see <a href="https://docs.aws.amazon.com/ebs/latest/userguide/ebs-volume-types.html">Amazon EBS volume types</a> in the <i>Amazon EBS User Guide</i>.</p>
/// <p>Default: The existing type is retained.</p>
pub fn get_volume_type(&self) -> &::std::option::Option<crate::types::VolumeType> {
self.inner.get_volume_type()
}
/// <p>The target IOPS rate of the volume. This parameter is valid only for <code>gp3</code>, <code>io1</code>, and <code>io2</code> volumes.</p>
/// <p>The following are the supported values for each volume type:</p>
/// <ul>
/// <li>
/// <p><code>gp3</code>: 3,000 - 16,000 IOPS</p></li>
/// <li>
/// <p><code>io1</code>: 100 - 64,000 IOPS</p></li>
/// <li>
/// <p><code>io2</code>: 100 - 256,000 IOPS</p></li>
/// </ul>
/// <p>For <code>io2</code> volumes, you can achieve up to 256,000 IOPS on <a href="https://docs.aws.amazon.com/ec2/latest/instancetypes/ec2-nitro-instances.html">instances built on the Nitro System</a>. On other instances, you can achieve performance up to 32,000 IOPS.</p>
/// <p>Default: The existing value is retained if you keep the same volume type. If you change the volume type to <code>io1</code>, <code>io2</code>, or <code>gp3</code>, the default is 3,000.</p>
pub fn iops(mut self, input: i32) -> Self {
self.inner = self.inner.iops(input);
self
}
/// <p>The target IOPS rate of the volume. This parameter is valid only for <code>gp3</code>, <code>io1</code>, and <code>io2</code> volumes.</p>
/// <p>The following are the supported values for each volume type:</p>
/// <ul>
/// <li>
/// <p><code>gp3</code>: 3,000 - 16,000 IOPS</p></li>
/// <li>
/// <p><code>io1</code>: 100 - 64,000 IOPS</p></li>
/// <li>
/// <p><code>io2</code>: 100 - 256,000 IOPS</p></li>
/// </ul>
/// <p>For <code>io2</code> volumes, you can achieve up to 256,000 IOPS on <a href="https://docs.aws.amazon.com/ec2/latest/instancetypes/ec2-nitro-instances.html">instances built on the Nitro System</a>. On other instances, you can achieve performance up to 32,000 IOPS.</p>
/// <p>Default: The existing value is retained if you keep the same volume type. If you change the volume type to <code>io1</code>, <code>io2</code>, or <code>gp3</code>, the default is 3,000.</p>
pub fn set_iops(mut self, input: ::std::option::Option<i32>) -> Self {
self.inner = self.inner.set_iops(input);
self
}
/// <p>The target IOPS rate of the volume. This parameter is valid only for <code>gp3</code>, <code>io1</code>, and <code>io2</code> volumes.</p>
/// <p>The following are the supported values for each volume type:</p>
/// <ul>
/// <li>
/// <p><code>gp3</code>: 3,000 - 16,000 IOPS</p></li>
/// <li>
/// <p><code>io1</code>: 100 - 64,000 IOPS</p></li>
/// <li>
/// <p><code>io2</code>: 100 - 256,000 IOPS</p></li>
/// </ul>
/// <p>For <code>io2</code> volumes, you can achieve up to 256,000 IOPS on <a href="https://docs.aws.amazon.com/ec2/latest/instancetypes/ec2-nitro-instances.html">instances built on the Nitro System</a>. On other instances, you can achieve performance up to 32,000 IOPS.</p>
/// <p>Default: The existing value is retained if you keep the same volume type. If you change the volume type to <code>io1</code>, <code>io2</code>, or <code>gp3</code>, the default is 3,000.</p>
pub fn get_iops(&self) -> &::std::option::Option<i32> {
self.inner.get_iops()
}
/// <p>The target throughput of the volume, in MiB/s. This parameter is valid only for <code>gp3</code> volumes. The maximum value is 1,000.</p>
/// <p>Default: The existing value is retained if the source and target volume type is <code>gp3</code>. Otherwise, the default value is 125.</p>
/// <p>Valid Range: Minimum value of 125. Maximum value of 1000.</p>
pub fn throughput(mut self, input: i32) -> Self {
self.inner = self.inner.throughput(input);
self
}
/// <p>The target throughput of the volume, in MiB/s. This parameter is valid only for <code>gp3</code> volumes. The maximum value is 1,000.</p>
/// <p>Default: The existing value is retained if the source and target volume type is <code>gp3</code>. Otherwise, the default value is 125.</p>
/// <p>Valid Range: Minimum value of 125. Maximum value of 1000.</p>
pub fn set_throughput(mut self, input: ::std::option::Option<i32>) -> Self {
self.inner = self.inner.set_throughput(input);
self
}
/// <p>The target throughput of the volume, in MiB/s. This parameter is valid only for <code>gp3</code> volumes. The maximum value is 1,000.</p>
/// <p>Default: The existing value is retained if the source and target volume type is <code>gp3</code>. Otherwise, the default value is 125.</p>
/// <p>Valid Range: Minimum value of 125. Maximum value of 1000.</p>
pub fn get_throughput(&self) -> &::std::option::Option<i32> {
self.inner.get_throughput()
}
/// <p>Specifies whether to enable Amazon EBS Multi-Attach. If you enable Multi-Attach, you can attach the volume to up to 16 <a href="https://docs.aws.amazon.com/ec2/latest/instancetypes/ec2-nitro-instances.html"> Nitro-based instances</a> in the same Availability Zone. This parameter is supported with <code>io1</code> and <code>io2</code> volumes only. For more information, see <a href="https://docs.aws.amazon.com/ebs/latest/userguide/ebs-volumes-multi.html"> Amazon EBS Multi-Attach</a> in the <i>Amazon EBS User Guide</i>.</p>
pub fn multi_attach_enabled(mut self, input: bool) -> Self {
self.inner = self.inner.multi_attach_enabled(input);
self
}
/// <p>Specifies whether to enable Amazon EBS Multi-Attach. If you enable Multi-Attach, you can attach the volume to up to 16 <a href="https://docs.aws.amazon.com/ec2/latest/instancetypes/ec2-nitro-instances.html"> Nitro-based instances</a> in the same Availability Zone. This parameter is supported with <code>io1</code> and <code>io2</code> volumes only. For more information, see <a href="https://docs.aws.amazon.com/ebs/latest/userguide/ebs-volumes-multi.html"> Amazon EBS Multi-Attach</a> in the <i>Amazon EBS User Guide</i>.</p>
pub fn set_multi_attach_enabled(mut self, input: ::std::option::Option<bool>) -> Self {
self.inner = self.inner.set_multi_attach_enabled(input);
self
}
/// <p>Specifies whether to enable Amazon EBS Multi-Attach. If you enable Multi-Attach, you can attach the volume to up to 16 <a href="https://docs.aws.amazon.com/ec2/latest/instancetypes/ec2-nitro-instances.html"> Nitro-based instances</a> in the same Availability Zone. This parameter is supported with <code>io1</code> and <code>io2</code> volumes only. For more information, see <a href="https://docs.aws.amazon.com/ebs/latest/userguide/ebs-volumes-multi.html"> Amazon EBS Multi-Attach</a> in the <i>Amazon EBS User Guide</i>.</p>
pub fn get_multi_attach_enabled(&self) -> &::std::option::Option<bool> {
self.inner.get_multi_attach_enabled()
}
}