Table Of Contents

Feedback

User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . glue ]

update-ml-transform

Description

Updates an existing machine learning transform. Call this operation to tune the algorithm parameters to achieve better results.

After calling this operation, you can call the StartMLEvaluationTaskRun operation to assess how well your new parameters achieved your goals (such as improving the quality of your machine learning transform, or making it more cost-effective).

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.

Synopsis

  update-ml-transform
--transform-id <value>
[--name <value>]
[--description <value>]
[--parameters <value>]
[--role <value>]
[--max-capacity <value>]
[--worker-type <value>]
[--number-of-workers <value>]
[--timeout <value>]
[--max-retries <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]

Options

--transform-id (string)

A unique identifier that was generated when the transform was created.

--name (string)

The unique name that you gave the transform when you created it.

--description (string)

A description of the transform. The default is an empty string.

--parameters (structure)

The configuration parameters that are specific to the transform type (algorithm) used. Conditionally dependent on the transform type.

Shorthand Syntax:

TransformType=string,FindMatchesParameters={PrimaryKeyColumnName=string,PrecisionRecallTradeoff=double,AccuracyCostTradeoff=double,EnforceProvidedLabels=boolean}

JSON Syntax:

{
  "TransformType": "FIND_MATCHES",
  "FindMatchesParameters": {
    "PrimaryKeyColumnName": "string",
    "PrecisionRecallTradeoff": double,
    "AccuracyCostTradeoff": double,
    "EnforceProvidedLabels": true|false
  }
}

--role (string)

The name or Amazon Resource Name (ARN) of the IAM role with the required permissions.

--max-capacity (double)

The number of AWS Glue data processing units (DPUs) that are allocated to task runs for this transform. You can allocate from 2 to 100 DPUs; the default is 10. A DPU is a relative measure of processing power that consists of 4 vCPUs of compute capacity and 16 GB of memory. For more information, see the AWS Glue pricing page .

When the WorkerType field is set to a value other than Standard , the MaxCapacity field is set automatically and becomes read-only.

--worker-type (string)

The type of predefined worker that is allocated when this task runs. Accepts a value of Standard, G.1X, or G.2X.

  • For the Standard worker type, each worker provides 4 vCPU, 16 GB of memory and a 50GB disk, and 2 executors per worker.
  • For the G.1X worker type, each worker provides 4 vCPU, 16 GB of memory and a 64GB disk, and 1 executor per worker.
  • For the G.2X worker type, each worker provides 8 vCPU, 32 GB of memory and a 128GB disk, and 1 executor per worker.

Possible values:

  • Standard
  • G.1X
  • G.2X

--number-of-workers (integer)

The number of workers of a defined workerType that are allocated when this task runs.

--timeout (integer)

The timeout for a task run for this transform in minutes. This is the maximum time that a task run for this transform can consume resources before it is terminated and enters TIMEOUT status. The default is 2,880 minutes (48 hours).

--max-retries (integer)

The maximum number of times to retry a task for this transform after a task run fails.

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI 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.

--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. 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

TransformId -> (string)

The unique identifier for the transform that was updated.