Elastic Compute Service:自動プロビジョニンググループ API 操作を使用して ECS インスタンスをバッチ作成する

RunInstances と CreateAutoProvisioningGroup の比較

RunInstances を使用したインスタンス作成時の問題

RunInstances 操作の制限により、多数のインスタンスを作成する際に、次の表で説明する問題が発生する可能性があります。

自動プロビジョニンググループの利点

RunInstances API 操作を使用して ECS インスタンスをバッチ作成する際に発生する問題に対処するために、Alibaba Cloud は自動プロビジョニンググループを提供しています。自動プロビジョニンググループは、複数の課金方法、ゾーン、インスタンスタイプにまたがるインスタンスクラスターのワンクリックデプロイメントをサポートします。自動プロビジョニンググループを使用すると、安定した計算能力を提供し、スポットインスタンスの回収メカニズムによって引き起こされる不安定性を緩和し、インスタンスを繰り返し手動で作成する必要がなくなります。このセクションでは、自動プロビジョニンググループの利点について説明します。

CreateAutoProvisioningGroup のベストプラクティス

このセクションでは、CreateAutoProvisioningGroup API 操作の Java コードサンプルを提供し、その使用方法をすばやく理解するのに役立てます。

1. Java 用 ECS SDK と Alibaba Cloud コアライブラリをインストールします。

   詳細については、「SDK の概要」をご参照ください。

2. CreateAutoProvisioningGroup API 操作を呼び出す Java コードを記述します。

   以下はコードサンプルです。

   import com.aliyun.ecs20140526.Client;
   import com.aliyun.ecs20140526.models.CreateAutoProvisioningGroupRequest;
   import com.aliyun.ecs20140526.models.CreateAutoProvisioningGroupResponse;
   import com.aliyun.teaopenapi.models.Config;
   import com.aliyun.teautil.models.RuntimeOptions;
   import com.google.gson.Gson;
   
   public class Test {
       public static void main(String[] args_) throws Exception {
           Config config = new Config()
                   .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
                   .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"))
                   .setEndpoint("ecs.cn-heyuan.aliyuncs.com");
           Client client = new Client(config);
   
           CreateAutoProvisioningGroupRequest.CreateAutoProvisioningGroupRequestLaunchTemplateConfig launchTemplateConfig = new CreateAutoProvisioningGroupRequest.CreateAutoProvisioningGroupRequestLaunchTemplateConfig()
                   .setVSwitchId("vsw-f8zadqudz*********")
                   .setInstanceType("ecs.s6-c1m1.small")
                   .setWeightedCapacity(1.0);
   
           CreateAutoProvisioningGroupRequest.CreateAutoProvisioningGroupRequestLaunchConfiguration launchConfiguration = new CreateAutoProvisioningGroupRequest.CreateAutoProvisioningGroupRequestLaunchConfiguration()
                   .setSecurityGroupId("sg-f8zf6vg51*********")
                   .setImageId("aliyun_3_x64_20G_alibase_20250629.vhd")
                   .setSystemDiskCategory("cloud_ssd")
                   .setSystemDiskSize(40);
           CreateAutoProvisioningGroupRequest createAutoProvisioningGroupRequest = new CreateAutoProvisioningGroupRequest()
                   .setAutoProvisioningGroupType("instant")
                   .setRegionId("cn-heyuan")
                   // スポットインスタンスの作成ポリシーを設定します。
                   .setSpotAllocationStrategy("lowest-price")
                   // 従量課金インスタンスの作成ポリシーを設定します。
                   .setPayAsYouGoAllocationStrategy("prioritized")
                   .setTotalTargetCapacity("5")
                   .setPayAsYouGoTargetCapacity("3")
                   .setSpotTargetCapacity("2")
                   .setLaunchConfiguration(launchConfiguration)
                   .setLaunchTemplateConfig(java.util.Arrays.asList(
                           launchTemplateConfig
                   ))
                   .setClientToken("0c593ea1-3bea******************");
           RuntimeOptions runtime = new RuntimeOptions();
           CreateAutoProvisioningGroupResponse response = client.createAutoProvisioningGroupWithOptions(createAutoProvisioningGroupRequest, runtime);
           System.out.println(new Gson().toJson(response.getBody()));
       }
   }

   以下は JSON 応答のサンプルです。

   {
       "autoProvisioningGroupId": "apg-**************",
       "launchResults": {
           "launchResult": [
               {
                   "amount": 0,
                   "errorCode": "NoInstanceStock",
                   "errorMsg": "The instanceTypes are out of usage",
                   "instanceType": "ecs.s6-c1m1.small",
                   "spotStrategy": "NoSpot",
                   "zoneId": "cn-heyuan-b"
               },
               {
                   "amount": 2,
                   "instanceIds": {
                       "instanceId": [
                           "i-f8z8**************icn5",
                           "i-f8z8**************icn6"
                       ]
                   },
                   "instanceType": "ecs.s6-c1m1.small",
                   "spotStrategy": "SpotAsPriceGo",
                   "zoneId": "cn-heyuan-b"
               }
           ]
       },
       "requestId": "CDA21119-7CFD-5B40-A2D0-******8"
   }

   CreateAutoProvisioningGroup を呼び出して自動プロビジョニンググループを作成する場合、バッチインスタンス作成の設定項目を設定するだけでよく、作成プロセスを管理する必要はありません。自動プロビジョニンググループは、ベストエフォートベースでインスタンスを作成します。

   説明

   ベストエフォート配信とは、構成したリソースの組み合わせの一部でインスタンスを作成できない場合、自動プロビジョニンググループが自動的に他の利用可能なリソースの組み合わせに切り替えて作成プロセスを続行することを意味します。この作成メソッドには時間がかかり、実際の結果は指定された作成ポリシーからわずかに偏る可能性があります。