クラスターを作成する場合にこの操作を呼び出すことができます。

リクエストパラメーター

フィールド データ型 必須項目 デフォルト値 説明
パラメーター名 文字列 必須 なし クラスターの名前 長さ制約 : 最小長は 1 文字です。 最大長は 64 文字です。 許可されているのは漢字、文字、数字、ハイフン (-)、および下線 (_) だけです。
RegionId 文字列 必須 なし 現在利用可能なリージョンは中国 (杭州)、中国 (上海)、中国 (深セン)、中国 (北京)、中国 (張家口)、米国 (シリコンバレー)、シンガポール、およびドイツ (フランクフルト) です。
ZoneId 文字列 省略可能 なし 中国 (杭州) リージョンでサポートされている使用可能ゾーンのゾーンロケーション ID : cn-hangzhou-b。 中国 (上海) リージョンでサポートされている使用可能なゾーンのゾーンロケーションID : cn-beijing-a、cn-beijing-b、および cn-beijing-c
LogEnable ブール 必須 なし ログの保存を有効にするか無効にするかを指定します。 この機能を使用する場合は確実に OSSを有効化します。
LogPath 文字列 省略可能 LogEnable == true の場合は必須です。 なし OSS に格納されているログの場所です。 書式は以下のとおりです。oss:// bucketname / dir
SecurityGroupId 文字列 省略可能 なし セキュリティグループのID です。 ECS コンソールでセキュリティグループを作成して使用できます。 注: 既存のセキュリティグループを使用している場合、このセキュリティグループにはデフォルトのセキュリティグループポリシー画適用されます。 着信側はポート 22 のみ、発信側はすべてのポートが開かれます。
SecurityGroupName 文字列 省略可能 なし セキュリティグループの ID が指定されていない場合、この名前は新しいセキュリティグループを作成する場合に使用されます。 クラスターが作成された後、作成されたセキュリティグループの ID はクラスターの詳細情報に表示されます。 このセキュリティグループにはデフォルトのセキュリティグループポリシーが適用されます。 着信側はポート 22 のみ、発信側はすべてのポートが開かれます。
IsOpenPublicIp ブール 省略可能 true パブリック IP アドレスを設定するかどうか指定します。 デフォルトの帯域幅は 8 MB です。
EmrVer 文字列 必須 なし E-MapReduce のプロダクトバージョンです。 例 : emr-2.4.1、emr-3.0.1 など
ClusterType 文字列 必須 なし クラスターの種類です。 現在サポートされているのは Hadoop タイプだけです。
HighAvailabilityEnable ブール 省略可能 false 高可用性を有効にするか無効にするかを指定します。 高可用性が有効になっている場合は、最低 2 つのマスターノードが必要です。
MasterPwdEnable ブール 省略可能 なし マスターノードのルートパスワードを設定するかどうかを示します。
MasterPwd 文字列 省略可能 MasterPwdEnable == true の場合は必須です。 なし パスワードは以下の要件を満たす必要があります。 長さ制約 : 最小長は 8 文字です。 最大長は 30 文字です。 3 種類の文字 (大文字、小文字、数字、特殊記号) を含める必要があります。
EcsOrder 文字列 必須 なし クラスターに含まれる ESC インスタンスのマシン情報です。 データは JSON 形式です。 コーディング例 : ”[{‘NodeCount’:1, ‘NodeType’:’MASTER’,’InstanceType’:’ecs.n1.large’,’DiskType’:’CLOUD_EFFICIENCY’,’DiskCapacity’:80,’DiskCount’:1,’Index’:1},{‘NodeCount’:2, ‘NodeType’:’CORE’,’InstanceType’:’ecs.n1.large’,’DiskType’:’CLOUD_EFFICIENCY’,’DiskCapacity’:40,’DiskCount’:4,’Index’:2}]“ EcsOrder
ChargeType 文字列 必須 なし 課金方法です。 PostPaid : 従量課金 PrePaid : サブスクリプション
期間 整数 ChargeType==Subscription の場合のみ必須です。 なし サブスクリプションの長さです。 単位 : 月 有効な値は 1、2、3、4、5、6、7、8、9、12、24、および36 です。
BootstrapActions List BootstrapAction 任意 なし ブートストラップアクションの一覧です。 最大数は 16 です。 最大数を超えると、最初の 16 個の一覧だけが保持されます。
設定 文字列 任意 なし OSS ファイルのパスを提供します。 ファイルコンテンツのユーザーガイドを表示します。
VpcId 文字列 任意 なし VPC ID
VSwitchId 文字列 任意 なし VSwitch の ID です。
NetType 文字列 任意 クラシック 有効な値 : classic および vpc デフォルト値 : false
IoOptimized ブール 任意 true I/O 最適化を有効にするか無効にするかを指定します。 デフォルト値:true
instanceGeneration 文字列 任意 なし ECS インスタンスを生成します。 値を ecs-1 または ecs-2 に設定します。

レスポンスパラメーター

フィールド データ型 説明
ClusterId 文字列 クラスターの ID
EmrOrderId 文字列 EMR サービスオーダーの ID です。
MasterOrderId 文字列 マスターノードのサービスオーダーの ID です。
CoreOrderId 文字列 コアノードサービスオーダーの ID です。

コーディング例

  • リクエストのコーディング例
    https://emr.aliyuncs.com/?Action=CreateCluster
    &Name=smokeTestCreateCluster1
    &ClusterType=HADOOP
    &HighAvailabilityEnable=false
    &SecurityGroupId=sg-234r6xoqe
    &LogEnable=false
    &EmrVer=EMR+1.1.0
    &ZoneId=cn-hangzhou-b
    &IsOpenPublicIp=true
    &RegionId=cn-hangzhou
    &MasterPwdEnable=false
    &VpcId=vpc-239kkz237
    &VSwitch=vsw-234iqq7ae
    &NetType=vpc
    &EcsOrder=[{"nodeCount":1,"nodeType":"master","instanceType":"ecs.n1.large","diskType":"CLOUD_EFFICIENCY","diskCapacity":80}]
    &Common request parameters
  • レスポンスのコーディング例
    JSON 形式
    {
        "RequestId": "34B08619-2636-49F9-AB4E-CD8D347B1E07",
        "InstanceId": "C-13A570B821D4BAB3"
    }