Elastic Compute Service:自動プロビジョニンググループ API を使用した ECS インスタンスの一括作成

RunInstances と CreateAutoProvisioningGroup の比較

RunInstances を使用した一括作成時の問題点

RunInstances オペレーションには、多数のインスタンスを作成する際に以下の制限があります。

自動プロビジョニンググループのメリット

自動プロビジョニンググループは、支払い方法、ゾーン、インスタンスタイプをまたいだワンクリックデプロイメントをサポートすることで、RunInstances の制限を解消します。安定したコンピューティング能力を提供し、スポットインスタンスの再取得リスクを軽減し、繰り返しの手動作成を不要にします。

CreateAutoProvisioningGroup のベストプラクティス

以下の Java コードサンプルは、CreateAutoProvisioningGroup を呼び出す方法を示しています。

1. ECS SDK for Java および Alibaba Cloud コアライブラリをインストールします。

   SDK 概要をご参照ください。

2. Java で CreateAutoProvisioningGroup を呼び出します。

   コードサンプル：

   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 を使用すると、バッチ作成パラメーターを設定するだけで、グループがベストエフォートで作成プロセスを処理します。

   説明

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