Class InstanceGroup

Provides an Elastic MapReduce Cluster Instance Group configuration. See Amazon Elastic MapReduce Documentation for more information.

NOTE: At this time, Instance Groups cannot be destroyed through the API nor web interface. Instance Groups are destroyed when the EMR Cluster is destroyed. this provider will resize any Instance Group to zero when destroying the resource.

Example Usage

using Pulumi;
using Aws = Pulumi.Aws;

class MyStack : Stack
{
public MyStack()
{
    var task = new Aws.Emr.InstanceGroup("task", new Aws.Emr.InstanceGroupArgs
    {
        ClusterId = aws_emr_cluster.Tf_test_cluster.Id,
        InstanceCount = 1,
        InstanceType = "m5.xlarge",
    });
}

}

Inheritance

System.Object

Resource

CustomResource

InstanceGroup

Inherited Members

CustomResource.Id

Resource.GetResourceType()

Resource.GetResourceName()

Resource.Urn

System.Object.Equals(System.Object)

System.Object.Equals(System.Object, System.Object)

System.Object.GetHashCode()

System.Object.GetType()

System.Object.MemberwiseClone()

System.Object.ReferenceEquals(System.Object, System.Object)

System.Object.ToString()

Namespace: Pulumi.Aws.Emr

Assembly: Pulumi.Aws.dll

Syntax

public class InstanceGroup : CustomResource

Constructors

InstanceGroup(String, InstanceGroupArgs, CustomResourceOptions)

Create a InstanceGroup resource with the given unique name, arguments, and options.

Declaration

public InstanceGroup(string name, InstanceGroupArgs args, CustomResourceOptions options = null)

Parameters

Type	Name	Description
System.String	name	The unique name of the resource
InstanceGroupArgs	args	The arguments used to populate this resource's properties
CustomResourceOptions	options	A bag of options that control this resource's behavior

Properties

AutoscalingPolicy

The autoscaling policy document. This is a JSON formatted string. See EMR Auto Scaling

Declaration

public Output<string> AutoscalingPolicy { get; }

Property Value

Type	Description
Output<System.String>

BidPrice

If set, the bid price for each EC2 instance in the instance group, expressed in USD. By setting this attribute, the instance group is being declared as a Spot Instance, and will implicitly create a Spot request. Leave this blank to use On-Demand Instances.

Declaration

public Output<string> BidPrice { get; }

Property Value

Type	Description
Output<System.String>

ClusterId

ID of the EMR Cluster to attach to. Changing this forces a new resource to be created.

Declaration

public Output<string> ClusterId { get; }

Property Value

Type	Description
Output<System.String>

ConfigurationsJson

A JSON string for supplying list of configurations specific to the EMR instance group. Note that this can only be changed when using EMR release 5.21 or later.

Declaration

public Output<string> ConfigurationsJson { get; }

Property Value

Type	Description
Output<System.String>

EbsConfigs

One or more ebs_config blocks as defined below. Changing this forces a new resource to be created.

Declaration

public Output<ImmutableArray<InstanceGroupEbsConfig>> EbsConfigs { get; }

Property Value

Type	Description
Output<System.Collections.Immutable.ImmutableArray<InstanceGroupEbsConfig>>

EbsOptimized

Indicates whether an Amazon EBS volume is EBS-optimized. Changing this forces a new resource to be created.

Declaration

public Output<bool?> EbsOptimized { get; }

Property Value

Type	Description
Output<System.Nullable<System.Boolean>>

InstanceCount

target number of instances for the instance group. defaults to 0.

Declaration

public Output<int?> InstanceCount { get; }

Property Value

Type	Description
Output<System.Nullable<System.Int32>>

InstanceType

The EC2 instance type for all instances in the instance group. Changing this forces a new resource to be created.

Declaration

public Output<string> InstanceType { get; }

Property Value

Type	Description
Output<System.String>

Name

Human friendly name given to the instance group. Changing this forces a new resource to be created.

Declaration

public Output<string> Name { get; }

Property Value

Type	Description
Output<System.String>

RunningInstanceCount

Declaration

public Output<int> RunningInstanceCount { get; }

Property Value

Type	Description
Output<System.Int32>

Status

Declaration

public Output<string> Status { get; }

Property Value

Type	Description
Output<System.String>

Methods

Get(String, Input<String>, InstanceGroupState, CustomResourceOptions)

Get an existing InstanceGroup resource's state with the given name, ID, and optional extra properties used to qualify the lookup.

Declaration

public static InstanceGroup Get(string name, Input<string> id, InstanceGroupState state = null, CustomResourceOptions options = null)

Parameters

Type	Name	Description
System.String	name	The unique name of the resulting resource.
Input<System.String>	id	The unique provider ID of the resource to lookup.
InstanceGroupState	state	Any extra arguments used during the lookup.
CustomResourceOptions	options	A bag of options that control this resource's behavior

Returns

Type	Description
InstanceGroup