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
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
pub use crate::operation::export_image::_export_image_output::ExportImageOutputBuilder;
pub use crate::operation::export_image::_export_image_input::ExportImageInputBuilder;
/// Fluent builder constructing a request to `ExportImage`.
///
/// <p>Exports an Amazon Machine Image (AMI) to a VM file. For more information, see <a href="https://docs.aws.amazon.com/vm-import/latest/userguide/vmexport_image.html">Exporting a VM directly from an Amazon Machine Image (AMI)</a> in the <i>VM Import/Export User Guide</i>.</p>
#[derive(std::clone::Clone, std::fmt::Debug)]
pub struct ExportImageFluentBuilder {
handle: std::sync::Arc<crate::client::Handle>,
inner: crate::operation::export_image::builders::ExportImageInputBuilder,
}
impl ExportImageFluentBuilder {
/// Creates a new `ExportImage`.
pub(crate) fn new(handle: std::sync::Arc<crate::client::Handle>) -> Self {
Self {
handle,
inner: Default::default(),
}
}
/// 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 customize(
self,
) -> std::result::Result<
crate::client::customize::CustomizableOperation<
crate::operation::export_image::ExportImage,
aws_http::retry::AwsResponseRetryClassifier,
>,
aws_smithy_http::result::SdkError<crate::operation::export_image::ExportImageError>,
> {
let handle = self.handle.clone();
let operation = self
.inner
.build()
.map_err(aws_smithy_http::result::SdkError::construction_failure)?
.make_operation(&handle.conf)
.await
.map_err(aws_smithy_http::result::SdkError::construction_failure)?;
Ok(crate::client::customize::CustomizableOperation { handle, operation })
}
/// 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::export_image::ExportImageOutput,
aws_smithy_http::result::SdkError<crate::operation::export_image::ExportImageError>,
> {
let op = self
.inner
.build()
.map_err(aws_smithy_http::result::SdkError::construction_failure)?
.make_operation(&self.handle.conf)
.await
.map_err(aws_smithy_http::result::SdkError::construction_failure)?;
self.handle.client.call(op).await
}
/// <p>Token to enable idempotency for export image requests.</p>
pub fn client_token(mut self, input: impl Into<std::string::String>) -> Self {
self.inner = self.inner.client_token(input.into());
self
}
/// <p>Token to enable idempotency for export image requests.</p>
pub fn set_client_token(mut self, input: std::option::Option<std::string::String>) -> Self {
self.inner = self.inner.set_client_token(input);
self
}
/// <p>A description of the image being exported. The maximum length is 255 characters.</p>
pub fn description(mut self, input: impl Into<std::string::String>) -> Self {
self.inner = self.inner.description(input.into());
self
}
/// <p>A description of the image being exported. The maximum length is 255 characters.</p>
pub fn set_description(mut self, input: std::option::Option<std::string::String>) -> Self {
self.inner = self.inner.set_description(input);
self
}
/// <p>The disk image format.</p>
pub fn disk_image_format(mut self, input: crate::types::DiskImageFormat) -> Self {
self.inner = self.inner.disk_image_format(input);
self
}
/// <p>The disk image format.</p>
pub fn set_disk_image_format(
mut self,
input: std::option::Option<crate::types::DiskImageFormat>,
) -> Self {
self.inner = self.inner.set_disk_image_format(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 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>The ID of the image.</p>
pub fn image_id(mut self, input: impl Into<std::string::String>) -> Self {
self.inner = self.inner.image_id(input.into());
self
}
/// <p>The ID of the image.</p>
pub fn set_image_id(mut self, input: std::option::Option<std::string::String>) -> Self {
self.inner = self.inner.set_image_id(input);
self
}
/// <p>The Amazon S3 bucket for the destination image. The destination bucket must exist.</p>
pub fn s3_export_location(mut self, input: crate::types::ExportTaskS3LocationRequest) -> Self {
self.inner = self.inner.s3_export_location(input);
self
}
/// <p>The Amazon S3 bucket for the destination image. The destination bucket must exist.</p>
pub fn set_s3_export_location(
mut self,
input: std::option::Option<crate::types::ExportTaskS3LocationRequest>,
) -> Self {
self.inner = self.inner.set_s3_export_location(input);
self
}
/// <p>The name of the role that grants VM Import/Export permission to export images to your Amazon S3 bucket. If this parameter is not specified, the default role is named 'vmimport'.</p>
pub fn role_name(mut self, input: impl Into<std::string::String>) -> Self {
self.inner = self.inner.role_name(input.into());
self
}
/// <p>The name of the role that grants VM Import/Export permission to export images to your Amazon S3 bucket. If this parameter is not specified, the default role is named 'vmimport'.</p>
pub fn set_role_name(mut self, input: std::option::Option<std::string::String>) -> Self {
self.inner = self.inner.set_role_name(input);
self
}
/// Appends an item to `TagSpecifications`.
///
/// To override the contents of this collection use [`set_tag_specifications`](Self::set_tag_specifications).
///
/// <p>The tags to apply to the export image task during creation.</p>
pub fn tag_specifications(mut self, input: crate::types::TagSpecification) -> Self {
self.inner = self.inner.tag_specifications(input);
self
}
/// <p>The tags to apply to the export image task during creation.</p>
pub fn set_tag_specifications(
mut self,
input: std::option::Option<std::vec::Vec<crate::types::TagSpecification>>,
) -> Self {
self.inner = self.inner.set_tag_specifications(input);
self
}
}