Interface CreateMlTransformRequest.Builder
- All Superinterfaces:
AwsRequest.Builder
,Buildable
,CopyableBuilder<CreateMlTransformRequest.Builder,
,CreateMlTransformRequest> GlueRequest.Builder
,SdkBuilder<CreateMlTransformRequest.Builder,
,CreateMlTransformRequest> SdkPojo
,SdkRequest.Builder
- Enclosing class:
CreateMlTransformRequest
-
Method Summary
Modifier and TypeMethodDescriptiondescription
(String description) A description of the machine learning transform that is being defined.glueVersion
(String glueVersion) This value determines which version of Glue this machine learning transform is compatible with.inputRecordTables
(Collection<GlueTable> inputRecordTables) A list of Glue table definitions used by the transform.inputRecordTables
(Consumer<GlueTable.Builder>... inputRecordTables) A list of Glue table definitions used by the transform.inputRecordTables
(GlueTable... inputRecordTables) A list of Glue table definitions used by the transform.maxCapacity
(Double maxCapacity) The number of Glue data processing units (DPUs) that are allocated to task runs for this transform.maxRetries
(Integer maxRetries) The maximum number of times to retry a task for this transform after a task run fails.The unique name that you give the transform when you create it.numberOfWorkers
(Integer numberOfWorkers) The number of workers of a definedworkerType
that are allocated when this task runs.overrideConfiguration
(Consumer<AwsRequestOverrideConfiguration.Builder> builderConsumer) Add an optional request override configuration.overrideConfiguration
(AwsRequestOverrideConfiguration overrideConfiguration) Add an optional request override configuration.default CreateMlTransformRequest.Builder
parameters
(Consumer<TransformParameters.Builder> parameters) The algorithmic parameters that are specific to the transform type used.parameters
(TransformParameters parameters) The algorithmic parameters that are specific to the transform type used.The name or Amazon Resource Name (ARN) of the IAM role with the required permissions.The tags to use with this machine learning transform.The timeout of the task run for this transform in minutes.default CreateMlTransformRequest.Builder
transformEncryption
(Consumer<TransformEncryption.Builder> transformEncryption) The encryption-at-rest settings of the transform that apply to accessing user data.transformEncryption
(TransformEncryption transformEncryption) The encryption-at-rest settings of the transform that apply to accessing user data.workerType
(String workerType) The type of predefined worker that is allocated when this task runs.workerType
(WorkerType workerType) The type of predefined worker that is allocated when this task runs.Methods inherited from interface software.amazon.awssdk.awscore.AwsRequest.Builder
overrideConfiguration
Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder
copy
Methods inherited from interface software.amazon.awssdk.services.glue.model.GlueRequest.Builder
build
Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation, build
Methods inherited from interface software.amazon.awssdk.core.SdkPojo
equalsBySdkFields, sdkFields
-
Method Details
-
name
The unique name that you give the transform when you create it.
- Parameters:
name
- The unique name that you give the transform when you create it.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
description
A description of the machine learning transform that is being defined. The default is an empty string.
- Parameters:
description
- A description of the machine learning transform that is being defined. The default is an empty string.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
inputRecordTables
A list of Glue table definitions used by the transform.
- Parameters:
inputRecordTables
- A list of Glue table definitions used by the transform.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
inputRecordTables
A list of Glue table definitions used by the transform.
- Parameters:
inputRecordTables
- A list of Glue table definitions used by the transform.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
inputRecordTables
CreateMlTransformRequest.Builder inputRecordTables(Consumer<GlueTable.Builder>... inputRecordTables) A list of Glue table definitions used by the transform.
This is a convenience method that creates an instance of theGlueTable.Builder
avoiding the need to create one manually viaGlueTable.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toinputRecordTables(List<GlueTable>)
.- Parameters:
inputRecordTables
- a consumer that will call methods onGlueTable.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
parameters
The algorithmic parameters that are specific to the transform type used. Conditionally dependent on the transform type.
- Parameters:
parameters
- The algorithmic parameters that are specific to the transform type used. Conditionally dependent on the transform type.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
parameters
default CreateMlTransformRequest.Builder parameters(Consumer<TransformParameters.Builder> parameters) The algorithmic parameters that are specific to the transform type used. Conditionally dependent on the transform type.
This is a convenience method that creates an instance of theTransformParameters.Builder
avoiding the need to create one manually viaTransformParameters.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toparameters(TransformParameters)
.- Parameters:
parameters
- a consumer that will call methods onTransformParameters.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
role
The name or Amazon Resource Name (ARN) of the IAM role with the required permissions. The required permissions include both Glue service role permissions to Glue resources, and Amazon S3 permissions required by the transform.
-
This role needs Glue service role permissions to allow access to resources in Glue. See Attach a Policy to IAM Users That Access Glue.
-
This role needs permission to your Amazon Simple Storage Service (Amazon S3) sources, targets, temporary directory, scripts, and any libraries used by the task run for this transform.
- Parameters:
role
- The name or Amazon Resource Name (ARN) of the IAM role with the required permissions. The required permissions include both Glue service role permissions to Glue resources, and Amazon S3 permissions required by the transform.-
This role needs Glue service role permissions to allow access to resources in Glue. See Attach a Policy to IAM Users That Access Glue.
-
This role needs permission to your Amazon Simple Storage Service (Amazon S3) sources, targets, temporary directory, scripts, and any libraries used by the task run for this transform.
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
glueVersion
This value determines which version of Glue this machine learning transform is compatible with. Glue 1.0 is recommended for most customers. If the value is not set, the Glue compatibility defaults to Glue 0.9. For more information, see Glue Versions in the developer guide.
- Parameters:
glueVersion
- This value determines which version of Glue this machine learning transform is compatible with. Glue 1.0 is recommended for most customers. If the value is not set, the Glue compatibility defaults to Glue 0.9. For more information, see Glue Versions in the developer guide.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
maxCapacity
The number of 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 Glue pricing page.
MaxCapacity
is a mutually exclusive option withNumberOfWorkers
andWorkerType
.-
If either
NumberOfWorkers
orWorkerType
is set, thenMaxCapacity
cannot be set. -
If
MaxCapacity
is set then neitherNumberOfWorkers
orWorkerType
can be set. -
If
WorkerType
is set, thenNumberOfWorkers
is required (and vice versa). -
MaxCapacity
andNumberOfWorkers
must both be at least 1.
When the
WorkerType
field is set to a value other thanStandard
, theMaxCapacity
field is set automatically and becomes read-only.When the
WorkerType
field is set to a value other thanStandard
, theMaxCapacity
field is set automatically and becomes read-only.- Parameters:
maxCapacity
- The number of 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 Glue pricing page.MaxCapacity
is a mutually exclusive option withNumberOfWorkers
andWorkerType
.-
If either
NumberOfWorkers
orWorkerType
is set, thenMaxCapacity
cannot be set. -
If
MaxCapacity
is set then neitherNumberOfWorkers
orWorkerType
can be set. -
If
WorkerType
is set, thenNumberOfWorkers
is required (and vice versa). -
MaxCapacity
andNumberOfWorkers
must both be at least 1.
When the
WorkerType
field is set to a value other thanStandard
, theMaxCapacity
field is set automatically and becomes read-only.When the
WorkerType
field is set to a value other thanStandard
, theMaxCapacity
field is set automatically and becomes read-only.-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
workerType
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.
MaxCapacity
is a mutually exclusive option withNumberOfWorkers
andWorkerType
.-
If either
NumberOfWorkers
orWorkerType
is set, thenMaxCapacity
cannot be set. -
If
MaxCapacity
is set then neitherNumberOfWorkers
orWorkerType
can be set. -
If
WorkerType
is set, thenNumberOfWorkers
is required (and vice versa). -
MaxCapacity
andNumberOfWorkers
must both be at least 1.
- Parameters:
workerType
- 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.
MaxCapacity
is a mutually exclusive option withNumberOfWorkers
andWorkerType
.-
If either
NumberOfWorkers
orWorkerType
is set, thenMaxCapacity
cannot be set. -
If
MaxCapacity
is set then neitherNumberOfWorkers
orWorkerType
can be set. -
If
WorkerType
is set, thenNumberOfWorkers
is required (and vice versa). -
MaxCapacity
andNumberOfWorkers
must both be at least 1.
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
-
workerType
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.
MaxCapacity
is a mutually exclusive option withNumberOfWorkers
andWorkerType
.-
If either
NumberOfWorkers
orWorkerType
is set, thenMaxCapacity
cannot be set. -
If
MaxCapacity
is set then neitherNumberOfWorkers
orWorkerType
can be set. -
If
WorkerType
is set, thenNumberOfWorkers
is required (and vice versa). -
MaxCapacity
andNumberOfWorkers
must both be at least 1.
- Parameters:
workerType
- 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.
MaxCapacity
is a mutually exclusive option withNumberOfWorkers
andWorkerType
.-
If either
NumberOfWorkers
orWorkerType
is set, thenMaxCapacity
cannot be set. -
If
MaxCapacity
is set then neitherNumberOfWorkers
orWorkerType
can be set. -
If
WorkerType
is set, thenNumberOfWorkers
is required (and vice versa). -
MaxCapacity
andNumberOfWorkers
must both be at least 1.
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
-
numberOfWorkers
The number of workers of a defined
workerType
that are allocated when this task runs.If
WorkerType
is set, thenNumberOfWorkers
is required (and vice versa).- Parameters:
numberOfWorkers
- The number of workers of a definedworkerType
that are allocated when this task runs.If
WorkerType
is set, thenNumberOfWorkers
is required (and vice versa).- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
timeout
The timeout of the 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).- Parameters:
timeout
- The timeout of the 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 entersTIMEOUT
status. The default is 2,880 minutes (48 hours).- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
maxRetries
The maximum number of times to retry a task for this transform after a task run fails.
- Parameters:
maxRetries
- The maximum number of times to retry a task for this transform after a task run fails.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
tags
The tags to use with this machine learning transform. You may use tags to limit access to the machine learning transform. For more information about tags in Glue, see Amazon Web Services Tags in Glue in the developer guide.
- Parameters:
tags
- The tags to use with this machine learning transform. You may use tags to limit access to the machine learning transform. For more information about tags in Glue, see Amazon Web Services Tags in Glue in the developer guide.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
transformEncryption
The encryption-at-rest settings of the transform that apply to accessing user data. Machine learning transforms can access user data encrypted in Amazon S3 using KMS.
- Parameters:
transformEncryption
- The encryption-at-rest settings of the transform that apply to accessing user data. Machine learning transforms can access user data encrypted in Amazon S3 using KMS.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
transformEncryption
default CreateMlTransformRequest.Builder transformEncryption(Consumer<TransformEncryption.Builder> transformEncryption) The encryption-at-rest settings of the transform that apply to accessing user data. Machine learning transforms can access user data encrypted in Amazon S3 using KMS.
This is a convenience method that creates an instance of theTransformEncryption.Builder
avoiding the need to create one manually viaTransformEncryption.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed totransformEncryption(TransformEncryption)
.- Parameters:
transformEncryption
- a consumer that will call methods onTransformEncryption.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
overrideConfiguration
CreateMlTransformRequest.Builder overrideConfiguration(AwsRequestOverrideConfiguration overrideConfiguration) Description copied from interface:AwsRequest.Builder
Add an optional request override configuration.- Specified by:
overrideConfiguration
in interfaceAwsRequest.Builder
- Parameters:
overrideConfiguration
- The override configuration.- Returns:
- This object for method chaining.
-
overrideConfiguration
CreateMlTransformRequest.Builder overrideConfiguration(Consumer<AwsRequestOverrideConfiguration.Builder> builderConsumer) Description copied from interface:AwsRequest.Builder
Add an optional request override configuration.- Specified by:
overrideConfiguration
in interfaceAwsRequest.Builder
- Parameters:
builderConsumer
- AConsumer
to which an emptyAwsRequestOverrideConfiguration.Builder
will be given.- Returns:
- This object for method chaining.
-