メニュー
AWS CloudFormation
ユーザーガイド (API Version 2010-05-15)

AWS::EMR::InstanceGroupConfig

AWS::EMR::InstanceGroupConfig リソースは、Amazon EMR クラスターのタスクインスタンスグループを設定します。

注記

インスタンスグループは削除できません。インスタンスグループを削除すると、AWS CloudFormation はインスタンス数をゼロ (0) に設定します。

構文

AWS CloudFormation テンプレートでこのエンティティを宣言するには、次の構文を使用します。

JSON

Copy
{ "Type" : "AWS::EMR::InstanceGroupConfig", "Properties" : { "AutoScalingPolicy" : AutoScalingPolicy, "BidPrice" : String, "Configurations" : [ Configuration, ... ], "EbsConfiguration" : EBSConfiguration, "InstanceCount" : Integer, "InstanceRole" : String, "InstanceType" : String, "JobFlowId": String, "Market" : String, "Name" : String } }

YAML

Copy
Type: "AWS::EMR::InstanceGroupConfig" Properties: AutoScalingPolicy: AutoScalingPolicy BidPrice: String Configurations: - Configuration EbsConfiguration" : EBSConfiguration InstanceCount" : Integer InstanceRole" : String InstanceType" : String JobFlowId": String Market" : String Name" : String

プロパティ

注記

各プロパティの制約と有効な値の詳細については、Amazon EMR API Reference の「InstanceGroupConfig」を参照してください。

AutoScalingPolicy

Amazon EMR クラスター内のコアインスタンスグループまたはタスクインスタンスグループの自動スケーリングポリシー。自動スケーリングポリシーは、CloudWatch メトリクスの値に応じてインスタンスグループが動的に EC2 インスタンスを追加および終了する方法を定義します。詳細については、Amazon EMR API Reference の「PutAutoScalingPolicy」を参照してください。

Required: No

Type: Amazon EMR InstanceGroupConfig AutoScalingPolicy

更新に伴う要件: 中断はありません。

BidPrice

インスタンス (ノード) をスポットインスタンスとして起動する場合、インスタンスグループ内の各 Amazon EC2 インスタンスの入札価格 (USD)。

Required: No

Type: String

更新に伴う要件: 置換

Configurations

このインスタンスグループに適用する設定のリスト。詳細については、Amazon EMR Release Guideの「Configuring Applications」を参照してください。

Required: No

Amazon EMR クラスターの設定Type: リスト

更新に伴う要件: 置換

EbsConfiguration

Amazon Elastic Block Store (Amazon EBS) ストレージボリュームをインスタンスにアタッチするように設定します。

Required: No

Type: Amazon EMR EbsConfiguration

更新に伴う要件: 置換

InstanceCount

インスタンスグループ内で起動するインスタンスの数。

Required: Yes

Type: Integer

更新に伴う要件: 中断はありません。

InstanceRole

Amazon EMR クラスターでのサーバーのロール (TASK など)。詳細については、Amazon EMR 管理ガイドの「インスタンスグループ」を参照してください。

注記

現在、有効な値は TASK のみです。マスターインスタンスグループとコアインスタンスグループは、AWS::EMR::Cluster リソースの一部として設定します。

Required: Yes

Type: String

更新に伴う要件: 置換

InstanceType

インスタンスグループを構成するすべてのインスタンスの EC2 インスタンスタイプ。詳細については、Amazon EMR 管理ガイドの「インスタンスの構成」を参照してください。

Required: Yes

Type: String

更新に伴う要件: 置換

JobFlowId

このインスタンスグループに関連付ける Amazon EMR クラスターの ID。

Required: Yes

Type: String

更新に伴う要件: 置換

Market

このグループ内にインスタンスをプロビジョニングした Marketplace のタイプ (ON_DEMAND または SPOT)。詳細については、「Amazon EC2 購入オプション」を参照してください。

Required: No

Type: String

更新に伴う要件: 置換

Name

インスタンスグループの名前。

Required: No

Type: String

更新に伴う要件: 置換

戻り値

参照番号

このリソースの論理 ID が Ref 組み込み関数に提供されると、Ref によりインスタンスグループ ID (ig-ABC12DEF3456 など) が返されます。

Ref 関数の使用方法の詳細については、「Ref」を参照してください。

次の例では、TestCluster クラスターにタスクインスタンスグループを追加します。インスタンスグループには 2 つの m3.xlarge インスタンスが含まれています。

JSON

Copy
"TestInstanceGroupConfig": { "Type": "AWS::EMR::InstanceGroupConfig", "Properties": { "InstanceCount": 2, "InstanceType": "m3.xlarge", "InstanceRole": "TASK", "Market": "ON_DEMAND", "Name": "cfnTask2", "JobFlowId": { "Ref": "cluster" } } }

YAML

Copy
TestInstanceGroupConfig: Type: "AWS::EMR::InstanceGroupConfig" Properties: InstanceCount: 2 InstanceType: "m3.xlarge" InstanceRole: "TASK" Market: "ON_DEMAND" Name: "cfnTask2" JobFlowId: Ref: "cluster"

このページの内容: