[ aws . glue ]

get-ml-task-runs

Description

Gets a list of runs for a machine learning transform. Machine learning task runs are asynchronous tasks that AWS Glue runs on your behalf as part of various machine learning workflows. You can get a sortable, filterable list of machine learning task runs by calling GetMLTaskRuns with their parent transform’s TransformID and other optional parameters as documented in this section.

This operation returns a list of historic runs and must be paginated.

See also: AWS API Documentation

See ‘aws help’ for descriptions of global parameters.

Synopsis

  get-ml-task-runs
--transform-id <value>
[--next-token <value>]
[--max-results <value>]
[--filter <value>]
[--sort <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]

Options

--transform-id (string)

The unique identifier of the machine learning transform.

--next-token (string)

A token for pagination of the results. The default is empty.

--max-results (integer)

The maximum number of results to return.

--filter (structure)

The filter criteria, in the TaskRunFilterCriteria structure, for the task run.

TaskRunType -> (string)

The type of task run.

Status -> (string)

The current status of the task run.

StartedBefore -> (timestamp)

Filter on task runs started before this date.

StartedAfter -> (timestamp)

Filter on task runs started after this date.

Shorthand Syntax:

TaskRunType=string,Status=string,StartedBefore=timestamp,StartedAfter=timestamp

JSON Syntax:

{
  "TaskRunType": "EVALUATION"|"LABELING_SET_GENERATION"|"IMPORT_LABELS"|"EXPORT_LABELS"|"FIND_MATCHES",
  "Status": "STARTING"|"RUNNING"|"STOPPING"|"STOPPED"|"SUCCEEDED"|"FAILED"|"TIMEOUT",
  "StartedBefore": timestamp,
  "StartedAfter": timestamp
}

--sort (structure)

The sorting criteria, in the TaskRunSortCriteria structure, for the task run.

Column -> (string)

The column to be used to sort the list of task runs for the machine learning transform.

SortDirection -> (string)

The sort direction to be used to sort the list of task runs for the machine learning transform.

Shorthand Syntax:

Column=string,SortDirection=string

JSON Syntax:

{
  "Column": "TASK_RUN_TYPE"|"STATUS"|"STARTED",
  "SortDirection": "DESCENDING"|"ASCENDING"
}

--cli-input-json | --cli-input-yaml (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. Similarly, if provided yaml-input it will print a sample input YAML that can be used with --cli-input-yaml. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See ‘aws help’ for descriptions of global parameters.

Output

TaskRuns -> (list)

A list of task runs that are associated with the transform.

(structure)

The sampling parameters that are associated with the machine learning transform.

TransformId -> (string)

The unique identifier for the transform.

TaskRunId -> (string)

The unique identifier for this task run.

Status -> (string)

The current status of the requested task run.

LogGroupName -> (string)

The names of the log group for secure logging, associated with this task run.

Properties -> (structure)

Specifies configuration properties associated with this task run.

TaskType -> (string)

The type of task run.

ImportLabelsTaskRunProperties -> (structure)

The configuration properties for an importing labels task run.

InputS3Path -> (string)

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

Replace -> (boolean)

Indicates whether to overwrite your existing labels.

ExportLabelsTaskRunProperties -> (structure)

The configuration properties for an exporting labels task run.

OutputS3Path -> (string)

The Amazon Simple Storage Service (Amazon S3) path where you will export the labels.

LabelingSetGenerationTaskRunProperties -> (structure)

The configuration properties for a labeling set generation task run.

OutputS3Path -> (string)

The Amazon Simple Storage Service (Amazon S3) path where you will generate the labeling set.

FindMatchesTaskRunProperties -> (structure)

The configuration properties for a find matches task run.

JobId -> (string)

The job ID for the Find Matches task run.

JobName -> (string)

The name assigned to the job for the Find Matches task run.

JobRunId -> (string)

The job run ID for the Find Matches task run.

ErrorString -> (string)

The list of error strings associated with this task run.

StartedOn -> (timestamp)

The date and time that this task run started.

LastModifiedOn -> (timestamp)

The last point in time that the requested task run was updated.

CompletedOn -> (timestamp)

The last point in time that the requested task run was completed.

ExecutionTime -> (integer)

The amount of time (in seconds) that the task run consumed resources.

NextToken -> (string)

A pagination token, if more results are available.