libZSservicesZSamazonka-glueZSamazonka-glue
Copyright(c) 2013-2021 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay+amazonka@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone

Amazonka.Glue.StartImportLabelsTaskRun

Description

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 StartMLLabelingSetGenerationTaskRun call and that ultimately results in improving the quality of your machine learning transform.

After the StartMLLabelingSetGenerationTaskRun 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 FindMatches 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 StartImportLabelsTaskRun. After StartImportLabelsTaskRun finishes, all future runs of the machine learning transform use the new and improved labels and perform a higher-quality transformation.

By default, StartMLLabelingSetGenerationTaskRun continually learns from and combines all labels that you upload unless you set Replace to true. If you set Replace to true, StartImportLabelsTaskRun 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.

You can check on the status of your task run by calling the GetMLTaskRun operation.

Synopsis

Creating a Request

data StartImportLabelsTaskRun Source #

See: newStartImportLabelsTaskRun smart constructor.

Constructors

StartImportLabelsTaskRun' 

Fields

Instances

Instances details
Eq StartImportLabelsTaskRun Source # 
Instance details

Defined in Amazonka.Glue.StartImportLabelsTaskRun

Read StartImportLabelsTaskRun Source # 
Instance details

Defined in Amazonka.Glue.StartImportLabelsTaskRun

Show StartImportLabelsTaskRun Source # 
Instance details

Defined in Amazonka.Glue.StartImportLabelsTaskRun

Generic StartImportLabelsTaskRun Source # 
Instance details

Defined in Amazonka.Glue.StartImportLabelsTaskRun

Associated Types

type Rep StartImportLabelsTaskRun :: Type -> Type #

NFData StartImportLabelsTaskRun Source # 
Instance details

Defined in Amazonka.Glue.StartImportLabelsTaskRun

Hashable StartImportLabelsTaskRun Source # 
Instance details

Defined in Amazonka.Glue.StartImportLabelsTaskRun

ToJSON StartImportLabelsTaskRun Source # 
Instance details

Defined in Amazonka.Glue.StartImportLabelsTaskRun

AWSRequest StartImportLabelsTaskRun Source # 
Instance details

Defined in Amazonka.Glue.StartImportLabelsTaskRun

ToHeaders StartImportLabelsTaskRun Source # 
Instance details

Defined in Amazonka.Glue.StartImportLabelsTaskRun

ToPath StartImportLabelsTaskRun Source # 
Instance details

Defined in Amazonka.Glue.StartImportLabelsTaskRun

ToQuery StartImportLabelsTaskRun Source # 
Instance details

Defined in Amazonka.Glue.StartImportLabelsTaskRun

type Rep StartImportLabelsTaskRun Source # 
Instance details

Defined in Amazonka.Glue.StartImportLabelsTaskRun

type Rep StartImportLabelsTaskRun = D1 ('MetaData "StartImportLabelsTaskRun" "Amazonka.Glue.StartImportLabelsTaskRun" "libZSservicesZSamazonka-glueZSamazonka-glue" 'False) (C1 ('MetaCons "StartImportLabelsTaskRun'" 'PrefixI 'True) (S1 ('MetaSel ('Just "replaceAllLabels") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :*: (S1 ('MetaSel ('Just "transformId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "inputS3Path") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text))))
type AWSResponse StartImportLabelsTaskRun Source # 
Instance details

Defined in Amazonka.Glue.StartImportLabelsTaskRun

newStartImportLabelsTaskRun Source #

Create a value of StartImportLabelsTaskRun with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:replaceAllLabels:StartImportLabelsTaskRun', startImportLabelsTaskRun_replaceAllLabels - Indicates whether to overwrite your existing labels.

$sel:transformId:StartImportLabelsTaskRun', startImportLabelsTaskRun_transformId - The unique identifier of the machine learning transform.

$sel:inputS3Path:StartImportLabelsTaskRun', startImportLabelsTaskRun_inputS3Path - The Amazon Simple Storage Service (Amazon S3) path from where you import the labels.

Request Lenses

startImportLabelsTaskRun_replaceAllLabels :: Lens' StartImportLabelsTaskRun (Maybe Bool) Source #

Indicates whether to overwrite your existing labels.

startImportLabelsTaskRun_transformId :: Lens' StartImportLabelsTaskRun Text Source #

The unique identifier of the machine learning transform.

startImportLabelsTaskRun_inputS3Path :: Lens' StartImportLabelsTaskRun Text Source #

The Amazon Simple Storage Service (Amazon S3) path from where you import the labels.

Destructuring the Response

data StartImportLabelsTaskRunResponse Source #

See: newStartImportLabelsTaskRunResponse smart constructor.

Constructors

StartImportLabelsTaskRunResponse' 

Fields

Instances

Instances details
Eq StartImportLabelsTaskRunResponse Source # 
Instance details

Defined in Amazonka.Glue.StartImportLabelsTaskRun

Read StartImportLabelsTaskRunResponse Source # 
Instance details

Defined in Amazonka.Glue.StartImportLabelsTaskRun

Show StartImportLabelsTaskRunResponse Source # 
Instance details

Defined in Amazonka.Glue.StartImportLabelsTaskRun

Generic StartImportLabelsTaskRunResponse Source # 
Instance details

Defined in Amazonka.Glue.StartImportLabelsTaskRun

Associated Types

type Rep StartImportLabelsTaskRunResponse :: Type -> Type #

NFData StartImportLabelsTaskRunResponse Source # 
Instance details

Defined in Amazonka.Glue.StartImportLabelsTaskRun

type Rep StartImportLabelsTaskRunResponse Source # 
Instance details

Defined in Amazonka.Glue.StartImportLabelsTaskRun

type Rep StartImportLabelsTaskRunResponse = D1 ('MetaData "StartImportLabelsTaskRunResponse" "Amazonka.Glue.StartImportLabelsTaskRun" "libZSservicesZSamazonka-glueZSamazonka-glue" 'False) (C1 ('MetaCons "StartImportLabelsTaskRunResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "taskRunId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newStartImportLabelsTaskRunResponse Source #

Create a value of StartImportLabelsTaskRunResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:taskRunId:StartImportLabelsTaskRunResponse', startImportLabelsTaskRunResponse_taskRunId - The unique identifier for the task run.

$sel:httpStatus:StartImportLabelsTaskRunResponse', startImportLabelsTaskRunResponse_httpStatus - The response's http status code.

Response Lenses