aws_sdk_ec2/operation/create_store_image_task/
builders.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::create_store_image_task::_create_store_image_task_output::CreateStoreImageTaskOutputBuilder;
3
4pub use crate::operation::create_store_image_task::_create_store_image_task_input::CreateStoreImageTaskInputBuilder;
5
6impl crate::operation::create_store_image_task::builders::CreateStoreImageTaskInputBuilder {
7    /// Sends a request with this input using the given client.
8    pub async fn send_with(
9        self,
10        client: &crate::Client,
11    ) -> ::std::result::Result<
12        crate::operation::create_store_image_task::CreateStoreImageTaskOutput,
13        ::aws_smithy_runtime_api::client::result::SdkError<
14            crate::operation::create_store_image_task::CreateStoreImageTaskError,
15            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16        >,
17    > {
18        let mut fluent_builder = client.create_store_image_task();
19        fluent_builder.inner = self;
20        fluent_builder.send().await
21    }
22}
23/// Fluent builder constructing a request to `CreateStoreImageTask`.
24///
25/// <p>Stores an AMI as a single object in an Amazon S3 bucket.</p>
26/// <p>To use this API, you must have the required permissions. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/work-with-ami-store-restore.html#ami-s3-permissions">Permissions for storing and restoring AMIs using S3</a> in the <i>Amazon EC2 User Guide</i>.</p>
27/// <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-store-restore.html">Store and restore an AMI using S3</a> in the <i>Amazon EC2 User Guide</i>.</p>
28#[derive(::std::clone::Clone, ::std::fmt::Debug)]
29pub struct CreateStoreImageTaskFluentBuilder {
30    handle: ::std::sync::Arc<crate::client::Handle>,
31    inner: crate::operation::create_store_image_task::builders::CreateStoreImageTaskInputBuilder,
32    config_override: ::std::option::Option<crate::config::Builder>,
33}
34impl
35    crate::client::customize::internal::CustomizableSend<
36        crate::operation::create_store_image_task::CreateStoreImageTaskOutput,
37        crate::operation::create_store_image_task::CreateStoreImageTaskError,
38    > for CreateStoreImageTaskFluentBuilder
39{
40    fn send(
41        self,
42        config_override: crate::config::Builder,
43    ) -> crate::client::customize::internal::BoxFuture<
44        crate::client::customize::internal::SendResult<
45            crate::operation::create_store_image_task::CreateStoreImageTaskOutput,
46            crate::operation::create_store_image_task::CreateStoreImageTaskError,
47        >,
48    > {
49        ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
50    }
51}
52impl CreateStoreImageTaskFluentBuilder {
53    /// Creates a new `CreateStoreImageTaskFluentBuilder`.
54    pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
55        Self {
56            handle,
57            inner: ::std::default::Default::default(),
58            config_override: ::std::option::Option::None,
59        }
60    }
61    /// Access the CreateStoreImageTask as a reference.
62    pub fn as_input(&self) -> &crate::operation::create_store_image_task::builders::CreateStoreImageTaskInputBuilder {
63        &self.inner
64    }
65    /// Sends the request and returns the response.
66    ///
67    /// If an error occurs, an `SdkError` will be returned with additional details that
68    /// can be matched against.
69    ///
70    /// By default, any retryable failures will be retried twice. Retry behavior
71    /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
72    /// set when configuring the client.
73    pub async fn send(
74        self,
75    ) -> ::std::result::Result<
76        crate::operation::create_store_image_task::CreateStoreImageTaskOutput,
77        ::aws_smithy_runtime_api::client::result::SdkError<
78            crate::operation::create_store_image_task::CreateStoreImageTaskError,
79            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
80        >,
81    > {
82        let input = self
83            .inner
84            .build()
85            .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
86        let runtime_plugins = crate::operation::create_store_image_task::CreateStoreImageTask::operation_runtime_plugins(
87            self.handle.runtime_plugins.clone(),
88            &self.handle.conf,
89            self.config_override,
90        );
91        crate::operation::create_store_image_task::CreateStoreImageTask::orchestrate(&runtime_plugins, input).await
92    }
93
94    /// Consumes this builder, creating a customizable operation that can be modified before being sent.
95    pub fn customize(
96        self,
97    ) -> crate::client::customize::CustomizableOperation<
98        crate::operation::create_store_image_task::CreateStoreImageTaskOutput,
99        crate::operation::create_store_image_task::CreateStoreImageTaskError,
100        Self,
101    > {
102        crate::client::customize::CustomizableOperation::new(self)
103    }
104    pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
105        self.set_config_override(::std::option::Option::Some(config_override.into()));
106        self
107    }
108
109    pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
110        self.config_override = config_override;
111        self
112    }
113    /// <p>The ID of the AMI.</p>
114    pub fn image_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
115        self.inner = self.inner.image_id(input.into());
116        self
117    }
118    /// <p>The ID of the AMI.</p>
119    pub fn set_image_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
120        self.inner = self.inner.set_image_id(input);
121        self
122    }
123    /// <p>The ID of the AMI.</p>
124    pub fn get_image_id(&self) -> &::std::option::Option<::std::string::String> {
125        self.inner.get_image_id()
126    }
127    /// <p>The name of the Amazon S3 bucket in which the AMI object will be stored. The bucket must be in the Region in which the request is being made. The AMI object appears in the bucket only after the upload task has completed.</p>
128    pub fn bucket(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
129        self.inner = self.inner.bucket(input.into());
130        self
131    }
132    /// <p>The name of the Amazon S3 bucket in which the AMI object will be stored. The bucket must be in the Region in which the request is being made. The AMI object appears in the bucket only after the upload task has completed.</p>
133    pub fn set_bucket(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
134        self.inner = self.inner.set_bucket(input);
135        self
136    }
137    /// <p>The name of the Amazon S3 bucket in which the AMI object will be stored. The bucket must be in the Region in which the request is being made. The AMI object appears in the bucket only after the upload task has completed.</p>
138    pub fn get_bucket(&self) -> &::std::option::Option<::std::string::String> {
139        self.inner.get_bucket()
140    }
141    ///
142    /// Appends an item to `S3ObjectTags`.
143    ///
144    /// To override the contents of this collection use [`set_s3_object_tags`](Self::set_s3_object_tags).
145    ///
146    /// <p>The tags to apply to the AMI object that will be stored in the Amazon S3 bucket.</p>
147    pub fn s3_object_tags(mut self, input: crate::types::S3ObjectTag) -> Self {
148        self.inner = self.inner.s3_object_tags(input);
149        self
150    }
151    /// <p>The tags to apply to the AMI object that will be stored in the Amazon S3 bucket.</p>
152    pub fn set_s3_object_tags(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::S3ObjectTag>>) -> Self {
153        self.inner = self.inner.set_s3_object_tags(input);
154        self
155    }
156    /// <p>The tags to apply to the AMI object that will be stored in the Amazon S3 bucket.</p>
157    pub fn get_s3_object_tags(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::S3ObjectTag>> {
158        self.inner.get_s3_object_tags()
159    }
160    /// <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>
161    pub fn dry_run(mut self, input: bool) -> Self {
162        self.inner = self.inner.dry_run(input);
163        self
164    }
165    /// <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>
166    pub fn set_dry_run(mut self, input: ::std::option::Option<bool>) -> Self {
167        self.inner = self.inner.set_dry_run(input);
168        self
169    }
170    /// <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>
171    pub fn get_dry_run(&self) -> &::std::option::Option<bool> {
172        self.inner.get_dry_run()
173    }
174}