CfnInstanceFleetConfigPropsMixin

class aws_cdk.mixins_preview.aws_emr.mixins.CfnInstanceFleetConfigPropsMixin(props, *, strategy=None)

Bases: Mixin

Use InstanceFleetConfig to define instance fleets for an EMR cluster.

A cluster can not use both instance fleets and instance groups. For more information, see Configure Instance Fleets in the Amazon EMR Management Guide . .. epigraph:

The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions. > You can currently only add a task instance fleet to a cluster with this resource. If you use this resource, CloudFormation waits for the cluster launch to complete before adding the task instance fleet to the cluster. In order to add a task instance fleet to the cluster as part of the cluster launch and minimize delays in provisioning task nodes, use the ``TaskInstanceFleets`` subproperty for the `AWS::EMR::Cluster JobFlowInstancesConfig <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-elasticmapreduce-cluster-jobflowinstancesconfig.html>`_ property instead. To use this subproperty, see `AWS::EMR::Cluster <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-elasticmapreduce-cluster.html>`_ for examples.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-instancefleetconfig.html
CloudformationResource:: AWS::EMR::InstanceFleetConfig
Mixin:: true
ExampleMetadata:: fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk.mixins_preview import mixins
from aws_cdk.mixins_preview.aws_emr import mixins as emr_mixins

# configuration_property_: emr_mixins.CfnInstanceFleetConfigPropsMixin.ConfigurationProperty

cfn_instance_fleet_config_props_mixin = emr_mixins.CfnInstanceFleetConfigPropsMixin(emr_mixins.CfnInstanceFleetConfigMixinProps(
    cluster_id="clusterId",
    instance_fleet_type="instanceFleetType",
    instance_type_configs=[emr_mixins.CfnInstanceFleetConfigPropsMixin.InstanceTypeConfigProperty(
        bid_price="bidPrice",
        bid_price_as_percentage_of_on_demand_price=123,
        configurations=[emr_mixins.CfnInstanceFleetConfigPropsMixin.ConfigurationProperty(
            classification="classification",
            configuration_properties={
                "configuration_properties_key": "configurationProperties"
            },
            configurations=[configuration_property_]
        )],
        custom_ami_id="customAmiId",
        ebs_configuration=emr_mixins.CfnInstanceFleetConfigPropsMixin.EbsConfigurationProperty(
            ebs_block_device_configs=[emr_mixins.CfnInstanceFleetConfigPropsMixin.EbsBlockDeviceConfigProperty(
                volume_specification=emr_mixins.CfnInstanceFleetConfigPropsMixin.VolumeSpecificationProperty(
                    iops=123,
                    size_in_gb=123,
                    throughput=123,
                    volume_type="volumeType"
                ),
                volumes_per_instance=123
            )],
            ebs_optimized=False
        ),
        instance_type="instanceType",
        priority=123,
        weighted_capacity=123
    )],
    launch_specifications=emr_mixins.CfnInstanceFleetConfigPropsMixin.InstanceFleetProvisioningSpecificationsProperty(
        on_demand_specification=emr_mixins.CfnInstanceFleetConfigPropsMixin.OnDemandProvisioningSpecificationProperty(
            allocation_strategy="allocationStrategy",
            capacity_reservation_options=emr_mixins.CfnInstanceFleetConfigPropsMixin.OnDemandCapacityReservationOptionsProperty(
                capacity_reservation_preference="capacityReservationPreference",
                capacity_reservation_resource_group_arn="capacityReservationResourceGroupArn",
                usage_strategy="usageStrategy"
            )
        ),
        spot_specification=emr_mixins.CfnInstanceFleetConfigPropsMixin.SpotProvisioningSpecificationProperty(
            allocation_strategy="allocationStrategy",
            block_duration_minutes=123,
            timeout_action="timeoutAction",
            timeout_duration_minutes=123
        )
    ),
    name="name",
    resize_specifications=emr_mixins.CfnInstanceFleetConfigPropsMixin.InstanceFleetResizingSpecificationsProperty(
        on_demand_resize_specification=emr_mixins.CfnInstanceFleetConfigPropsMixin.OnDemandResizingSpecificationProperty(
            allocation_strategy="allocationStrategy",
            capacity_reservation_options=emr_mixins.CfnInstanceFleetConfigPropsMixin.OnDemandCapacityReservationOptionsProperty(
                capacity_reservation_preference="capacityReservationPreference",
                capacity_reservation_resource_group_arn="capacityReservationResourceGroupArn",
                usage_strategy="usageStrategy"
            ),
            timeout_duration_minutes=123
        ),
        spot_resize_specification=emr_mixins.CfnInstanceFleetConfigPropsMixin.SpotResizingSpecificationProperty(
            allocation_strategy="allocationStrategy",
            timeout_duration_minutes=123
        )
    ),
    target_on_demand_capacity=123,
    target_spot_capacity=123
),
    strategy=mixins.PropertyMergeStrategy.OVERRIDE
)

Create a mixin to apply properties to AWS::EMR::InstanceFleetConfig.

Parameters:

props (Union[CfnInstanceFleetConfigMixinProps, Dict[str, Any]]) – L1 properties to apply.
strategy (Optional[PropertyMergeStrategy]) – (experimental) Strategy for merging nested properties. Default: - PropertyMergeStrategy.MERGE

Methods

apply_to(construct)

Apply the mixin properties to the construct.

Parameters:: construct (IConstruct)
Return type:: IConstruct

supports(construct)

Check if this mixin supports the given construct.

Parameters:: construct (IConstruct)
Return type:: bool

Attributes

CFN_PROPERTY_KEYS = ['clusterId', 'instanceFleetType', 'instanceTypeConfigs', 'launchSpecifications', 'name', 'resizeSpecifications', 'targetOnDemandCapacity', 'targetSpotCapacity']

Static Methods

classmethod is_mixin(x)

(experimental) Checks if x is a Mixin.

Parameters:: x (Any) – Any object.
Return type:: bool
Returns:: true if x is an object created from a class which extends Mixin.
Stability:: experimental

ConfigurationProperty

class CfnInstanceFleetConfigPropsMixin.ConfigurationProperty(*, classification=None, configuration_properties=None, configurations=None)

Bases: object

Used only with Amazon EMR release 4.0 and later.

Configuration specifies optional configurations for customizing open-source big data applications and environment parameters. A configuration consists of a classification, properties, and optional nested configurations. A classification refers to an application-specific configuration file. Properties are the settings you want to change in that file. For more information, see Configuring Applications in the Amazon EMR Release Guide .

Attributes

classification

The classification within a configuration.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-configuration.html#cfn-emr-instancefleetconfig-configuration-classification

configuration_properties

Within a configuration classification, a set of properties that represent the settings that you want to change in the configuration file.

Duplicates not allowed.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-configuration.html#cfn-emr-instancefleetconfig-configuration-configurationproperties

configurations

A list of additional configurations to apply within a configuration object.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-configuration.html#cfn-emr-instancefleetconfig-configuration-configurations

EbsBlockDeviceConfigProperty

class CfnInstanceFleetConfigPropsMixin.EbsBlockDeviceConfigProperty(*, volume_specification=None, volumes_per_instance=None)

Bases: object

EbsBlockDeviceConfig is a subproperty of the EbsConfiguration property type.

EbsBlockDeviceConfig defines the number and type of EBS volumes to associate with all EC2 instances in an EMR cluster.

Parameters:

volume_specification (Union[IResolvable, VolumeSpecificationProperty, Dict[str, Any], None]) – EBS volume specifications such as volume type, IOPS, size (GiB) and throughput (MiB/s) that are requested for the EBS volume attached to an Amazon EC2 instance in the cluster.
volumes_per_instance (Union[int, float, None]) – Number of EBS volumes with a specific volume configuration that are associated with every instance in the instance group.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-ebsblockdeviceconfig.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk.mixins_preview.aws_emr import mixins as emr_mixins

ebs_block_device_config_property = emr_mixins.CfnInstanceFleetConfigPropsMixin.EbsBlockDeviceConfigProperty(
    volume_specification=emr_mixins.CfnInstanceFleetConfigPropsMixin.VolumeSpecificationProperty(
        iops=123,
        size_in_gb=123,
        throughput=123,
        volume_type="volumeType"
    ),
    volumes_per_instance=123
)

Attributes

volume_specification

EBS volume specifications such as volume type, IOPS, size (GiB) and throughput (MiB/s) that are requested for the EBS volume attached to an Amazon EC2 instance in the cluster.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-ebsblockdeviceconfig.html#cfn-emr-instancefleetconfig-ebsblockdeviceconfig-volumespecification

volumes_per_instance

Number of EBS volumes with a specific volume configuration that are associated with every instance in the instance group.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-ebsblockdeviceconfig.html#cfn-emr-instancefleetconfig-ebsblockdeviceconfig-volumesperinstance

EbsConfigurationProperty

class CfnInstanceFleetConfigPropsMixin.EbsConfigurationProperty(*, ebs_block_device_configs=None, ebs_optimized=None)

Bases: object

EbsConfiguration determines the EBS volumes to attach to EMR cluster instances.

Parameters:

ebs_block_device_configs (Union[IResolvable, Sequence[Union[IResolvable, EbsBlockDeviceConfigProperty, Dict[str, Any]]], None]) – An array of Amazon EBS volume specifications attached to a cluster instance.
ebs_optimized (Union[bool, IResolvable, None]) – Indicates whether an Amazon EBS volume is EBS-optimized. The default is false. You should explicitly set this value to true to enable the Amazon EBS-optimized setting for an EC2 instance.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-ebsconfiguration.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk.mixins_preview.aws_emr import mixins as emr_mixins

ebs_configuration_property = emr_mixins.CfnInstanceFleetConfigPropsMixin.EbsConfigurationProperty(
    ebs_block_device_configs=[emr_mixins.CfnInstanceFleetConfigPropsMixin.EbsBlockDeviceConfigProperty(
        volume_specification=emr_mixins.CfnInstanceFleetConfigPropsMixin.VolumeSpecificationProperty(
            iops=123,
            size_in_gb=123,
            throughput=123,
            volume_type="volumeType"
        ),
        volumes_per_instance=123
    )],
    ebs_optimized=False
)

Attributes

ebs_block_device_configs

An array of Amazon EBS volume specifications attached to a cluster instance.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-ebsconfiguration.html#cfn-emr-instancefleetconfig-ebsconfiguration-ebsblockdeviceconfigs

ebs_optimized

Indicates whether an Amazon EBS volume is EBS-optimized.

The default is false. You should explicitly set this value to true to enable the Amazon EBS-optimized setting for an EC2 instance.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-ebsconfiguration.html#cfn-emr-instancefleetconfig-ebsconfiguration-ebsoptimized

InstanceFleetProvisioningSpecificationsProperty

class CfnInstanceFleetConfigPropsMixin.InstanceFleetProvisioningSpecificationsProperty(*, on_demand_specification=None, spot_specification=None)

Bases: object

The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.

InstanceTypeConfig is a sub-property of InstanceFleetConfig . InstanceTypeConfig determines the EC2 instances that Amazon EMR attempts to provision to fulfill On-Demand and Spot target capacities.

Attributes

on_demand_specification

The launch specification for On-Demand Instances in the instance fleet, which determines the allocation strategy and capacity reservation options.

The instance fleet configuration is available only in Amazon EMR releases 4.8.0 and later, excluding 5.0.x versions. On-Demand Instances allocation strategy is available in Amazon EMR releases 5.12.1 and later.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-instancefleetprovisioningspecifications.html#cfn-emr-instancefleetconfig-instancefleetprovisioningspecifications-ondemandspecification

spot_specification

The launch specification for Spot instances in the fleet, which determines the allocation strategy, defined duration, and provisioning timeout behavior.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-instancefleetprovisioningspecifications.html#cfn-emr-instancefleetconfig-instancefleetprovisioningspecifications-spotspecification

InstanceFleetResizingSpecificationsProperty

class CfnInstanceFleetConfigPropsMixin.InstanceFleetResizingSpecificationsProperty(*, on_demand_resize_specification=None, spot_resize_specification=None)

Bases: object

The resize specification for On-Demand and Spot Instances in the fleet.

Parameters:

on_demand_resize_specification (Union[IResolvable, OnDemandResizingSpecificationProperty, Dict[str, Any], None]) – The resize specification for On-Demand Instances in the instance fleet, which contains the allocation strategy, capacity reservation options, and the resize timeout period.
spot_resize_specification (Union[IResolvable, SpotResizingSpecificationProperty, Dict[str, Any], None]) – The resize specification for Spot Instances in the instance fleet, which contains the allocation strategy and the resize timeout period.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-instancefleetresizingspecifications.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk.mixins_preview.aws_emr import mixins as emr_mixins

instance_fleet_resizing_specifications_property = emr_mixins.CfnInstanceFleetConfigPropsMixin.InstanceFleetResizingSpecificationsProperty(
    on_demand_resize_specification=emr_mixins.CfnInstanceFleetConfigPropsMixin.OnDemandResizingSpecificationProperty(
        allocation_strategy="allocationStrategy",
        capacity_reservation_options=emr_mixins.CfnInstanceFleetConfigPropsMixin.OnDemandCapacityReservationOptionsProperty(
            capacity_reservation_preference="capacityReservationPreference",
            capacity_reservation_resource_group_arn="capacityReservationResourceGroupArn",
            usage_strategy="usageStrategy"
        ),
        timeout_duration_minutes=123
    ),
    spot_resize_specification=emr_mixins.CfnInstanceFleetConfigPropsMixin.SpotResizingSpecificationProperty(
        allocation_strategy="allocationStrategy",
        timeout_duration_minutes=123
    )
)

Attributes

on_demand_resize_specification

The resize specification for On-Demand Instances in the instance fleet, which contains the allocation strategy, capacity reservation options, and the resize timeout period.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-instancefleetresizingspecifications.html#cfn-emr-instancefleetconfig-instancefleetresizingspecifications-ondemandresizespecification

spot_resize_specification

The resize specification for Spot Instances in the instance fleet, which contains the allocation strategy and the resize timeout period.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-instancefleetresizingspecifications.html#cfn-emr-instancefleetconfig-instancefleetresizingspecifications-spotresizespecification

InstanceTypeConfigProperty

class CfnInstanceFleetConfigPropsMixin.InstanceTypeConfigProperty(*, bid_price=None, bid_price_as_percentage_of_on_demand_price=None, configurations=None, custom_ami_id=None, ebs_configuration=None, instance_type=None, priority=None, weighted_capacity=None)

Bases: object

InstanceType config is a subproperty of InstanceFleetConfig .

An instance type configuration specifies each instance type in an instance fleet. The configuration determines the EC2 instances 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.

Parameters:

bid_price (Optional[str]) – The bid price for each Amazon EC2 Spot Instance type as defined by InstanceType . Expressed in USD. If neither BidPrice nor BidPriceAsPercentageOfOnDemandPrice is provided, BidPriceAsPercentageOfOnDemandPrice defaults to 100%.
bid_price_as_percentage_of_on_demand_price (Union[int, float, None]) – The bid price, as a percentage of On-Demand price, for each Amazon EC2 Spot Instance as defined by InstanceType . Expressed as a number (for example, 20 specifies 20%). If neither BidPrice nor BidPriceAsPercentageOfOnDemandPrice is provided, BidPriceAsPercentageOfOnDemandPrice defaults to 100%.
configurations (Union[IResolvable, Sequence[Union[IResolvable, ConfigurationProperty, Dict[str, Any]]], None]) –

Amazon EMR releases 4.x or later. An optional configuration specification to be used when provisioning cluster instances, which can include configurations for applications and software bundled with Amazon EMR. A configuration consists of a classification, properties, and optional nested configurations. A classification refers to an application-specific configuration file. Properties are the settings you want to change in that file. For more information, see Configuring Applications .
custom_ami_id (Optional[str]) – The custom AMI ID to use for the instance type.
ebs_configuration (Union[IResolvable, EbsConfigurationProperty, Dict[str, Any], None]) – The configuration of Amazon Elastic Block Store (Amazon EBS) attached to each instance as defined by InstanceType .
instance_type (Optional[str]) – An Amazon EC2 instance type, such as m3.xlarge .
priority (Union[int, float, None]) – The priority at which Amazon EMR launches the Amazon EC2 instances with this instance type. Priority starts at 0, which is the highest priority. Amazon EMR considers the highest priority first.
weighted_capacity (Union[int, float, None]) – The number of units that a provisioned instance of this type provides toward fulfilling the target capacities defined in InstanceFleetConfig . This value is 1 for a master instance fleet, and must be 1 or greater for core and task instance fleets. Defaults to 1 if not specified.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-instancetypeconfig.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk.mixins_preview.aws_emr import mixins as emr_mixins

# configuration_property_: emr_mixins.CfnInstanceFleetConfigPropsMixin.ConfigurationProperty

instance_type_config_property = emr_mixins.CfnInstanceFleetConfigPropsMixin.InstanceTypeConfigProperty(
    bid_price="bidPrice",
    bid_price_as_percentage_of_on_demand_price=123,
    configurations=[emr_mixins.CfnInstanceFleetConfigPropsMixin.ConfigurationProperty(
        classification="classification",
        configuration_properties={
            "configuration_properties_key": "configurationProperties"
        },
        configurations=[configuration_property_]
    )],
    custom_ami_id="customAmiId",
    ebs_configuration=emr_mixins.CfnInstanceFleetConfigPropsMixin.EbsConfigurationProperty(
        ebs_block_device_configs=[emr_mixins.CfnInstanceFleetConfigPropsMixin.EbsBlockDeviceConfigProperty(
            volume_specification=emr_mixins.CfnInstanceFleetConfigPropsMixin.VolumeSpecificationProperty(
                iops=123,
                size_in_gb=123,
                throughput=123,
                volume_type="volumeType"
            ),
            volumes_per_instance=123
        )],
        ebs_optimized=False
    ),
    instance_type="instanceType",
    priority=123,
    weighted_capacity=123
)

Attributes

bid_price

The bid price for each Amazon EC2 Spot Instance type as defined by InstanceType .

Expressed in USD. If neither BidPrice nor BidPriceAsPercentageOfOnDemandPrice is provided, BidPriceAsPercentageOfOnDemandPrice defaults to 100%.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-instancetypeconfig.html#cfn-emr-instancefleetconfig-instancetypeconfig-bidprice

bid_price_as_percentage_of_on_demand_price

The bid price, as a percentage of On-Demand price, for each Amazon EC2 Spot Instance as defined by InstanceType .

Expressed as a number (for example, 20 specifies 20%). If neither BidPrice nor BidPriceAsPercentageOfOnDemandPrice is provided, BidPriceAsPercentageOfOnDemandPrice defaults to 100%.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-instancetypeconfig.html#cfn-emr-instancefleetconfig-instancetypeconfig-bidpriceaspercentageofondemandprice

configurations

Amazon EMR releases 4.x or later.

An optional configuration specification to be used when provisioning cluster instances, which can include configurations for applications and software bundled with Amazon EMR. A configuration consists of a classification, properties, and optional nested configurations. A classification refers to an application-specific configuration file. Properties are the settings you want to change in that file. For more information, see Configuring Applications .

see:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-instancetypeconfig.html#cfn-emr-instancefleetconfig-instancetypeconfig-configurations

custom_ami_id

The custom AMI ID to use for the instance type.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-instancetypeconfig.html#cfn-emr-instancefleetconfig-instancetypeconfig-customamiid

ebs_configuration

The configuration of Amazon Elastic Block Store (Amazon EBS) attached to each instance as defined by InstanceType .

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-instancetypeconfig.html#cfn-emr-instancefleetconfig-instancetypeconfig-ebsconfiguration

instance_type

An Amazon EC2 instance type, such as m3.xlarge .

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-instancetypeconfig.html#cfn-emr-instancefleetconfig-instancetypeconfig-instancetype

priority

The priority at which Amazon EMR launches the Amazon EC2 instances with this instance type.

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

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-instancetypeconfig.html#cfn-emr-instancefleetconfig-instancetypeconfig-priority

weighted_capacity

The number of units that a provisioned instance of this type provides toward fulfilling the target capacities defined in InstanceFleetConfig .

This value is 1 for a master instance fleet, and must be 1 or greater for core and task instance fleets. Defaults to 1 if not specified.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-instancetypeconfig.html#cfn-emr-instancefleetconfig-instancetypeconfig-weightedcapacity

OnDemandCapacityReservationOptionsProperty

class CfnInstanceFleetConfigPropsMixin.OnDemandCapacityReservationOptionsProperty(*, capacity_reservation_preference=None, capacity_reservation_resource_group_arn=None, usage_strategy=None)

Bases: object

Describes the strategy for using unused Capacity Reservations for fulfilling On-Demand capacity.

Parameters:

capacity_reservation_preference (Optional[str]) – Indicates the instance’s Capacity Reservation preferences. Possible preferences include:. - open - The instance can run in any open Capacity Reservation that has matching attributes (instance type, platform, Availability Zone). - none - The instance avoids running in a Capacity Reservation even if one is available. The instance runs as an On-Demand Instance.
capacity_reservation_resource_group_arn (Optional[str]) – The ARN of the Capacity Reservation resource group in which to run the instance.
usage_strategy (Optional[str]) – Indicates whether to use unused Capacity Reservations for fulfilling On-Demand capacity. If you specify use-capacity-reservations-first , the fleet uses unused Capacity Reservations to fulfill On-Demand capacity up to the target On-Demand capacity. If multiple instance pools have unused Capacity Reservations, the On-Demand allocation strategy ( lowest-price ) is applied. If the number of unused Capacity Reservations is less than the On-Demand target capacity, the remaining On-Demand target capacity is launched according to the On-Demand allocation strategy ( lowest-price ). If you do not specify a value, the fleet fulfills the On-Demand capacity according to the chosen On-Demand allocation strategy.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-ondemandcapacityreservationoptions.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk.mixins_preview.aws_emr import mixins as emr_mixins

on_demand_capacity_reservation_options_property = emr_mixins.CfnInstanceFleetConfigPropsMixin.OnDemandCapacityReservationOptionsProperty(
    capacity_reservation_preference="capacityReservationPreference",
    capacity_reservation_resource_group_arn="capacityReservationResourceGroupArn",
    usage_strategy="usageStrategy"
)

Attributes

capacity_reservation_preference

.

open - The instance can run in any open Capacity Reservation that has matching attributes (instance type, platform, Availability Zone).
none - The instance avoids running in a Capacity Reservation even if one is available. The instance runs as an On-Demand Instance.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-ondemandcapacityreservationoptions.html#cfn-emr-instancefleetconfig-ondemandcapacityreservationoptions-capacityreservationpreference
Type:: Indicates the instance’s Capacity Reservation preferences. Possible preferences include

capacity_reservation_resource_group_arn

The ARN of the Capacity Reservation resource group in which to run the instance.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-ondemandcapacityreservationoptions.html#cfn-emr-instancefleetconfig-ondemandcapacityreservationoptions-capacityreservationresourcegrouparn

usage_strategy

Indicates whether to use unused Capacity Reservations for fulfilling On-Demand capacity.

If you specify use-capacity-reservations-first , the fleet uses unused Capacity Reservations to fulfill On-Demand capacity up to the target On-Demand capacity. If multiple instance pools have unused Capacity Reservations, the On-Demand allocation strategy ( lowest-price ) is applied. If the number of unused Capacity Reservations is less than the On-Demand target capacity, the remaining On-Demand target capacity is launched according to the On-Demand allocation strategy ( lowest-price ).

If you do not specify a value, the fleet fulfills the On-Demand capacity according to the chosen On-Demand allocation strategy.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-ondemandcapacityreservationoptions.html#cfn-emr-instancefleetconfig-ondemandcapacityreservationoptions-usagestrategy

OnDemandProvisioningSpecificationProperty

class CfnInstanceFleetConfigPropsMixin.OnDemandProvisioningSpecificationProperty(*, allocation_strategy=None, capacity_reservation_options=None)

Bases: object

The launch specification for On-Demand Instances in the instance fleet, which determines the allocation strategy.

The instance fleet configuration is available only in Amazon EMR releases 4.8.0 and later, excluding 5.0.x versions. On-Demand Instances allocation strategy is available in Amazon EMR releases 5.12.1 and later.

Parameters:

allocation_strategy (Optional[str]) – Specifies the strategy to use in launching On-Demand instance fleets. Available options are lowest-price and prioritized . lowest-price specifies to launch the instances with the lowest price first, and prioritized specifies that Amazon EMR should launch the instances with the highest priority first. The default is lowest-price .
capacity_reservation_options (Union[IResolvable, OnDemandCapacityReservationOptionsProperty, Dict[str, Any], None]) – The launch specification for On-Demand instances in the instance fleet, which determines the allocation strategy.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-ondemandprovisioningspecification.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk.mixins_preview.aws_emr import mixins as emr_mixins

on_demand_provisioning_specification_property = emr_mixins.CfnInstanceFleetConfigPropsMixin.OnDemandProvisioningSpecificationProperty(
    allocation_strategy="allocationStrategy",
    capacity_reservation_options=emr_mixins.CfnInstanceFleetConfigPropsMixin.OnDemandCapacityReservationOptionsProperty(
        capacity_reservation_preference="capacityReservationPreference",
        capacity_reservation_resource_group_arn="capacityReservationResourceGroupArn",
        usage_strategy="usageStrategy"
    )
)

Attributes

allocation_strategy

Specifies the strategy to use in launching On-Demand instance fleets.

Available options are lowest-price and prioritized . lowest-price specifies to launch the instances with the lowest price first, and prioritized specifies that Amazon EMR should launch the instances with the highest priority first. The default is lowest-price .

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-ondemandprovisioningspecification.html#cfn-emr-instancefleetconfig-ondemandprovisioningspecification-allocationstrategy

capacity_reservation_options

The launch specification for On-Demand instances in the instance fleet, which determines the allocation strategy.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-ondemandprovisioningspecification.html#cfn-emr-instancefleetconfig-ondemandprovisioningspecification-capacityreservationoptions

OnDemandResizingSpecificationProperty

class CfnInstanceFleetConfigPropsMixin.OnDemandResizingSpecificationProperty(*, allocation_strategy=None, capacity_reservation_options=None, timeout_duration_minutes=None)

Bases: object

The resize specification for On-Demand Instances in the instance fleet, which contains the resize timeout period.

Parameters:

allocation_strategy (Optional[str]) – Specifies the allocation strategy to use to launch On-Demand instances during a resize. The default is lowest-price .
capacity_reservation_options (Union[IResolvable, OnDemandCapacityReservationOptionsProperty, Dict[str, Any], None])
timeout_duration_minutes (Union[int, float, None]) – On-Demand resize timeout in minutes. If On-Demand Instances are not provisioned within this time, the resize workflow stops. The minimum value is 5 minutes, and the maximum value is 10,080 minutes (7 days). The timeout applies to all resize workflows on the Instance Fleet. The resize could be triggered by Amazon EMR Managed Scaling or by the customer (via Amazon EMR Console, Amazon EMR CLI modify-instance-fleet or Amazon EMR SDK ModifyInstanceFleet API) or by Amazon EMR due to Amazon EC2 Spot Reclamation.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-ondemandresizingspecification.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk.mixins_preview.aws_emr import mixins as emr_mixins

on_demand_resizing_specification_property = emr_mixins.CfnInstanceFleetConfigPropsMixin.OnDemandResizingSpecificationProperty(
    allocation_strategy="allocationStrategy",
    capacity_reservation_options=emr_mixins.CfnInstanceFleetConfigPropsMixin.OnDemandCapacityReservationOptionsProperty(
        capacity_reservation_preference="capacityReservationPreference",
        capacity_reservation_resource_group_arn="capacityReservationResourceGroupArn",
        usage_strategy="usageStrategy"
    ),
    timeout_duration_minutes=123
)

Attributes

allocation_strategy

Specifies the allocation strategy to use to launch On-Demand instances during a resize.

The default is lowest-price .

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-ondemandresizingspecification.html#cfn-emr-instancefleetconfig-ondemandresizingspecification-allocationstrategy

capacity_reservation_options

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-ondemandresizingspecification.html#cfn-emr-instancefleetconfig-ondemandresizingspecification-capacityreservationoptions

Type:: see

timeout_duration_minutes

On-Demand resize timeout in minutes.

If On-Demand Instances are not provisioned within this time, the resize workflow stops. The minimum value is 5 minutes, and the maximum value is 10,080 minutes (7 days). The timeout applies to all resize workflows on the Instance Fleet. The resize could be triggered by Amazon EMR Managed Scaling or by the customer (via Amazon EMR Console, Amazon EMR CLI modify-instance-fleet or Amazon EMR SDK ModifyInstanceFleet API) or by Amazon EMR due to Amazon EC2 Spot Reclamation.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-ondemandresizingspecification.html#cfn-emr-instancefleetconfig-ondemandresizingspecification-timeoutdurationminutes

SpotProvisioningSpecificationProperty

class CfnInstanceFleetConfigPropsMixin.SpotProvisioningSpecificationProperty(*, allocation_strategy=None, block_duration_minutes=None, timeout_action=None, timeout_duration_minutes=None)

Bases: object

SpotProvisioningSpecification is a subproperty of the InstanceFleetProvisioningSpecifications property type.

SpotProvisioningSpecification determines the launch specification for Spot instances in the instance fleet, which includes the defined duration and provisioning timeout behavior. .. epigraph:

The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.

Parameters:

allocation_strategy (Optional[str]) – Specifies one of the following strategies to launch Spot Instance fleets: capacity-optimized , price-capacity-optimized , lowest-price , or diversified , and capacity-optimized-prioritized . For more information on the provisioning strategies, see Allocation strategies for Spot Instances in the Amazon EC2 User Guide for Linux Instances . .. epigraph:: When you launch a Spot Instance fleet with the old console, it automatically launches with the capacity-optimized strategy. You can’t change the allocation strategy from the old console.
block_duration_minutes (Union[int, float, None]) – The defined duration for Spot Instances (also known as Spot blocks) in minutes. When specified, the Spot Instance does not terminate before the defined duration expires, and defined duration pricing for Spot Instances applies. Valid values are 60, 120, 180, 240, 300, or 360. The duration period starts as soon as a Spot Instance receives its instance ID. At the end of the duration, Amazon EC2 marks the Spot Instance for termination and provides a Spot Instance termination notice, which gives the instance a two-minute warning before it terminates. .. epigraph:: Spot Instances with a defined duration (also known as Spot blocks) are no longer available to new customers from July 1, 2021. For customers who have previously used the feature, we will continue to support Spot Instances with a defined duration until December 31, 2022.
timeout_action (Optional[str]) – The action to take when TargetSpotCapacity has not been fulfilled when the TimeoutDurationMinutes has expired; that is, when all Spot Instances could not be provisioned within the Spot provisioning timeout. Valid values are TERMINATE_CLUSTER and SWITCH_TO_ON_DEMAND . SWITCH_TO_ON_DEMAND specifies that if no Spot Instances are available, On-Demand Instances should be provisioned to fulfill any remaining Spot capacity.
timeout_duration_minutes (Union[int, float, None]) – The Spot provisioning timeout period in minutes. If Spot Instances are not provisioned within this time period, the TimeOutAction is taken. Minimum value is 5 and maximum value is 1440. The timeout applies only during initial provisioning, when the cluster is first created.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-spotprovisioningspecification.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk.mixins_preview.aws_emr import mixins as emr_mixins

spot_provisioning_specification_property = emr_mixins.CfnInstanceFleetConfigPropsMixin.SpotProvisioningSpecificationProperty(
    allocation_strategy="allocationStrategy",
    block_duration_minutes=123,
    timeout_action="timeoutAction",
    timeout_duration_minutes=123
)

Attributes

allocation_strategy

capacity-optimized , price-capacity-optimized , lowest-price , or diversified , and capacity-optimized-prioritized .

For more information on the provisioning strategies, see Allocation strategies for Spot Instances in the Amazon EC2 User Guide for Linux Instances . .. epigraph:

When you launch a Spot Instance fleet with the old console, it automatically launches with the ``capacity-optimized`` strategy. You can't change the allocation strategy from the old console.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-spotprovisioningspecification.html#cfn-emr-instancefleetconfig-spotprovisioningspecification-allocationstrategy
Type:: Specifies one of the following strategies to launch Spot Instance fleets

block_duration_minutes

The defined duration for Spot Instances (also known as Spot blocks) in minutes.

When specified, the Spot Instance does not terminate before the defined duration expires, and defined duration pricing for Spot Instances applies. Valid values are 60, 120, 180, 240, 300, or 360. The duration period starts as soon as a Spot Instance receives its instance ID. At the end of the duration, Amazon EC2 marks the Spot Instance for termination and provides a Spot Instance termination notice, which gives the instance a two-minute warning before it terminates. .. epigraph:

Spot Instances with a defined duration (also known as Spot blocks) are no longer available to new customers from July 1, 2021. For customers who have previously used the feature, we will continue to support Spot Instances with a defined duration until December 31, 2022.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-spotprovisioningspecification.html#cfn-emr-instancefleetconfig-spotprovisioningspecification-blockdurationminutes

timeout_action

The action to take when TargetSpotCapacity has not been fulfilled when the TimeoutDurationMinutes has expired;

that is, when all Spot Instances could not be provisioned within the Spot provisioning timeout. Valid values are TERMINATE_CLUSTER and SWITCH_TO_ON_DEMAND . SWITCH_TO_ON_DEMAND specifies that if no Spot Instances are available, On-Demand Instances should be provisioned to fulfill any remaining Spot capacity.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-spotprovisioningspecification.html#cfn-emr-instancefleetconfig-spotprovisioningspecification-timeoutaction

timeout_duration_minutes

The Spot provisioning timeout period in minutes.

If Spot Instances are not provisioned within this time period, the TimeOutAction is taken. Minimum value is 5 and maximum value is 1440. The timeout applies only during initial provisioning, when the cluster is first created.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-spotprovisioningspecification.html#cfn-emr-instancefleetconfig-spotprovisioningspecification-timeoutdurationminutes

SpotResizingSpecificationProperty

class CfnInstanceFleetConfigPropsMixin.SpotResizingSpecificationProperty(*, allocation_strategy=None, timeout_duration_minutes=None)

Bases: object

The resize specification for Spot Instances in the instance fleet, which contains the resize timeout period.

Parameters:

allocation_strategy (Optional[str]) – Specifies the allocation strategy to use to launch Spot instances during a resize. If you run Amazon EMR releases 6.9.0 or higher, the default is price-capacity-optimized . If you run Amazon EMR releases 6.8.0 or lower, the default is capacity-optimized .
timeout_duration_minutes (Union[int, float, None]) – Spot resize timeout in minutes. If Spot Instances are not provisioned within this time, the resize workflow will stop provisioning of Spot instances. Minimum value is 5 minutes and maximum value is 10,080 minutes (7 days). The timeout applies to all resize workflows on the Instance Fleet. The resize could be triggered by Amazon EMR Managed Scaling or by the customer (via Amazon EMR Console, Amazon EMR CLI modify-instance-fleet or Amazon EMR SDK ModifyInstanceFleet API) or by Amazon EMR due to Amazon EC2 Spot Reclamation.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-spotresizingspecification.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk.mixins_preview.aws_emr import mixins as emr_mixins

spot_resizing_specification_property = emr_mixins.CfnInstanceFleetConfigPropsMixin.SpotResizingSpecificationProperty(
    allocation_strategy="allocationStrategy",
    timeout_duration_minutes=123
)

Attributes

allocation_strategy

Specifies the allocation strategy to use to launch Spot instances during a resize.

If you run Amazon EMR releases 6.9.0 or higher, the default is price-capacity-optimized . If you run Amazon EMR releases 6.8.0 or lower, the default is capacity-optimized .

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-spotresizingspecification.html#cfn-emr-instancefleetconfig-spotresizingspecification-allocationstrategy

timeout_duration_minutes

Spot resize timeout in minutes.

If Spot Instances are not provisioned within this time, the resize workflow will stop provisioning of Spot instances. Minimum value is 5 minutes and maximum value is 10,080 minutes (7 days). The timeout applies to all resize workflows on the Instance Fleet. The resize could be triggered by Amazon EMR Managed Scaling or by the customer (via Amazon EMR Console, Amazon EMR CLI modify-instance-fleet or Amazon EMR SDK ModifyInstanceFleet API) or by Amazon EMR due to Amazon EC2 Spot Reclamation.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-spotresizingspecification.html#cfn-emr-instancefleetconfig-spotresizingspecification-timeoutdurationminutes

VolumeSpecificationProperty

class CfnInstanceFleetConfigPropsMixin.VolumeSpecificationProperty(*, iops=None, size_in_gb=None, throughput=None, volume_type=None)

Bases: object

VolumeSpecification is a subproperty of the EbsBlockDeviceConfig property type.

VolumeSecification determines the volume type, IOPS, and size (GiB) for EBS volumes attached to EC2 instances.

Parameters:

iops (Union[int, float, None]) – The number of I/O operations per second (IOPS) that the volume supports.
size_in_gb (Union[int, float, None]) – The volume size, in gibibytes (GiB). This can be a number from 1 - 1024. If the volume type is EBS-optimized, the minimum value is 10.
throughput (Union[int, float, None]) – The throughput, in mebibyte per second (MiB/s). This optional parameter can be a number from 125 - 1000 and is valid only for gp3 volumes.
volume_type (Optional[str]) – The volume type. Volume types supported are gp3, gp2, io1, st1, sc1, and standard.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emr-instancefleetconfig-volumespecification.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk.mixins_preview.aws_emr import mixins as emr_mixins

volume_specification_property = emr_mixins.CfnInstanceFleetConfigPropsMixin.VolumeSpecificationProperty(
    iops=123,
    size_in_gb=123,
    throughput=123,
    volume_type="volumeType"
)