背景信息

在业务需要使用按量付费ECS实例的场景下，RunInstances是使用最频繁的API。RunInstances拥有一次调用能够最多创建100台ECS实例的能力，但是在实际的生产环境中，如果需要超过100台的大批量创建ECS实例场景，直接使用RunInstances会存在一定的技术瓶颈。更多信息，请参见本文RunInstances创建实例时存在的问题章节。

说明 如果您已了解RunInstances批量创建实例过程中存在的技术瓶颈，可以跳过该章节。

为了解决大批量创建ECS实例的需求场景，阿里云提供了弹性供应组，您可以通过CreateAutoProvisioningGroup创建弹性供应组，一键式的部署跨计费方式、跨可用区、跨实例规格族的实例集群。相较于RunInstances，CreateAutoProvisioningGroup更适合大批量创建ECS实例的业务场景。两者的功能对比与优势分析，请参见RunInstances与CreateAutoProvisioningGroup功能对比以及弹性供应组的优势。

RunInstances与CreateAutoProvisioningGroup功能对比

本章节对比RunInstances与CreateAutoProvisioningGroup两接口的部分功能，使您可以快速了解两者的差异，选择合适的创建实例方式。

创建实例的方式由RunInstances更换为CreateAutoProvisioningGroup的部分示例场景：

• 如果您之前使用RunInstances在单可用区、单实例规格的配置下批量创建实例，更换为CreateAutoProvisioningGroup后，您只需配置一组实例规格与可用区的组合，即可实现批量创建实例。
• 如果您之前使用RunInstances时手动设置了业务部署方案，更换为CreateAutoProvisioningGroup后，将由系统为您提供一键式的多可用区、多实例规格、多磁盘配置的部署能力，并且系统提供了多种创建实例的策略供您选择。例如：您之前手动设置了遍历多个实例规格及可用区的方案进行RunInstances调用，以提高实例创建的成功率。更换为CreateAutoProvisioningGroup后，您只需要通过参数配置多个实例规格及可用区的组合，选择合适的创建策略，系统将自动完成批量创建实例的操作。
  

注意 弹性供应组的创建策略存在使用限制，单次最大可创建1000台实例，如果指定了实例规格的权重（WeightedCapacity），则单次创建的最大加权容量为10000。

RunInstances创建实例时存在的问题

基于RunInstances功能的限制，您在大批量创建实例时，可能遇到下表所示的问题。

弹性供应组的优势

针对RunInstances批量创建ECS实例存在的问题，阿里云提供了弹性供应组，解决了大批量创建ECS实例的场景下存在的问题。弹性供应组支持一键部署跨计费方式、跨可用区、跨实例规格族的实例集群。您可以通过弹性供应组稳定提供计算力，缓解抢占式实例的回收机制带来的不稳定因素，免去重复手动创建实例的繁琐操作。本章节主要介绍弹性供应组的优势。

CreateAutoProvisioningGroup最佳实践

本章节提供CreateAutoProvisioningGroup接口对应的Java代码示例，使您快速了解该接口的使用方式。

1. 安装ECS Java SDK以及阿里云核心库。具体操作，请参见安装Java SDK。
   
2. 编写调用CreateAutoProvisioningGroup接口的Java代码。

代码示例如下：

CreateAutoProvisioningGroupRequest request = new CreateAutoProvisioningGroupRequest();
request.setRegionId(regionId);
request.setLaunchConfigurationImageId(RequestHelper.IMAGE_ID);
request.setLaunchConfigurationSecurityGroupId(securityGroupId);
request.setTotalTargetCapacity(totalTargetCapacity);
request.setPayAsYouGoTargetCapacity(payAsYouGoTargetCapacity);
request.setSpotTargetCapacity(spotTargetCapacity);
request.setLaunchConfigurationSystemDiskCategory("cloud_ssd");
request.setLaunchConfigurationSystemDiskSize(40);
request.setAutoProvisioningGroupType("instant");
// 设置抢占式实例的创建策略
request.setSpotAllocationStrategy("lowest-price");
request.setSpotInstancePoolsToUseCount(spotInstancePoolsToUseCount);
// 设置按量付费实例的创建策略
request.setPayAsYouGoAllocationStrategy("prioritized");
request.setMaxSpotPrice(maxSpotPrice);
// 多实例规格，多可用区配置信息，最大支持10种
request.setLaunchTemplateConfigs(launchTemplateConfigs);
request.setClientToken(clientToken);
CreateAutoProvisioningGroupResponse response = client.getAcsResponse(request);

JSON返回值示例如下：

{
    "autoProvisioningGroupId":"apg-****",
    "launchResults":[
        {
            "instanceIds":[
                "i-****"
            ],
            "instanceType":"ecs.c5.large",
            "spotStrategy":"NoSpot",
            "zoneId":"cn-shanghai-b"
        },
       {
            "instanceIds":[],
            "instanceType":"ecs.c5.large",
            "spotStrategy":"NoSpot",
            "zoneId":"cn-shanghai-b",
            "errorCode" : "Invalid.Parameter",
            "errorMsg" : "Specific Parameter 'imageId' is not valid"
        }
    ],
    "requestId":"20DA1E9F-BF7F-4BE7-8204-E4DE58E4FC7B"
}

通过CreateAutoProvisioningGroup创建弹性供应组时，您只需要设置批量创建实例的相关配置项，无需关心创建过程，弹性供应组将以尽力交付的方式，完成创建。

说明 尽力交付的方式是指，当您配置的某些资源组合无法创建实例时，将自动切换到其他可用的资源组合继续进行创建。该方式创建实例需要一定的时间，并且可能导致实际创建结果与创建策略存在一定的偏差。