startExportLabelsTaskRun method

Future<StartExportLabelsTaskRunResponse> startExportLabelsTaskRun({ required String outputS3Path, required String transformId, })

Begins an asynchronous task to export all labeled data for a particular transform. This task is the only label-related API call that is not part of the typical active learning workflow. You typically use StartExportLabelsTaskRun when you want to work with all of your existing labels at the same time, such as when you want to remove or change labels that were previously submitted as truth. This API operation accepts the TransformId whose labels you want to export and an Amazon Simple Storage Service (Amazon S3) path to export the labels to. The operation returns a TaskRunId. You can check on the status of your task run by calling the GetMLTaskRun API.

May throw EntityNotFoundException. May throw InvalidInputException. May throw OperationTimeoutException. May throw InternalServiceException.

Parameter outputS3Path : The Amazon S3 path where you export the labels.

Parameter transformId : The unique identifier of the machine learning transform.

Implementation

Future<StartExportLabelsTaskRunResponse> startExportLabelsTaskRun({
  required String outputS3Path,
  required String transformId,
}) async {
  ArgumentError.checkNotNull(outputS3Path, 'outputS3Path');
  ArgumentError.checkNotNull(transformId, 'transformId');
  _s.validateStringLength(
    'transformId',
    transformId,
    1,
    255,
    isRequired: true,
  );
  final headers = <String, String>{
    'Content-Type': 'application/x-amz-json-1.1',
    'X-Amz-Target': 'AWSGlue.StartExportLabelsTaskRun'
  };
  final jsonResponse = await _protocol.send(
    method: 'POST',
    requestUri: '/',
    exceptionFnMap: _exceptionFns,
    // TODO queryParams
    headers: headers,
    payload: {
      'OutputS3Path': outputS3Path,
      'TransformId': transformId,
    },
  );

  return StartExportLabelsTaskRunResponse.fromJson(jsonResponse.body);
}