aws_sdk_glue/operation/start_import_labels_task_run/
builders.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::start_import_labels_task_run::_start_import_labels_task_run_input::StartImportLabelsTaskRunInputBuilder;
3
4pub use crate::operation::start_import_labels_task_run::_start_import_labels_task_run_output::StartImportLabelsTaskRunOutputBuilder;
5
6impl crate::operation::start_import_labels_task_run::builders::StartImportLabelsTaskRunInputBuilder {
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::start_import_labels_task_run::StartImportLabelsTaskRunOutput,
13        ::aws_smithy_runtime_api::client::result::SdkError<
14            crate::operation::start_import_labels_task_run::StartImportLabelsTaskRunError,
15            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16        >,
17    > {
18        let mut fluent_builder = client.start_import_labels_task_run();
19        fluent_builder.inner = self;
20        fluent_builder.send().await
21    }
22}
23/// Fluent builder constructing a request to `StartImportLabelsTaskRun`.
24///
25/// <p>Enables you to provide additional labels (examples of truth) to be used to teach the machine learning transform and improve its quality. This API operation is generally used as part of the active learning workflow that starts with the <code>StartMLLabelingSetGenerationTaskRun</code> call and that ultimately results in improving the quality of your machine learning transform.</p>
26/// <p>After the <code>StartMLLabelingSetGenerationTaskRun</code> finishes, Glue machine learning will have generated a series of questions for humans to answer. (Answering these questions is often called 'labeling' in the machine learning workflows). In the case of the <code>FindMatches</code> transform, these questions are of the form, “What is the correct way to group these rows together into groups composed entirely of matching records?” After the labeling process is finished, users upload their answers/labels with a call to <code>StartImportLabelsTaskRun</code>. After <code>StartImportLabelsTaskRun</code> finishes, all future runs of the machine learning transform use the new and improved labels and perform a higher-quality transformation.</p>
27/// <p>By default, <code>StartMLLabelingSetGenerationTaskRun</code> continually learns from and combines all labels that you upload unless you set <code>Replace</code> to true. If you set <code>Replace</code> to true, <code>StartImportLabelsTaskRun</code> deletes and forgets all previously uploaded labels and learns only from the exact set that you upload. Replacing labels can be helpful if you realize that you previously uploaded incorrect labels, and you believe that they are having a negative effect on your transform quality.</p>
28/// <p>You can check on the status of your task run by calling the <code>GetMLTaskRun</code> operation.</p>
29#[derive(::std::clone::Clone, ::std::fmt::Debug)]
30pub struct StartImportLabelsTaskRunFluentBuilder {
31    handle: ::std::sync::Arc<crate::client::Handle>,
32    inner: crate::operation::start_import_labels_task_run::builders::StartImportLabelsTaskRunInputBuilder,
33    config_override: ::std::option::Option<crate::config::Builder>,
34}
35impl
36    crate::client::customize::internal::CustomizableSend<
37        crate::operation::start_import_labels_task_run::StartImportLabelsTaskRunOutput,
38        crate::operation::start_import_labels_task_run::StartImportLabelsTaskRunError,
39    > for StartImportLabelsTaskRunFluentBuilder
40{
41    fn send(
42        self,
43        config_override: crate::config::Builder,
44    ) -> crate::client::customize::internal::BoxFuture<
45        crate::client::customize::internal::SendResult<
46            crate::operation::start_import_labels_task_run::StartImportLabelsTaskRunOutput,
47            crate::operation::start_import_labels_task_run::StartImportLabelsTaskRunError,
48        >,
49    > {
50        ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
51    }
52}
53impl StartImportLabelsTaskRunFluentBuilder {
54    /// Creates a new `StartImportLabelsTaskRunFluentBuilder`.
55    pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
56        Self {
57            handle,
58            inner: ::std::default::Default::default(),
59            config_override: ::std::option::Option::None,
60        }
61    }
62    /// Access the StartImportLabelsTaskRun as a reference.
63    pub fn as_input(&self) -> &crate::operation::start_import_labels_task_run::builders::StartImportLabelsTaskRunInputBuilder {
64        &self.inner
65    }
66    /// Sends the request and returns the response.
67    ///
68    /// If an error occurs, an `SdkError` will be returned with additional details that
69    /// can be matched against.
70    ///
71    /// By default, any retryable failures will be retried twice. Retry behavior
72    /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
73    /// set when configuring the client.
74    pub async fn send(
75        self,
76    ) -> ::std::result::Result<
77        crate::operation::start_import_labels_task_run::StartImportLabelsTaskRunOutput,
78        ::aws_smithy_runtime_api::client::result::SdkError<
79            crate::operation::start_import_labels_task_run::StartImportLabelsTaskRunError,
80            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
81        >,
82    > {
83        let input = self
84            .inner
85            .build()
86            .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
87        let runtime_plugins = crate::operation::start_import_labels_task_run::StartImportLabelsTaskRun::operation_runtime_plugins(
88            self.handle.runtime_plugins.clone(),
89            &self.handle.conf,
90            self.config_override,
91        );
92        crate::operation::start_import_labels_task_run::StartImportLabelsTaskRun::orchestrate(&runtime_plugins, input).await
93    }
94
95    /// Consumes this builder, creating a customizable operation that can be modified before being sent.
96    pub fn customize(
97        self,
98    ) -> crate::client::customize::CustomizableOperation<
99        crate::operation::start_import_labels_task_run::StartImportLabelsTaskRunOutput,
100        crate::operation::start_import_labels_task_run::StartImportLabelsTaskRunError,
101        Self,
102    > {
103        crate::client::customize::CustomizableOperation::new(self)
104    }
105    pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
106        self.set_config_override(::std::option::Option::Some(config_override.into()));
107        self
108    }
109
110    pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
111        self.config_override = config_override;
112        self
113    }
114    /// <p>The unique identifier of the machine learning transform.</p>
115    pub fn transform_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
116        self.inner = self.inner.transform_id(input.into());
117        self
118    }
119    /// <p>The unique identifier of the machine learning transform.</p>
120    pub fn set_transform_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
121        self.inner = self.inner.set_transform_id(input);
122        self
123    }
124    /// <p>The unique identifier of the machine learning transform.</p>
125    pub fn get_transform_id(&self) -> &::std::option::Option<::std::string::String> {
126        self.inner.get_transform_id()
127    }
128    /// <p>The Amazon Simple Storage Service (Amazon S3) path from where you import the labels.</p>
129    pub fn input_s3_path(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
130        self.inner = self.inner.input_s3_path(input.into());
131        self
132    }
133    /// <p>The Amazon Simple Storage Service (Amazon S3) path from where you import the labels.</p>
134    pub fn set_input_s3_path(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
135        self.inner = self.inner.set_input_s3_path(input);
136        self
137    }
138    /// <p>The Amazon Simple Storage Service (Amazon S3) path from where you import the labels.</p>
139    pub fn get_input_s3_path(&self) -> &::std::option::Option<::std::string::String> {
140        self.inner.get_input_s3_path()
141    }
142    /// <p>Indicates whether to overwrite your existing labels.</p>
143    pub fn replace_all_labels(mut self, input: bool) -> Self {
144        self.inner = self.inner.replace_all_labels(input);
145        self
146    }
147    /// <p>Indicates whether to overwrite your existing labels.</p>
148    pub fn set_replace_all_labels(mut self, input: ::std::option::Option<bool>) -> Self {
149        self.inner = self.inner.set_replace_all_labels(input);
150        self
151    }
152    /// <p>Indicates whether to overwrite your existing labels.</p>
153    pub fn get_replace_all_labels(&self) -> &::std::option::Option<bool> {
154        self.inner.get_replace_all_labels()
155    }
156}
aws_sdk_glue/operation/start_import_labels_task_run/builders.rs

aws_sdk_glue/operation/start_import_labels_task_run/
builders.rs
