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

Contexto

A Alibaba Cloud oferece grupos de provisionamento automático para criar instâncias em grande escala. Ao chamar a operação CreateAutoProvisioningGroup, implante 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 grande volume de instâncias ECS. Consulte Comparação entre RunInstances e CreateAutoProvisioningGroup e Benefícios dos grupos de provisionamento automático.

Comparação entre RunInstances e CreateAutoProvisioningGroup

Problemas da RunInstances na criação em lote

A operação RunInstances apresenta as limitações abaixo ao criar grande volume de instâncias.

Benefícios dos grupos de provisionamento automático

Os grupos de provisionamento automático superam as limitações da RunInstances ao permitir 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ções manuais repetitivas.

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 da 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 operação CreateAutoProvisioningGroup, defina os parâmetros de criação em lote e o grupo gerenciará o processo de criação com base no melhor esforço.

   Nota

   A entrega com 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 divergir levemente da política especificada.

Referências