Interface CreateComputeNodeGroupRequest.Builder
- All Superinterfaces:
AwsRequest.Builder
,Buildable
,CopyableBuilder<CreateComputeNodeGroupRequest.Builder,
,CreateComputeNodeGroupRequest> PcsRequest.Builder
,SdkBuilder<CreateComputeNodeGroupRequest.Builder,
,CreateComputeNodeGroupRequest> SdkPojo
,SdkRequest.Builder
- Enclosing class:
CreateComputeNodeGroupRequest
-
Method Summary
Modifier and TypeMethodDescriptionThe ID of the Amazon Machine Image (AMI) that Amazon Web Services PCS uses to launch compute nodes (Amazon EC2 instances).clientToken
(String clientToken) A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.clusterIdentifier
(String clusterIdentifier) The name or ID of the cluster to create a compute node group in.computeNodeGroupName
(String computeNodeGroupName) A name to identify the cluster.customLaunchTemplate
(Consumer<CustomLaunchTemplate.Builder> customLaunchTemplate) Sets the value of the CustomLaunchTemplate property for this object.customLaunchTemplate
(CustomLaunchTemplate customLaunchTemplate) Sets the value of the CustomLaunchTemplate property for this object.iamInstanceProfileArn
(String iamInstanceProfileArn) The Amazon Resource Name (ARN) of the IAM instance profile used to pass an IAM role when launching EC2 instances.instanceConfigs
(Collection<InstanceConfig> instanceConfigs) A list of EC2 instance configurations that Amazon Web Services PCS can provision in the compute node group.instanceConfigs
(Consumer<InstanceConfig.Builder>... instanceConfigs) A list of EC2 instance configurations that Amazon Web Services PCS can provision in the compute node group.instanceConfigs
(InstanceConfig... instanceConfigs) A list of EC2 instance configurations that Amazon Web Services PCS can provision in the compute node group.overrideConfiguration
(Consumer<AwsRequestOverrideConfiguration.Builder> builderConsumer) Add an optional request override configuration.overrideConfiguration
(AwsRequestOverrideConfiguration overrideConfiguration) Add an optional request override configuration.purchaseOption
(String purchaseOption) Specifies how EC2 instances are purchased on your behalf.purchaseOption
(PurchaseOption purchaseOption) Specifies how EC2 instances are purchased on your behalf.scalingConfiguration
(Consumer<ScalingConfigurationRequest.Builder> scalingConfiguration) Specifies the boundaries of the compute node group auto scaling.scalingConfiguration
(ScalingConfigurationRequest scalingConfiguration) Specifies the boundaries of the compute node group auto scaling.slurmConfiguration
(Consumer<ComputeNodeGroupSlurmConfigurationRequest.Builder> slurmConfiguration) Additional options related to the Slurm scheduler.slurmConfiguration
(ComputeNodeGroupSlurmConfigurationRequest slurmConfiguration) Additional options related to the Slurm scheduler.spotOptions
(Consumer<SpotOptions.Builder> spotOptions) Sets the value of the SpotOptions property for this object.spotOptions
(SpotOptions spotOptions) Sets the value of the SpotOptions property for this object.The list of subnet IDs where the compute node group launches instances.subnetIds
(Collection<String> subnetIds) The list of subnet IDs where the compute node group launches instances.1 or more tags added to the resource.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.pcs.model.PcsRequest.Builder
build
Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation, build
Methods inherited from interface software.amazon.awssdk.core.SdkPojo
equalsBySdkFields, sdkFieldNameToField, sdkFields
-
Method Details
-
clusterIdentifier
The name or ID of the cluster to create a compute node group in.
- Parameters:
clusterIdentifier
- The name or ID of the cluster to create a compute node group in.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
computeNodeGroupName
A name to identify the cluster. Example:
MyCluster
- Parameters:
computeNodeGroupName
- A name to identify the cluster. Example:MyCluster
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
amiId
The ID of the Amazon Machine Image (AMI) that Amazon Web Services PCS uses to launch compute nodes (Amazon EC2 instances). If you don't provide this value, Amazon Web Services PCS uses the AMI ID specified in the custom launch template.
- Parameters:
amiId
- The ID of the Amazon Machine Image (AMI) that Amazon Web Services PCS uses to launch compute nodes (Amazon EC2 instances). If you don't provide this value, Amazon Web Services PCS uses the AMI ID specified in the custom launch template.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
subnetIds
The list of subnet IDs where the compute node group launches instances. Subnets must be in the same VPC as the cluster.
- Parameters:
subnetIds
- The list of subnet IDs where the compute node group launches instances. Subnets must be in the same VPC as the cluster.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
subnetIds
The list of subnet IDs where the compute node group launches instances. Subnets must be in the same VPC as the cluster.
- Parameters:
subnetIds
- The list of subnet IDs where the compute node group launches instances. Subnets must be in the same VPC as the cluster.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
purchaseOption
Specifies how EC2 instances are purchased on your behalf. Amazon Web Services PCS supports On-Demand and Spot instances. For more information, see Instance purchasing options in the Amazon Elastic Compute Cloud User Guide. If you don't provide this option, it defaults to On-Demand.
- Parameters:
purchaseOption
- Specifies how EC2 instances are purchased on your behalf. Amazon Web Services PCS supports On-Demand and Spot instances. For more information, see Instance purchasing options in the Amazon Elastic Compute Cloud User Guide. If you don't provide this option, it defaults to On-Demand.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
purchaseOption
Specifies how EC2 instances are purchased on your behalf. Amazon Web Services PCS supports On-Demand and Spot instances. For more information, see Instance purchasing options in the Amazon Elastic Compute Cloud User Guide. If you don't provide this option, it defaults to On-Demand.
- Parameters:
purchaseOption
- Specifies how EC2 instances are purchased on your behalf. Amazon Web Services PCS supports On-Demand and Spot instances. For more information, see Instance purchasing options in the Amazon Elastic Compute Cloud User Guide. If you don't provide this option, it defaults to On-Demand.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
customLaunchTemplate
CreateComputeNodeGroupRequest.Builder customLaunchTemplate(CustomLaunchTemplate customLaunchTemplate) Sets the value of the CustomLaunchTemplate property for this object.- Parameters:
customLaunchTemplate
- The new value for the CustomLaunchTemplate property for this object.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
customLaunchTemplate
default CreateComputeNodeGroupRequest.Builder customLaunchTemplate(Consumer<CustomLaunchTemplate.Builder> customLaunchTemplate) Sets the value of the CustomLaunchTemplate property for this object. This is a convenience method that creates an instance of theCustomLaunchTemplate.Builder
avoiding the need to create one manually viaCustomLaunchTemplate.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tocustomLaunchTemplate(CustomLaunchTemplate)
.- Parameters:
customLaunchTemplate
- a consumer that will call methods onCustomLaunchTemplate.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
iamInstanceProfileArn
The Amazon Resource Name (ARN) of the IAM instance profile used to pass an IAM role when launching EC2 instances. The role contained in your instance profile must have the
pcs:RegisterComputeNodeGroupInstance
permission. The resource identifier of the ARN must start withAWSPCS
or it must have/aws-pcs/
in its path.Examples
-
arn:aws:iam::111122223333:instance-profile/AWSPCS-example-role-1
-
arn:aws:iam::111122223333:instance-profile/aws-pcs/example-role-2
- Parameters:
iamInstanceProfileArn
- The Amazon Resource Name (ARN) of the IAM instance profile used to pass an IAM role when launching EC2 instances. The role contained in your instance profile must have thepcs:RegisterComputeNodeGroupInstance
permission. The resource identifier of the ARN must start withAWSPCS
or it must have/aws-pcs/
in its path.Examples
-
arn:aws:iam::111122223333:instance-profile/AWSPCS-example-role-1
-
arn:aws:iam::111122223333:instance-profile/aws-pcs/example-role-2
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
scalingConfiguration
CreateComputeNodeGroupRequest.Builder scalingConfiguration(ScalingConfigurationRequest scalingConfiguration) Specifies the boundaries of the compute node group auto scaling.
- Parameters:
scalingConfiguration
- Specifies the boundaries of the compute node group auto scaling.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
scalingConfiguration
default CreateComputeNodeGroupRequest.Builder scalingConfiguration(Consumer<ScalingConfigurationRequest.Builder> scalingConfiguration) Specifies the boundaries of the compute node group auto scaling.
This is a convenience method that creates an instance of theScalingConfigurationRequest.Builder
avoiding the need to create one manually viaScalingConfigurationRequest.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toscalingConfiguration(ScalingConfigurationRequest)
.- Parameters:
scalingConfiguration
- a consumer that will call methods onScalingConfigurationRequest.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
instanceConfigs
A list of EC2 instance configurations that Amazon Web Services PCS can provision in the compute node group.
- Parameters:
instanceConfigs
- A list of EC2 instance configurations that Amazon Web Services PCS can provision in the compute node group.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
instanceConfigs
A list of EC2 instance configurations that Amazon Web Services PCS can provision in the compute node group.
- Parameters:
instanceConfigs
- A list of EC2 instance configurations that Amazon Web Services PCS can provision in the compute node group.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
instanceConfigs
CreateComputeNodeGroupRequest.Builder instanceConfigs(Consumer<InstanceConfig.Builder>... instanceConfigs) A list of EC2 instance configurations that Amazon Web Services PCS can provision in the compute node group.
This is a convenience method that creates an instance of theInstanceConfig.Builder
avoiding the need to create one manually viaInstanceConfig.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toinstanceConfigs(List<InstanceConfig>)
.- Parameters:
instanceConfigs
- a consumer that will call methods onInstanceConfig.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
spotOptions
Sets the value of the SpotOptions property for this object.- Parameters:
spotOptions
- The new value for the SpotOptions property for this object.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
spotOptions
default CreateComputeNodeGroupRequest.Builder spotOptions(Consumer<SpotOptions.Builder> spotOptions) Sets the value of the SpotOptions property for this object. This is a convenience method that creates an instance of theSpotOptions.Builder
avoiding the need to create one manually viaSpotOptions.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tospotOptions(SpotOptions)
.- Parameters:
spotOptions
- a consumer that will call methods onSpotOptions.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
slurmConfiguration
CreateComputeNodeGroupRequest.Builder slurmConfiguration(ComputeNodeGroupSlurmConfigurationRequest slurmConfiguration) Additional options related to the Slurm scheduler.
- Parameters:
slurmConfiguration
- Additional options related to the Slurm scheduler.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
slurmConfiguration
default CreateComputeNodeGroupRequest.Builder slurmConfiguration(Consumer<ComputeNodeGroupSlurmConfigurationRequest.Builder> slurmConfiguration) Additional options related to the Slurm scheduler.
This is a convenience method that creates an instance of theComputeNodeGroupSlurmConfigurationRequest.Builder
avoiding the need to create one manually viaComputeNodeGroupSlurmConfigurationRequest.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toslurmConfiguration(ComputeNodeGroupSlurmConfigurationRequest)
.- Parameters:
slurmConfiguration
- a consumer that will call methods onComputeNodeGroupSlurmConfigurationRequest.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
clientToken
A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. Idempotency ensures that an API request completes only once. With an idempotent request, if the original request completes successfully, the subsequent retries with the same client token return the result from the original successful request and they have no additional effect. If you don't specify a client token, the CLI and SDK automatically generate 1 for you.
- Parameters:
clientToken
- A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. Idempotency ensures that an API request completes only once. With an idempotent request, if the original request completes successfully, the subsequent retries with the same client token return the result from the original successful request and they have no additional effect. If you don't specify a client token, the CLI and SDK automatically generate 1 for you.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
tags
1 or more tags added to the resource. Each tag consists of a tag key and tag value. The tag value is optional and can be an empty string.
- Parameters:
tags
- 1 or more tags added to the resource. Each tag consists of a tag key and tag value. The tag value is optional and can be an empty string.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
overrideConfiguration
CreateComputeNodeGroupRequest.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
CreateComputeNodeGroupRequest.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.
-