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

// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
pub use crate::operation::create_flywheel::_create_flywheel_output::CreateFlywheelOutputBuilder;

pub use crate::operation::create_flywheel::_create_flywheel_input::CreateFlywheelInputBuilder;

/// Fluent builder constructing a request to `CreateFlywheel`.
///
/// <p>A flywheel is an Amazon Web Services resource that orchestrates the ongoing training of a model for custom classification or custom entity recognition. You can create a flywheel to start with an existing trained model, or Comprehend can create and train a new model.</p>
/// <p>When you create the flywheel, Comprehend creates a data lake in your account. The data lake holds the training data and test data for all versions of the model.</p>
/// <p>To use a flywheel with an existing trained model, you specify the active model version. Comprehend copies the model's training data and test data into the flywheel's data lake.</p>
/// <p>To use the flywheel with a new model, you need to provide a dataset for training data (and optional test data) when you create the flywheel.</p>
/// <p>For more information about flywheels, see <a href="https://docs.aws.amazon.com/comprehend/latest/dg/flywheels-about.html"> Flywheel overview</a> in the <i>Amazon Comprehend Developer Guide</i>.</p>
#[derive(std::clone::Clone, std::fmt::Debug)]
pub struct CreateFlywheelFluentBuilder {
    handle: std::sync::Arc<crate::client::Handle>,
    inner: crate::operation::create_flywheel::builders::CreateFlywheelInputBuilder,
}
impl CreateFlywheelFluentBuilder {
    /// Creates a new `CreateFlywheel`.
    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::create_flywheel::CreateFlywheel,
            aws_http::retry::AwsResponseRetryClassifier,
        >,
        aws_smithy_http::result::SdkError<crate::operation::create_flywheel::CreateFlywheelError>,
    > {
        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::create_flywheel::CreateFlywheelOutput,
        aws_smithy_http::result::SdkError<crate::operation::create_flywheel::CreateFlywheelError>,
    > {
        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>Name for the flywheel.</p>
    pub fn flywheel_name(mut self, input: impl Into<std::string::String>) -> Self {
        self.inner = self.inner.flywheel_name(input.into());
        self
    }
    /// <p>Name for the flywheel.</p>
    pub fn set_flywheel_name(mut self, input: std::option::Option<std::string::String>) -> Self {
        self.inner = self.inner.set_flywheel_name(input);
        self
    }
    /// <p>To associate an existing model with the flywheel, specify the Amazon Resource Number (ARN) of the model version.</p>
    pub fn active_model_arn(mut self, input: impl Into<std::string::String>) -> Self {
        self.inner = self.inner.active_model_arn(input.into());
        self
    }
    /// <p>To associate an existing model with the flywheel, specify the Amazon Resource Number (ARN) of the model version.</p>
    pub fn set_active_model_arn(mut self, input: std::option::Option<std::string::String>) -> Self {
        self.inner = self.inner.set_active_model_arn(input);
        self
    }
    /// <p>The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend the permissions required to access the flywheel data in the data lake.</p>
    pub fn data_access_role_arn(mut self, input: impl Into<std::string::String>) -> Self {
        self.inner = self.inner.data_access_role_arn(input.into());
        self
    }
    /// <p>The Amazon Resource Name (ARN) of the IAM role that grants Amazon Comprehend the permissions required to access the flywheel data in the data lake.</p>
    pub fn set_data_access_role_arn(
        mut self,
        input: std::option::Option<std::string::String>,
    ) -> Self {
        self.inner = self.inner.set_data_access_role_arn(input);
        self
    }
    /// <p>Configuration about the custom classifier associated with the flywheel.</p>
    pub fn task_config(mut self, input: crate::types::TaskConfig) -> Self {
        self.inner = self.inner.task_config(input);
        self
    }
    /// <p>Configuration about the custom classifier associated with the flywheel.</p>
    pub fn set_task_config(mut self, input: std::option::Option<crate::types::TaskConfig>) -> Self {
        self.inner = self.inner.set_task_config(input);
        self
    }
    /// <p>The model type.</p>
    pub fn model_type(mut self, input: crate::types::ModelType) -> Self {
        self.inner = self.inner.model_type(input);
        self
    }
    /// <p>The model type.</p>
    pub fn set_model_type(mut self, input: std::option::Option<crate::types::ModelType>) -> Self {
        self.inner = self.inner.set_model_type(input);
        self
    }
    /// <p>Enter the S3 location for the data lake. You can specify a new S3 bucket or a new folder of an existing S3 bucket. The flywheel creates the data lake at this location.</p>
    pub fn data_lake_s3_uri(mut self, input: impl Into<std::string::String>) -> Self {
        self.inner = self.inner.data_lake_s3_uri(input.into());
        self
    }
    /// <p>Enter the S3 location for the data lake. You can specify a new S3 bucket or a new folder of an existing S3 bucket. The flywheel creates the data lake at this location.</p>
    pub fn set_data_lake_s3_uri(mut self, input: std::option::Option<std::string::String>) -> Self {
        self.inner = self.inner.set_data_lake_s3_uri(input);
        self
    }
    /// <p>Data security configurations.</p>
    pub fn data_security_config(mut self, input: crate::types::DataSecurityConfig) -> Self {
        self.inner = self.inner.data_security_config(input);
        self
    }
    /// <p>Data security configurations.</p>
    pub fn set_data_security_config(
        mut self,
        input: std::option::Option<crate::types::DataSecurityConfig>,
    ) -> Self {
        self.inner = self.inner.set_data_security_config(input);
        self
    }
    /// <p>A unique identifier for the request. If you don't set the client request token, Amazon Comprehend generates one.</p>
    pub fn client_request_token(mut self, input: impl Into<std::string::String>) -> Self {
        self.inner = self.inner.client_request_token(input.into());
        self
    }
    /// <p>A unique identifier for the request. If you don't set the client request token, Amazon Comprehend generates one.</p>
    pub fn set_client_request_token(
        mut self,
        input: std::option::Option<std::string::String>,
    ) -> Self {
        self.inner = self.inner.set_client_request_token(input);
        self
    }
    /// Appends an item to `Tags`.
    ///
    /// To override the contents of this collection use [`set_tags`](Self::set_tags).
    ///
    /// <p>The tags to associate with this flywheel.</p>
    pub fn tags(mut self, input: crate::types::Tag) -> Self {
        self.inner = self.inner.tags(input);
        self
    }
    /// <p>The tags to associate with this flywheel.</p>
    pub fn set_tags(
        mut self,
        input: std::option::Option<std::vec::Vec<crate::types::Tag>>,
    ) -> Self {
        self.inner = self.inner.set_tags(input);
        self
    }
}