# InstanceTypeConfigProperty

An instance type configuration for each instance type in an instance fleet, which determines the EC2 instances Amazon EMR attempts to provision to fulfill On-Demand and Spot target capacities.

- Source: [`aws-stepfunctions-tasks/lib/emr/emr-create-cluster.ts`](https://github.com/aws/aws-cdk/blob/v2.278.0/packages/aws-cdk-lib/aws-stepfunctions-tasks/lib/emr/emr-create-cluster.ts#L729)
- Type last changed: v2.253.0 · 6 May 2026

## Example

TypeScript:

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import * as cdk from 'aws-cdk-lib';
import { aws_stepfunctions_tasks as stepfunctions_tasks } from 'aws-cdk-lib';

declare const configurationProperty_: stepfunctions_tasks.EmrCreateCluster.ConfigurationProperty;
declare const size: cdk.Size;
const instanceTypeConfigProperty: stepfunctions_tasks.EmrCreateCluster.InstanceTypeConfigProperty = {
  instanceType: 'instanceType',

  // the properties below are optional
  bidPrice: 'bidPrice',
  bidPriceAsPercentageOfOnDemandPrice: 123,
  configurations: [{
    classification: 'classification',
    configurations: [configurationProperty_],
    properties: {
      propertiesKey: 'properties',
    },
  }],
  ebsConfiguration: {
    ebsBlockDeviceConfigs: [{
      volumeSpecification: {
        volumeSize: size,
        volumeType: stepfunctions_tasks.EmrCreateCluster.EbsBlockDeviceVolumeType.GP3,

        // the properties below are optional
        iops: 123,
      },

      // the properties below are optional
      volumesPerInstance: 123,
    }],
    ebsOptimized: false,
  },
  priority: 123,
  weightedCapacity: 123,
};
```

Python:

```python
# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
import aws_cdk as cdk
from aws_cdk import aws_stepfunctions_tasks as stepfunctions_tasks

# configuration_property_: stepfunctions_tasks.EmrCreateCluster.ConfigurationProperty
# size: cdk.Size

instance_type_config_property = stepfunctions_tasks.EmrCreateCluster.InstanceTypeConfigProperty(
    instance_type="instanceType",

    # the properties below are optional
    bid_price="bidPrice",
    bid_price_as_percentage_of_on_demand_price=123,
    configurations=[stepfunctions_tasks.EmrCreateCluster.ConfigurationProperty(
        classification="classification",
        configurations=[configuration_property_],
        properties={
            "properties_key": "properties"
        }
    )],
    ebs_configuration=stepfunctions_tasks.EmrCreateCluster.EbsConfigurationProperty(
        ebs_block_device_configs=[stepfunctions_tasks.EmrCreateCluster.EbsBlockDeviceConfigProperty(
            volume_specification=stepfunctions_tasks.EmrCreateCluster.VolumeSpecificationProperty(
                volume_size=size,
                volume_type=stepfunctions_tasks.EmrCreateCluster.EbsBlockDeviceVolumeType.GP3,

                # the properties below are optional
                iops=123
            ),

            # the properties below are optional
            volumes_per_instance=123
        )],
        ebs_optimized=False
    ),
    priority=123,
    weighted_capacity=123
)
```

Java:

```java
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import software.amazon.awscdk.*;
import software.amazon.awscdk.services.stepfunctions.tasks.*;

ConfigurationProperty configurationProperty_;
Size size;

InstanceTypeConfigProperty instanceTypeConfigProperty = InstanceTypeConfigProperty.builder()
        .instanceType("instanceType")

        // the properties below are optional
        .bidPrice("bidPrice")
        .bidPriceAsPercentageOfOnDemandPrice(123)
        .configurations(List.of(ConfigurationProperty.builder()
                .classification("classification")
                .configurations(List.of(configurationProperty_))
                .properties(Map.of(
                        "propertiesKey", "properties"))
                .build()))
        .ebsConfiguration(EbsConfigurationProperty.builder()
                .ebsBlockDeviceConfigs(List.of(EbsBlockDeviceConfigProperty.builder()
                        .volumeSpecification(VolumeSpecificationProperty.builder()
                                .volumeSize(size)
                                .volumeType(EmrCreateCluster.getEbsBlockDeviceVolumeType().GP3)

                                // the properties below are optional
                                .iops(123)
                                .build())

                        // the properties below are optional
                        .volumesPerInstance(123)
                        .build()))
                .ebsOptimized(false)
                .build())
        .priority(123)
        .weightedCapacity(123)
        .build();
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.Lib
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
using Amazon.CDK;
using Amazon.CDK.AWS.StepFunctions.Tasks;

ConfigurationProperty configurationProperty_;
Size size;

var instanceTypeConfigProperty = new InstanceTypeConfigProperty {
    InstanceType = "instanceType",

    // the properties below are optional
    BidPrice = "bidPrice",
    BidPriceAsPercentageOfOnDemandPrice = 123,
    Configurations = new [] { new ConfigurationProperty {
        Classification = "classification",
        Configurations = new [] { configurationProperty_ },
        Properties = new Dictionary<string, string> {
            { "propertiesKey", "properties" }
        }
    } },
    EbsConfiguration = new EbsConfigurationProperty {
        EbsBlockDeviceConfigs = new [] { new EbsBlockDeviceConfigProperty {
            VolumeSpecification = new VolumeSpecificationProperty {
                VolumeSize = size,
                VolumeType = EmrCreateCluster.EbsBlockDeviceVolumeType.GP3,

                // the properties below are optional
                Iops = 123
            },

            // the properties below are optional
            VolumesPerInstance = 123
        } },
        EbsOptimized = false
    },
    Priority = 123,
    WeightedCapacity = 123
};
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import cdk "github.com/aws/aws-cdk-go/awscdk"
import "github.com/aws/aws-cdk-go/awscdk"

var configurationProperty_ ConfigurationProperty
var size Size

instanceTypeConfigProperty := &InstanceTypeConfigProperty{
	InstanceType: jsii.String("instanceType"),

	// the properties below are optional
	BidPrice: jsii.String("bidPrice"),
	BidPriceAsPercentageOfOnDemandPrice: jsii.Number(123),
	Configurations: []ConfigurationProperty{
		&ConfigurationProperty{
			Classification: jsii.String("classification"),
			Configurations: []ConfigurationProperty{
				configurationProperty_,
			},
			Properties: map[string]*string{
				"propertiesKey": jsii.String("properties"),
			},
		},
	},
	EbsConfiguration: &EbsConfigurationProperty{
		EbsBlockDeviceConfigs: []EbsBlockDeviceConfigProperty{
			&EbsBlockDeviceConfigProperty{
				VolumeSpecification: &VolumeSpecificationProperty{
					VolumeSize: size,
					VolumeType: awscdk.Aws_stepfunctions_tasks.EmrCreateCluster.EbsBlockDeviceVolumeType_GP3,

					// the properties below are optional
					Iops: jsii.Number(123),
				},

				// the properties below are optional
				VolumesPerInstance: jsii.Number(123),
			},
		},
		EbsOptimized: jsii.Boolean(false),
	},
	Priority: jsii.Number(123),
	WeightedCapacity: jsii.Number(123),
}
```

## Properties

- `bidPrice`: string = None — The bid price for each EC2 Spot instance type as defined by InstanceType. Expressed in USD.

  Cannot specify both `bidPrice` and `bidPriceAsPercentageOfOnDemandPrice`.

- `bidPriceAsPercentageOfOnDemandPrice`: number = None — The bid price, as a percentage of On-Demand price.

  Cannot specify both `bidPrice` and `bidPriceAsPercentageOfOnDemandPrice`.

- `configurations`: [EmrCreateCluster.ConfigurationProperty](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_stepfunctions_tasks.EmrCreateCluster.ConfigurationProperty.html)[] = None — A configuration classification that applies when provisioning cluster instances, which can include configurations for applications and software that run on the cluster.

- `ebsConfiguration`: [EmrCreateCluster.EbsConfigurationProperty](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_stepfunctions_tasks.EmrCreateCluster.EbsConfigurationProperty.html) = None — The configuration of Amazon Elastic Block Storage (EBS) attached to each instance as defined by InstanceType.

- `instanceType`: string (required) — An EC2 instance type.

- `priority`: number — The priority at which Amazon EMR launches the EC2 instance with this instance type.

  **Default:** No priority is assigned

  Priority starts at 0, which is the highest priority. Amazon EMR considers the highest priority first.

- `weightedCapacity`: number = None — The number of units that a provisioned instance of this type provides toward fulfilling the target capacities defined in the InstanceFleetConfig.
