import { Command as $Command } from "@smithy/core/client"; import type { MetadataBearer as __MetadataBearer } from "@smithy/types"; import type { GlueClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../GlueClient"; import type { StartImportLabelsTaskRunRequest, StartImportLabelsTaskRunResponse } from "../models/models_2"; /** * @public */ export type { __MetadataBearer }; export { $Command }; /** * @public * * The input for {@link StartImportLabelsTaskRunCommand}. */ export interface StartImportLabelsTaskRunCommandInput extends StartImportLabelsTaskRunRequest { } /** * @public * * The output of {@link StartImportLabelsTaskRunCommand}. */ export interface StartImportLabelsTaskRunCommandOutput extends StartImportLabelsTaskRunResponse, __MetadataBearer { } declare const StartImportLabelsTaskRunCommand_base: { new (input: StartImportLabelsTaskRunCommandInput): import("@smithy/core/client").CommandImpl; new (input: StartImportLabelsTaskRunCommandInput): import("@smithy/core/client").CommandImpl; getEndpointParameterInstructions(): { [x: string]: unknown; }; }; /** *

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.

* @example * Use a bare-bones client and the command you need to make an API call. * ```javascript * import { GlueClient, StartImportLabelsTaskRunCommand } from "@aws-sdk/client-glue"; // ES Modules import * // const { GlueClient, StartImportLabelsTaskRunCommand } = require("@aws-sdk/client-glue"); // CommonJS import * // import type { GlueClientConfig } from "@aws-sdk/client-glue"; * const config = {}; // type is GlueClientConfig * const client = new GlueClient(config); * const input = { // StartImportLabelsTaskRunRequest * TransformId: "STRING_VALUE", // required * InputS3Path: "STRING_VALUE", // required * ReplaceAllLabels: true || false, * }; * const command = new StartImportLabelsTaskRunCommand(input); * const response = await client.send(command); * // { // StartImportLabelsTaskRunResponse * // TaskRunId: "STRING_VALUE", * // }; * * ``` * * @param StartImportLabelsTaskRunCommandInput - {@link StartImportLabelsTaskRunCommandInput} * @returns {@link StartImportLabelsTaskRunCommandOutput} * @see {@link StartImportLabelsTaskRunCommandInput} for command's `input` shape. * @see {@link StartImportLabelsTaskRunCommandOutput} for command's `response` shape. * @see {@link GlueClientResolvedConfig | config} for GlueClient's `config` shape. * * @throws {@link EntityNotFoundException} (client fault) *

A specified entity does not exist

* * @throws {@link InternalServiceException} (server fault) *

An internal service error occurred.

* * @throws {@link InvalidInputException} (client fault) *

The input provided was not valid.

* * @throws {@link OperationTimeoutException} (client fault) *

The operation timed out.

* * @throws {@link ResourceNumberLimitExceededException} (client fault) *

A resource numerical limit was exceeded.

* * @throws {@link GlueServiceException} *

Base exception class for all service exceptions from Glue service.

* * * @public */ export declare class StartImportLabelsTaskRunCommand extends StartImportLabelsTaskRunCommand_base { /** @internal type navigation helper, not in runtime. */ protected static __types: { api: { input: StartImportLabelsTaskRunRequest; output: StartImportLabelsTaskRunResponse; }; sdk: { input: StartImportLabelsTaskRunCommandInput; output: StartImportLabelsTaskRunCommandOutput; }; }; }