CfnInstanceFleetConfigProps
- class aws_cdk.aws_emr.CfnInstanceFleetConfigProps(*, cluster_id, instance_fleet_type, instance_type_configs=None, launch_specifications=None, name=None, target_on_demand_capacity=None, target_spot_capacity=None)
Bases:
object
Properties for defining a
CfnInstanceFleetConfig
.- Parameters:
cluster_id (
str
) – The unique identifier of the EMR cluster.instance_fleet_type (
str
) – The node type that the instance fleet hosts. Allowed Values : TASKinstance_type_configs (
Union
[IResolvable
,Sequence
[Union
[IResolvable
,InstanceTypeConfigProperty
,Dict
[str
,Any
]]],None
]) –InstanceTypeConfigs
determine the EC2 instances that Amazon EMR attempts to provision to fulfill On-Demand and Spot target capacities. .. epigraph:: The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.launch_specifications (
Union
[IResolvable
,InstanceFleetProvisioningSpecificationsProperty
,Dict
[str
,Any
],None
]) – The launch specification for the instance fleet.name (
Optional
[str
]) – The friendly name of the instance fleet.target_on_demand_capacity (
Union
[int
,float
,None
]) – The target capacity of On-Demand units for the instance fleet, which determines how many On-Demand instances to provision. When the instance fleet launches, Amazon EMR tries to provision On-Demand instances as specified byInstanceTypeConfig
. Each instance configuration has a specifiedWeightedCapacity
. When an On-Demand instance is provisioned, theWeightedCapacity
units count toward the target capacity. Amazon EMR provisions instances until the target capacity is totally fulfilled, even if this results in an overage. For example, if there are 2 units remaining to fulfill capacity, and Amazon EMR can only provision an instance with aWeightedCapacity
of 5 units, the instance is provisioned, and the target capacity is exceeded by 3 units. .. epigraph:: If not specified or set to 0, only Spot instances are provisioned for the instance fleet usingTargetSpotCapacity
. At least one ofTargetSpotCapacity
andTargetOnDemandCapacity
should be greater than 0. For a master instance fleet, only one ofTargetSpotCapacity
andTargetOnDemandCapacity
can be specified, and its value must be 1.target_spot_capacity (
Union
[int
,float
,None
]) – The target capacity of Spot units for the instance fleet, which determines how many Spot instances to provision. When the instance fleet launches, Amazon EMR tries to provision Spot instances as specified byInstanceTypeConfig
. Each instance configuration has a specifiedWeightedCapacity
. When a Spot instance is provisioned, theWeightedCapacity
units count toward the target capacity. Amazon EMR provisions instances until the target capacity is totally fulfilled, even if this results in an overage. For example, if there are 2 units remaining to fulfill capacity, and Amazon EMR can only provision an instance with aWeightedCapacity
of 5 units, the instance is provisioned, and the target capacity is exceeded by 3 units. .. epigraph:: If not specified or set to 0, only On-Demand instances are provisioned for the instance fleet. At least one ofTargetSpotCapacity
andTargetOnDemandCapacity
should be greater than 0. For a master instance fleet, only one ofTargetSpotCapacity
andTargetOnDemandCapacity
can be specified, and its value must be 1.
- Link:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. import aws_cdk.aws_emr as emr # configuration_property_: emr.CfnInstanceFleetConfig.ConfigurationProperty cfn_instance_fleet_config_props = emr.CfnInstanceFleetConfigProps( cluster_id="clusterId", instance_fleet_type="instanceFleetType", # the properties below are optional instance_type_configs=[emr.CfnInstanceFleetConfig.InstanceTypeConfigProperty( instance_type="instanceType", # the properties below are optional bid_price="bidPrice", bid_price_as_percentage_of_on_demand_price=123, configurations=[emr.CfnInstanceFleetConfig.ConfigurationProperty( classification="classification", configuration_properties={ "configuration_properties_key": "configurationProperties" }, configurations=[configuration_property_] )], custom_ami_id="customAmiId", ebs_configuration=emr.CfnInstanceFleetConfig.EbsConfigurationProperty( ebs_block_device_configs=[emr.CfnInstanceFleetConfig.EbsBlockDeviceConfigProperty( volume_specification=emr.CfnInstanceFleetConfig.VolumeSpecificationProperty( size_in_gb=123, volume_type="volumeType", # the properties below are optional iops=123 ), # the properties below are optional volumes_per_instance=123 )], ebs_optimized=False ), weighted_capacity=123 )], launch_specifications=emr.CfnInstanceFleetConfig.InstanceFleetProvisioningSpecificationsProperty( on_demand_specification=emr.CfnInstanceFleetConfig.OnDemandProvisioningSpecificationProperty( allocation_strategy="allocationStrategy" ), spot_specification=emr.CfnInstanceFleetConfig.SpotProvisioningSpecificationProperty( timeout_action="timeoutAction", timeout_duration_minutes=123, # the properties below are optional allocation_strategy="allocationStrategy", block_duration_minutes=123 ) ), name="name", target_on_demand_capacity=123, target_spot_capacity=123 )
Attributes
- cluster_id
The unique identifier of the EMR cluster.
- instance_fleet_type
The node type that the instance fleet hosts.
Allowed Values : TASK
- instance_type_configs
InstanceTypeConfigs
determine the EC2 instances that Amazon EMR attempts to provision to fulfill On-Demand and Spot target capacities.The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.
- launch_specifications
The launch specification for the instance fleet.
- name
The friendly name of the instance fleet.
- target_on_demand_capacity
The target capacity of On-Demand units for the instance fleet, which determines how many On-Demand instances to provision.
When the instance fleet launches, Amazon EMR tries to provision On-Demand instances as specified by
InstanceTypeConfig
. Each instance configuration has a specifiedWeightedCapacity
. When an On-Demand instance is provisioned, theWeightedCapacity
units count toward the target capacity. Amazon EMR provisions instances until the target capacity is totally fulfilled, even if this results in an overage. For example, if there are 2 units remaining to fulfill capacity, and Amazon EMR can only provision an instance with aWeightedCapacity
of 5 units, the instance is provisioned, and the target capacity is exceeded by 3 units. .. epigraph:If not specified or set to 0, only Spot instances are provisioned for the instance fleet using ``TargetSpotCapacity`` . At least one of ``TargetSpotCapacity`` and ``TargetOnDemandCapacity`` should be greater than 0. For a master instance fleet, only one of ``TargetSpotCapacity`` and ``TargetOnDemandCapacity`` can be specified, and its value must be 1.
- target_spot_capacity
The target capacity of Spot units for the instance fleet, which determines how many Spot instances to provision.
When the instance fleet launches, Amazon EMR tries to provision Spot instances as specified by
InstanceTypeConfig
. Each instance configuration has a specifiedWeightedCapacity
. When a Spot instance is provisioned, theWeightedCapacity
units count toward the target capacity. Amazon EMR provisions instances until the target capacity is totally fulfilled, even if this results in an overage. For example, if there are 2 units remaining to fulfill capacity, and Amazon EMR can only provision an instance with aWeightedCapacity
of 5 units, the instance is provisioned, and the target capacity is exceeded by 3 units. .. epigraph:If not specified or set to 0, only On-Demand instances are provisioned for the instance fleet. At least one of ``TargetSpotCapacity`` and ``TargetOnDemandCapacity`` should be greater than 0. For a master instance fleet, only one of ``TargetSpotCapacity`` and ``TargetOnDemandCapacity`` can be specified, and its value must be 1.