Elastic Compute Service:Batch create ECS instances with auto provisioning group APIs

Contexto

O Alibaba Cloud oferece grupos de provisionamento automático para a criação de instâncias em grande escala. Ao chamar a CreateAutoProvisioningGroup, você implanta um cluster de instâncias em diferentes métodos de faturamento, zonas e tipos de instância em uma única ação. Em comparação com a RunInstances, a CreateAutoProvisioningGroup atende melhor aos cenários que exigem um grande volume de instâncias ECS. Consulte Comparação entre RunInstances e CreateAutoProvisioningGroup e Vantagens dos grupos de provisionamento automático.

Comparação entre RunInstances e CreateAutoProvisioningGroup

Problemas ao criar instâncias em lote com RunInstances

A operação RunInstances apresenta as limitações abaixo ao provisionar um grande número de instâncias.

Vantagens dos grupos de provisionamento automático

Os grupos de provisionamento automático superam as limitações da RunInstances ao permitir a implantação com um clique em diferentes métodos de faturamento, zonas e tipos de instância. Eles garantem poder computacional estável, reduzem os riscos de devolução de instâncias spot e eliminam a necessidade de criação manual repetitiva.

Práticas recomendadas para CreateAutoProvisioningGroup

O exemplo de código Java a seguir demonstra como chamar a operação CreateAutoProvisioningGroup.

1. Instale o SDK do ECS para Java e a biblioteca principal do Alibaba Cloud.

   Consulte Visão geral do SDK.

2. Chame a operação CreateAutoProvisioningGroup usando Java.

   Exemplo de código:

   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")
                   // Set the creation policy for spot instances.
                   .setSpotAllocationStrategy("lowest-price")
                   // Set the creation policy for pay-as-you-go instances.
                   .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()));
       }
   }

   Exemplo de resposta 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"
   }

   Com a CreateAutoProvisioningGroup, você define os parâmetros de criação em lote e o grupo gerencia o processo de criação com base no melhor esforço.

   Nota

   A entrega de melhor esforço significa que, se algumas combinações de recursos não conseguirem criar instâncias, o grupo alternará automaticamente para outras combinações disponíveis. Esse processo leva tempo e o resultado real pode diferir ligeiramente da política especificada.