全部产品
Search
文档中心

云服务器 ECS:CreateAutoProvisioningGroup

更新时间:Oct 16, 2023

调用CreateAutoProvisioningGroup接口创建一个弹性供应组。

接口说明

  • 弹性供应是一个使用抢占式实例和按量付费实例快速部署实例集群的方案,支持一键部署跨计费方式、跨可用区、跨实例规格族的实例集群。更多信息,请参见使用弹性供应组API批量创建ECS实例
  • 弹性供应以供应组为载体调度和维护计算资源,您可以通过弹性供应组稳定提供计算力,缓解抢占式实例的回收机制带来的不稳定因素。
  • 弹性供应为免费功能,但是您需要为通过弹性供应组创建出的实例资源付费。更多信息,请参见抢占式实例计费按量付费
  • 当您同时指定启动模板(LaunchTemplateId)与启动配置信息(LaunchConfiguration.*)时,系统优先使用启动模板。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称

类型

是否必选

示例值

描述

Action String CreateAutoProvisioningGroup

系统规定参数。取值:CreateAutoProvisioningGroup

RegionId String cn-hangzhou

弹性供应组所在地域的ID,您可以调用DescribeRegions查看最新的阿里云地域列表。

ResourceGroupId String rg-bp67acfmxazb4p****

弹性供应组所在的企业资源组ID。

AutoProvisioningGroupName String apg-test

弹性供应组的名称。长度为2~128个英文或中文字符。必须以大小写字母或中文开头,不能以http://https://开头。可以包含数字、半角冒号(:)、下划线(_)或者短划线(-)。

AutoProvisioningGroupType String maintain

弹性供应组的交付类型。取值范围:

  • request:一次性异步交付。供应组仅在启动时异步交付实例集群,调度失败后不再重试。
  • instant:一次性同步交付。供应组仅在启动时同步创建实例,并在请求响应中返回创建成功的实例列表和创建失败的原因。
  • maintain:持续供应。供应组在启动时尝试交付实例集群,并监控实时容量,未达到目标容量则尝试继续创建ECS实例。

默认值:maintain。

SpotAllocationStrategy String diversified

创建抢占式实例的策略。取值范围:

  • lowest-price:成本优化策略。选择价格最低的实例规格。
  • diversified:均衡可用区分布策略。在扩展启动模板指定的可用区内创建实例,均匀分布到各可用区。
  • capacity-optimized:容量优化分布策略。根据库存情况,选择最优的实例规格和可用区进行创建。

默认值:lowest-price。

SpotInstanceInterruptionBehavior String terminate

竞价实例中断时的行为。取值范围:

  • stop:停止实例。
  • terminate:释放实例。

默认值:terminate。

SpotInstancePoolsToUseCount Integer 2

SpotAllocationStrategylowest-price时生效,表示弹性供应组选择价格最低的实例规格创建实例的数量。

取值范围:低于LaunchTemplateConfig.N中N的取值。

PayAsYouGoAllocationStrategy String prioritized

创建按量付费实例的策略。取值范围:

  • lowest-price:成本优化策略。选择价格最低的实例规格。
  • prioritized:优先级策略。按照LaunchTemplateConfig.N.Priority设定的优先级创建实例。

默认值:lowest-price。

ExcessCapacityTerminationPolicy String termination

弹性供应组实时容量超过目标容量并触发缩容时,是否释放缩容的实例。取值范围:

  • termination:释放缩容的实例。
  • no-termination:只将缩容的实例移出弹性供应组。

默认值:no-termination。

ValidFrom String 2019-04-01T15:10:20Z

弹性供应组的启动时间,和ValidUntil共同确定有效时段。

按照ISO 8601标准表示,并使用UTC+0时间,格式为yyyy-MM-ddTHH:mm:ssZ。

默认值:该接口立即生效的时间戳。

ValidUntil String 2019-06-01T15:10:20Z

弹性供应组的到期时间,和ValidFrom共同确定有效时段。

按照ISO 8601标准表示,并使用UTC+0时间,格式为yyyy-MM-ddTHH:mm:ssZ。

默认值:2099-12-31T23:59:59Z。

TerminateInstancesWithExpiration Boolean true

弹性供应组到期时,是否释放组内实例。取值范围:

  • true:释放组内实例。
  • false:只将组内实例移出弹性供应组。

默认值:false。

TerminateInstances Boolean true

删除弹性供应组时,是否释放组内实例。取值范围:

  • true:释放组内实例。
  • false:保留组内实例。

默认值:false。

MaxSpotPrice Float 2

弹性供应组内抢占式实例的最高价格。

说明 同时设置了MaxSpotPriceLaunchTemplateConfig.N.MaxPrice时,以最低值为准。
TotalTargetCapacity String 60

弹性供应组的目标总容量。取值范围:正整数。

总容量必须大于等于PayAsYouGoTargetCapacity(指定的按量付费实例目标容量)和SpotTargetCapacity(指定的抢占式实例目标容量)取值之和。

PayAsYouGoTargetCapacity String 30

弹性供应组内,按量付费实例的目标容量。取值范围:小于等于TotalTargetCapacity的参数取值。

SpotTargetCapacity String 20

弹性供应组内,抢占式实例的目标容量。取值范围:小于等于TotalTargetCapacity的参数取值。

DefaultTargetCapacityType String Spot

PayAsYouGoTargetCapacitySpotTargetCapacity之和小于TotalTargetCapacity时,指定差额容量的计费方式。取值范围:

  • PayAsYouGo:按量付费实例。
  • Spot:抢占式实例。

默认值:Spot。

LaunchTemplateId String lt-bp1fgzds4bdogu03****

弹性供应组关联的实例启动模板的ID,您可以调用DescribeLaunchTemplates查询可用的实例启动模板。同时指定启动模板与启动配置信息(LaunchConfiguration.*)时,优先使用启动模板。

LaunchTemplateVersion String 1

弹性供应组关联的实例启动模板的版本,您可以调用DescribeLaunchTemplateVersions查询可用的实例启动模板版本。

默认值:启动模板的默认版本。

Description String testDescription

弹性供应组的描述信息。

ClientToken String 0c593ea1-3bea-11e9-b96b-88e9fe637760

保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符,且不能超过64个字符。更多信息,请参见如何保证幂等性

LaunchConfiguration.ImageId String m-bp1g7004ksh0oeuc****

镜像ID。启动实例时选择的镜像资源,您可以调用DescribeImages查询可以使用的镜像资源。同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.SecurityGroupId String sg-bp15ed6xe1yxeycg****

实例所属的安全组ID。同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.IoOptimized String optimized

是否为I/O优化实例。取值范围:

  • none:非I/O优化。
  • optimized:I/O优化。

已停售的实例规格实例默认值是none,其他实例规格默认值是optimized。

同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.InternetChargeType String PayByTraffic

网络计费类型。取值范围:

  • PayByBandwidth:按固定带宽计费。
  • PayByTraffic:按使用流量计费。
说明 按使用流量计费模式下的出入带宽峰值都是带宽上限,不作为业务承诺指标。当出现资源争抢时,带宽峰值可能会受到限制。如果您的业务需要有带宽的保障,请使用按固定带宽计费模式。

同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.InternetMaxBandwidthIn Integer 10

公网入带宽最大值,单位为Mbit/s。取值范围:

  • 当公网出带宽小于等于10 Mbit/s时:1~10,默认为10。
  • 当公网出带宽大于10 Mbit/s时:1~LaunchConfiguration.InternetMaxBandwidthOut的取值,默认为LaunchConfiguration.InternetMaxBandwidthOut的取值。

同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.InternetMaxBandwidthOut Integer 10

公网出带宽最大值,单位为Mbit/s。取值范围:0~100。

默认值:0。

同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.InstanceName String k8s-node-[1,4]-alibabacloud

实例名称。长度为2~128个字符,必须以大小写字母或中文开头,不能以http://https://开头。可以包含中文、英文、数字、半角冒号(:)、下划线(_)、半角句号(.)或者短划线(-)。

默认值:实例的InstanceId

创建多台ECS实例时,您可以批量设置有序的实例名称。具体操作,请参见批量设置有序的实例名称或主机名称

同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.HostName String k8s-node-[1,4]-ecshost

实例主机名称。限制说明如下:

  • 半角句号(.)和短划线(-)不能作为首尾字符,更不能连续使用。
  • Windows实例:字符长度为2~15,不支持半角句号(.),不能全是数字。允许大小写英文字母、数字和短划线(-)。
  • 其他类型实例(Linux等):字符长度为2~64,支持多个半角句号(.),点之间为一段,每段允许大小写英文字母、数字和短划线(-)。
  • 不支持同时设置LaunchConfiguration.HostNameLaunchConfiguration.HostNames.N,否则会返回报错信息。
  • 同时指定启动模板与启动配置信息时,优先使用启动模板。
LaunchConfiguration.InstanceDescription String Instance_Description

实例描述。长度为2~256个英文或中文字符,不能以http://https://开头。同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.KeyPairName String KeyPair_Name

密钥对名称。

  • Windows实例,忽略该参数。默认为空。
  • Linux实例的密码登录方式会被初始化成禁止。

同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.RamRoleName String RAM_Name

实例RAM角色名称。您可以使用RAM API ListRoles查询您已创建的实例RAM角色。同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.SecurityEnhancementStrategy String Active

是否开启安全加固。取值范围:

  • Active:启用安全加固,只对公共镜像生效。
  • Deactive:不启用安全加固,对所有镜像类型生效。

同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.UserData String ZWNobyBoZWxsbyBlY3Mh

实例自定义数据。需要以Base64方式编码,原始数据最多为16 KB。同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.SystemDiskCategory String cloud_ssd

系统盘的云盘种类。取值范围:

  • cloud_efficiency:高效云盘。
  • cloud_ssd:SSD云盘。
  • cloud_essd:ESSD云盘。
  • cloud:普通云盘。

已停售的实例规格且非I/O优化实例默认值为cloud,否则默认值为cloud_efficiency。

同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.SystemDiskSize Integer 40

系统盘大小。单位为GiB,取值范围:20~500。该参数的取值必须大于或者等于max{20, LaunchConfiguration.ImageId对应的镜像大小}。

默认值:max{40, 参数LaunchConfiguration.ImageId对应的镜像大小}。

同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.SystemDiskName String cloud_ssdSystem

系统盘名称。长度为2~128个英文或中文字符。必须以大小写字母或中文开头,不能以http://https://开头。可以包含数字、半角句号(.)、半角冒号(:)、下划线(_)或者短划线(-)。

默认值:空。

同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.SystemDiskDescription String SystemDisk_Description

系统盘的描述。长度为2~256个英文或中文字符,不能以http://https://开头。

同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.SystemDiskPerformanceLevel String PL0

创建ESSD云盘作为系统盘使用时,设置云盘的性能等级。取值范围:

  • PL0(默认):单盘最高随机读写IOPS 1万。
  • PL1:单盘最高随机读写IOPS 5万。
  • PL2:单盘最高随机读写IOPS 10万。
  • PL3:单盘最高随机读写IOPS 100万。

有关如何选择ESSD性能等级,请参见ESSD云盘

同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.PasswordInherit Boolean true

是否使用镜像预设的密码。取值范围:

  • true:使用。
  • false:不使用。

同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.ResourceGroupId String rg-bp67acfmxazb4p****

实例所在的企业资源组ID。同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.CreditSpecification String Standard

设置突发性能实例的运行模式。取值范围:

默认值:无。

同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.Password String EcsV587!

实例的密码。长度为8至30个字符,必须同时包含大小写英文字母、数字和特殊符号中的三类字符。特殊符号可以是:

()~!@#$%^&*-_+=|{}:;'<>,.?/ 其中,Windows实例不能以正斜线(/)为密码首字符。 同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.DeploymentSetId String ds-bp1frxuzdg87zh4p****

部署集ID。

LaunchTemplateConfig.N.VSwitchId String vsw-sn5bsitu4lfzgc5o7****

扩展启动模板中,ECS实例加入的虚拟交换机的ID。扩展模板中启动的ECS实例的可用区由虚拟交换机决定。

说明 设置了LaunchTemplateConfig后,LaunchTemplateConfig.N.VSwitchId为必选参数。
LaunchTemplateConfig.N.MaxPrice double 3

扩展启动模板中,抢占式实例的价格上限。

说明 设置了LaunchTemplateConfig后,LaunchTemplateConfig.N.MaxPrice为必选参数。
LaunchTemplateConfig.N.Priority Integer 1

扩展启动模板的优先级,取值为0时优先级最高。取值范围:0 ~ +∞。

LaunchTemplateConfig.N.InstanceType String ecs.g5.large

扩展启动模板对应的实例规格,N的取值范围:1~20。取值范围:请参见实例规格族

LaunchTemplateConfig.N.WeightedCapacity double 2

扩展启动模板中,实例规格的权重。取值越高,单台实例满足计算力需求的能力越大,所需的实例数量越小。取值范围:大于0。

您可以根据指定实例规格的计算力和集群单节点最低计算力得出权重值。假设单节点最低计算力为8 vCPU、60 GiB,则:

  • 8 vCPU、60 GiB的实例规格权重可以设置为1。
  • 16 vCPU、120 GiB的实例规格权重可以设置为2。
LaunchTemplateConfig.N.MaxQuantity Integer false
说明 该参数正在邀测中,暂不支持使用。
LaunchTemplateConfig.N.Cores.N Integer 2

实例规格的vCPU内核数目,用于筛选符合要求的实例规格范围。更多信息,请参见实例规格族。N的取值范围:1~10。

LaunchTemplateConfig.N.Memories.N Float 4

实例规格的内存大小,单位为GiB,用于筛选符合要求的实例规格范围。更多信息,请参见实例规格族。N的取值范围:1~10。

LaunchTemplateConfig.N.InstanceFamilyLevel String EnterpriseLevel

实例规格族级别,用于筛选符合要求的实例规格范围。取值范围:

  • EntryLevel:入门级,即共享型实例规格。成本更低,但是无法保证实例计算性能的稳定。适用于平时CPU使用率低的业务场景。更多信息,请参见共享型
  • EnterpriseLevel:企业级。性能稳定,资源独享,适用于对稳定性要求高的业务场景。更多信息,请参见实例规格族
  • CreditEntryLevel:积分入门级,即突发性能实例。通过CPU积分来保证计算性能,适用于平时CPU使用率低、偶有突发CPU使用率的情况。更多信息,请参见突发性能实例

N的取值范围:1~10。

LaunchTemplateConfig.N.ExcludedInstanceTypes.N String ecs.n1.small/ecs.n1.*/*7*

需要排除的实例规格。通过使用通配符(*)可以排除单个规格或者整个规格族。例如:

  • ecs.c6.large:表示排除ecs.c6.large实例规格。
  • ecs.c6.*:表示排除整个c6规格族的实例规格。
LaunchTemplateConfig.N.Architectures.N String X86

实例规格所属的架构类型。取值范围:

  • X86:X86计算。
  • Heterogeneous:异构计算,例如GPU或FPGA等。
  • BareMental:弹性裸金属服务器。
  • Arm:Arm计算。
  • SuperComputeCluster:超级计算集群。

默认值:包含所有架构类型。

LaunchTemplateConfig.N.BurstablePerformance String Include

是否为性能突发实例规格。取值范围:

  • Exclude:不包含性能突发实例规格。
  • Include:包含性能突发实例规格。
  • Required:只包含性能突发实例规格。

默认值:Include。

LaunchConfiguration.DataDisk.N.PerformanceLevel String PL1

创建ESSD云盘作为数据盘使用时,设置云盘的性能等级。N的取值必须和LaunchConfiguration.DataDisk.N.Category中的N保持一致。取值范围:

  • PL0:单盘最高随机读写IOPS 1万。
  • PL1(默认):单盘最高随机读写IOPS 5万。
  • PL2:单盘最高随机读写IOPS 10万。
  • PL3:单盘最高随机读写IOPS 100万。

有关如何选择ESSD性能等级,请参见ESSD云盘

同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.DataDisk.N.KmsKeyId String 0e478b7a-4262-4802-b8cb-00d3fb40****

数据盘对应的KMS密钥ID。同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.DataDisk.N.Description String DataDisk_Description

数据盘的描述。长度为2~256个英文或中文字符,不能以http://https://开头。同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.DataDisk.N.SnapshotId String s-bp17441ohwka0yuh****

创建数据盘N使用的快照。N的取值范围为1~16。

指定该参数后,参数LaunchConfiguration.DataDisk.N.Size会被忽略,实际创建的云盘大小为指定的快照的大小。不能使用早于2013年7月15日(含)创建的快照,请求会报错被拒绝。

同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.DataDisk.N.Size Integer 20

第N个数据盘的容量大小,N的取值范围为1~16,单位为GiB。取值范围:

  • cloud_efficiency:20~32768。
  • cloud_ssd:20~32768。
  • cloud_essd:具体取值范围与LaunchConfiguration.DataDisk.N.PerformanceLevel的取值有关。
    • PL0:40~32768。
    • PL1:20~32768。
    • PL2:461~32768。
    • PL3:1261~32768
  • cloud:5~2000。
说明 该参数的取值必须大于等于参数LaunchConfiguration.DataDisk.N.SnapshotId指定的快照的大小。

同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.DataDisk.N.Device String /dev/vd1

数据盘的挂载点。同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.DataDisk.N.DiskName String cloud_ssdData

数据盘名称。长度为2~128个英文或中文字符。必须以大小写字母或中文开头,不能以http://https://开头。可以包含数字、半角句号(.)、半角冒号(:)、下划线(_)或者短划线(-)。

默认值:空。

同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.DataDisk.N.Category String cloud_ssd

数据盘N的云盘类型。N的取值范围为1~16。取值范围:

  • cloud_efficiency:高效云盘。
  • cloud_ssd:SSD云盘。
  • cloud_essd:ESSD云盘。
  • cloud:普通云盘。

对于I/O优化实例,默认值为cloud_efficiency。对于非I/O优化实例,默认值为cloud。

同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.DataDisk.N.DeleteWithInstance Boolean true

数据盘是否随实例释放。取值范围:

  • true:数据盘随实例释放。
  • false:数据盘不随实例释放。

默认值:true。

同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.DataDisk.N.Encrypted Boolean false

数据盘N是否加密。取值范围:

  • true:加密。
  • false:不加密。

默认值:false。

同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.Tag.N.Key String TestKey

实例的标签键。N的取值范围:1~20。一旦传入该值,则不允许为空字符串。最多支持128个字符,不能以aliyun和acs:开头,不能包含http://https://。同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.Tag.N.Value String TestValue

实例的标签值。N的取值范围:1~20。一旦传入该值,可以为空字符串。最多支持128个字符,不能以acs:开头,不能包含http://或者https://。同时指定启动模板与启动配置信息时,优先使用启动模板。

SystemDiskConfig.N.DiskCategory String cloud_ssd

实例系统盘类型。您可通过该参数指定多种候选磁盘类型,指定顺序作为各磁盘类型的优先级顺序,当某一种磁盘不可用时,自动更换磁盘类型。取值范围:

  • cloud_efficiency:高效云盘。
  • cloud_ssd:SSD云盘。
  • cloud_essd:ESSD云盘。
  • cloud:普通云盘。
DataDiskConfig.N.DiskCategory String cloud_efficiency

实例数据盘类型。您可通过该参数指定多种候选磁盘类型,指定顺序作为各磁盘类型的优先级顺序,当某一种磁盘不可用时,自动更换磁盘类型。取值范围:

  • cloud_efficiency:高效云盘。
  • cloud_ssd:SSD云盘。
  • cloud_essd:ESSD云盘。
  • cloud:普通云盘。
LaunchConfiguration.HostNames.N String ecs-host-01

为一台或多台实例指定不同的主机名称。限制说明如下:

  • 仅创建一次性同步交付类型的弹性供应组(AutoProvisioningGroupType=instant)时,该参数生效。
  • N表示实例个数,取值范围为1~1000,且需要和TotalTargetCapacity参数值保持一致。
  • 半角句号(.)和短划线(-)不能作为首尾字符,更不能连续使用。
  • Windows实例:字符长度为2~15,不支持半角句号(.),不能全是数字。允许包含大小写英文字母、数字和短划线(-)。
  • 其他类型实例(Linux等):字符长度为2~64,支持多个半角句号(.),半角句号(.)之间为一段,每段允许包含大小写英文字母、数字和短划线(-)。
  • 不支持同时设置LaunchConfiguration.HostNameLaunchConfiguration.HostNames.N,否则会返回报错信息。
  • 同时指定启动模板与启动配置信息时,优先使用启动模板。
MinTargetCapacity String 20

弹性供应组的目标最小容量。取值范围:正整数。

当您设置该参数后,需要注意:

  • 仅创建一次性同步交付类型的弹性供应组(AutoProvisioningGroupType=instant)时,该参数生效。
  • 如果当前地域下的实例库存小于该参数值,则会导致调用接口失败,不会创建实例。
  • 如果当前地域下的实例库存大于该参数值,则按照已设置的其他参数值正常创建实例。
LaunchConfiguration.SecurityGroupIds.N String sg-bp15ed6xe1yxeycg****

实例所属的安全组ID。同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.SystemDisk.Encrypted String false

系统盘N是否加密。取值范围:

  • true:加密。
  • false:不加密。

默认值:false。

同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.SystemDisk.KMSKeyId String 0e478b7a-4262-4802-b8cb-00d3fb40****

系统盘对应的KMS密钥ID。

同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.SystemDisk.EncryptAlgorithm String aes-256

系统盘加密算法。取值范围:

  • aes-256。
  • sm4-128。

默认值:aes-256。

同时指定启动模板与启动配置信息时,优先使用启动模板。

LaunchConfiguration.Arn.N.Rolearn String acs:ram::123456789012****:role/adminrole

该参数暂未开放使用。

LaunchConfiguration.Arn.N.RoleType String 34458433936495****:alice

该参数暂未开放使用。

LaunchConfiguration.Arn.N.AssumeRoleFor Long 123456789012****

该参数暂未开放使用。

HibernationOptionsConfigured Boolean false
说明 该参数正在邀测中,暂未开放使用。
LaunchConfiguration.AutoReleaseTime String 2018-01-01T12:05:00Z

按量付费实例的自动释放时间。按照ISO 8601标准表示,使用UTC+0时间。格式为:yyyy-MM-ddTHH:mm:ssZ

  • 如果秒(ss)取值不是00,则自动取为当前分钟(mm)开始时。
  • 最短释放时间为当前时间半小时之后。
  • 最长释放时间不能超过当前时间三年。

返回数据

名称

类型

示例值

描述

AutoProvisioningGroupId String apg-sn54avj8htgvtyh8****

弹性供应组的ID。

RequestId String 745CEC9F-0DD7-4451-9FE7-8B752F39****

请求ID。

LaunchResults Array of LaunchResult

弹性供应组创建的实例组成的集合。该集合值仅当弹性供应组的交付类型为一次性同步交付(instant)时返回。

LaunchResult
ZoneId String cn-hangzhou-g

实例所在的可用区ID。

ErrorMsg String Specific parameter is not valid.

当实例创建失败时,返回的错误信息。

InstanceType String ecs.g5.large

实例规格。

ErrorCode String InvalidParameter

当实例创建失败时,返回的错误码。

SpotStrategy String NoSpot

按量实例的抢占策略。可能值:

  • NoSpot:正常按量付费实例。
  • SpotWithPriceLimit:设置上限价格的抢占式实例。
  • SpotAsPriceGo:系统自动出价,跟随当前市场实际价格。
Amount Integer 1

成功创建的实例ID列表内的实例数量。

InstanceIds Array of String ["i-bp67acfmxazb4p****"]

成功创建的实例ID列表。

示例

请求示例

http(s)://ecs.aliyuncs.com/?Action=CreateAutoProvisioningGroup
&LaunchTemplateId=lt-bp1fgzds4bdogu03****
&RegionId=cn-hangzhou
&TotalTargetCapacity=60
&SpotInstancePoolsToUseCount=2
&ExcessCapacityTerminationPolicy=termination
&TerminateInstancesWithExpiration=true
&TerminateInstances=false
&PayAsYouGoTargetCapacity=30
&SpotTargetCapacity=20
&DefaultTargetCapacityType=Spot
&LaunchTemplateConfig.1.InstanceType=ecs.g5.large
&LaunchTemplateConfig.1.MaxPrice=3
&LaunchTemplateConfig.1.VSwitchId=vsw-sn5bsitu4lfzgc5o7****
&LaunchTemplateConfig.1.WeightedCapacity=2
&LaunchTemplateConfig.1.Priority=1
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateAutoProvisioningGroupResponse>
  <AutoProvisioningGroupId>apg-sn54avj8htgvtyh8****</AutoProvisioningGroupId>
  <RequestId>745CEC9F-0DD7-4451-9FE7-8B752F39****</RequestId>
</CreateAutoProvisioningGroupResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "AutoProvisioningGroupId" : "apg-sn54avj8htgvtyh8****",
  "RequestId" : "745CEC9F-0DD7-4451-9FE7-8B752F39****"
}

错误码

HttpCode

错误码

错误信息

描述

400 InvalidParameter %s 无效的参数。
400 InternalError The request processing has failed due to some unknown error. 内部错误,请重试。
400 MissingParameter %s 缺失参数,请检查参数是否完整。
400 InvalidVSwitchId.NotFound %s 指定的交换机不存在。

访问错误中心查看更多错误码。