Class CfnInstanceFleetConfig
A CloudFormation AWS::EMR::InstanceFleetConfig
.
Inherited Members
Namespace: Amazon.CDK.AWS.EMR
Assembly: Amazon.CDK.AWS.EMR.dll
Syntax (csharp)
public class CfnInstanceFleetConfig : CfnResource, IConstruct, IDependable, IInspectable
Syntax (vb)
Public Class CfnInstanceFleetConfig
Inherits CfnResource
Implements IConstruct, IDependable, IInspectable
Remarks
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 .
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 property instead. To use this subproperty, see AWS::EMR::Cluster for examples.
CloudformationResource: AWS::EMR::InstanceFleetConfig
ExampleMetadata: fixture=_generated
Examples
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
using Amazon.CDK.AWS.EMR;
ConfigurationProperty configurationProperty_;
var cfnInstanceFleetConfig = new CfnInstanceFleetConfig(this, "MyCfnInstanceFleetConfig", new CfnInstanceFleetConfigProps {
ClusterId = "clusterId",
InstanceFleetType = "instanceFleetType",
// the properties below are optional
InstanceTypeConfigs = new [] { new InstanceTypeConfigProperty {
InstanceType = "instanceType",
// the properties below are optional
BidPrice = "bidPrice",
BidPriceAsPercentageOfOnDemandPrice = 123,
Configurations = new [] { new ConfigurationProperty {
Classification = "classification",
ConfigurationProperties = new Dictionary<string, string> {
{ "configurationPropertiesKey", "configurationProperties" }
},
Configurations = new [] { configurationProperty_ }
} },
CustomAmiId = "customAmiId",
EbsConfiguration = new EbsConfigurationProperty {
EbsBlockDeviceConfigs = new [] { new EbsBlockDeviceConfigProperty {
VolumeSpecification = new VolumeSpecificationProperty {
SizeInGb = 123,
VolumeType = "volumeType",
// the properties below are optional
Iops = 123
},
// the properties below are optional
VolumesPerInstance = 123
} },
EbsOptimized = false
},
WeightedCapacity = 123
} },
LaunchSpecifications = new InstanceFleetProvisioningSpecificationsProperty {
OnDemandSpecification = new OnDemandProvisioningSpecificationProperty {
AllocationStrategy = "allocationStrategy"
},
SpotSpecification = new SpotProvisioningSpecificationProperty {
TimeoutAction = "timeoutAction",
TimeoutDurationMinutes = 123,
// the properties below are optional
AllocationStrategy = "allocationStrategy",
BlockDurationMinutes = 123
}
},
Name = "name",
TargetOnDemandCapacity = 123,
TargetSpotCapacity = 123
});
Synopsis
Constructors
CfnInstanceFleetConfig(Construct, String, ICfnInstanceFleetConfigProps) | Create a new |
CfnInstanceFleetConfig(ByRefValue) | Used by jsii to construct an instance of this class from a Javascript-owned object reference |
CfnInstanceFleetConfig(DeputyBase.DeputyProps) | Used by jsii to construct an instance of this class from DeputyProps |
Properties
CFN_RESOURCE_TYPE_NAME | The CloudFormation resource type name for this resource class. |
CfnProperties | |
ClusterId | The unique identifier of the EMR cluster. |
InstanceFleetType | The node type that the instance fleet hosts. |
InstanceTypeConfigs |
|
LaunchSpecifications | The launch specification for the instance fleet. |
Name | The friendly name of the instance fleet. |
TargetOnDemandCapacity | The target capacity of On-Demand units for the instance fleet, which determines how many On-Demand instances to provision. |
TargetSpotCapacity | The target capacity of Spot units for the instance fleet, which determines how many Spot instances to provision. |
Methods
Inspect(TreeInspector) | Examines the CloudFormation resource and discloses attributes. |
RenderProperties(IDictionary<String, Object>) |
Constructors
CfnInstanceFleetConfig(Construct, String, ICfnInstanceFleetConfigProps)
Create a new AWS::EMR::InstanceFleetConfig
.
public CfnInstanceFleetConfig(Construct scope, string id, ICfnInstanceFleetConfigProps props)
Parameters
- scope Construct
- scope in which this resource is defined.
- id System.String
- scoped id of the resource.
- props ICfnInstanceFleetConfigProps
- resource properties.
CfnInstanceFleetConfig(ByRefValue)
Used by jsii to construct an instance of this class from a Javascript-owned object reference
protected CfnInstanceFleetConfig(ByRefValue reference)
Parameters
- reference Amazon.JSII.Runtime.Deputy.ByRefValue
The Javascript-owned object reference
CfnInstanceFleetConfig(DeputyBase.DeputyProps)
Used by jsii to construct an instance of this class from DeputyProps
protected CfnInstanceFleetConfig(DeputyBase.DeputyProps props)
Parameters
- props Amazon.JSII.Runtime.Deputy.DeputyBase.DeputyProps
The deputy props
Properties
CFN_RESOURCE_TYPE_NAME
The CloudFormation resource type name for this resource class.
public static string CFN_RESOURCE_TYPE_NAME { get; }
Property Value
System.String
CfnProperties
protected override IDictionary<string, object> CfnProperties { get; }
Property Value
System.Collections.Generic.IDictionary<System.String, System.Object>
Overrides
ClusterId
The unique identifier of the EMR cluster.
public virtual string ClusterId { get; set; }
Property Value
System.String
Remarks
InstanceFleetType
The node type that the instance fleet hosts.
public virtual string InstanceFleetType { get; set; }
Property Value
System.String
Remarks
InstanceTypeConfigs
InstanceTypeConfigs
determine the EC2 instances that Amazon EMR attempts to provision to fulfill On-Demand and Spot target capacities.
public virtual object InstanceTypeConfigs { get; set; }
Property Value
System.Object
Remarks
The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.
LaunchSpecifications
The launch specification for the instance fleet.
public virtual object LaunchSpecifications { get; set; }
Property Value
System.Object
Remarks
Name
The friendly name of the instance fleet.
public virtual string Name { get; set; }
Property Value
System.String
Remarks
TargetOnDemandCapacity
The target capacity of On-Demand units for the instance fleet, which determines how many On-Demand instances to provision.
public virtual Nullable<double> TargetOnDemandCapacity { get; set; }
Property Value
System.Nullable<System.Double>
Remarks
When the instance fleet launches, Amazon EMR tries to provision On-Demand instances as specified by InstanceTypeConfig
. Each instance configuration has a specified WeightedCapacity
. When an On-Demand instance is provisioned, the WeightedCapacity
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 a WeightedCapacity
of 5 units, the instance is provisioned, and the target capacity is exceeded by 3 units.
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.
TargetSpotCapacity
The target capacity of Spot units for the instance fleet, which determines how many Spot instances to provision.
public virtual Nullable<double> TargetSpotCapacity { get; set; }
Property Value
System.Nullable<System.Double>
Remarks
When the instance fleet launches, Amazon EMR tries to provision Spot instances as specified by InstanceTypeConfig
. Each instance configuration has a specified WeightedCapacity
. When a Spot instance is provisioned, the WeightedCapacity
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 a WeightedCapacity
of 5 units, the instance is provisioned, and the target capacity is exceeded by 3 units.
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.
Methods
Inspect(TreeInspector)
Examines the CloudFormation resource and discloses attributes.
public virtual void Inspect(TreeInspector inspector)
Parameters
- inspector TreeInspector
- tree inspector to collect and process attributes.
RenderProperties(IDictionary<String, Object>)
protected override IDictionary<string, object> RenderProperties(IDictionary<string, object> props)
Parameters
- props System.Collections.Generic.IDictionary<System.String, System.Object>
Returns
System.Collections.Generic.IDictionary<System.String, System.Object>