调用ModifyAutoProvisioningGroup接口修改一个弹性供应组的设置。

接口说明

修改弹性供应组前,请注意:

  • 如果修改了供应组容量或者容量相关设置,供应组会在修改完成后执行一次调度任务。
  • 如果供应组处于删除中状态,无法修改供应组。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String ModifyAutoProvisioningGroup

系统规定参数,取值:ModifyAutoProvisioningGroup

RegionId String cn-hangzhou

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

AutoProvisioningGroupId String apg-bp67acfmxazb4ph****

弹性供应组的ID。

ExcessCapacityTerminationPolicy String no-termination

弹性供应组超过目标总容量时,是否停止超额的抢占式实例。取值范围:

  • no-termination:继续运行。
  • termination:停止。停止后的下一步动作由SpotInstanceInterruptionBehavior指定。
说明 SpotInstanceInterruptionBehavior在创建弹性供应组时设置,且不可修改。
DefaultTargetCapacityType String Spot

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

  • PayAsYouGo:按量付费实例
  • Spot:抢占式实例
TerminateInstancesWithExpiration Boolean false

弹性供应组到期时,是否停止抢占式实例。取值范围:

  • true:停止。停止后的下一步动作由SpotInstanceInterruptionBehavior指定。
  • false:继续运行。
说明 SpotInstanceInterruptionBehavior在创建弹性供应组时设置,且不可修改。
MaxSpotPrice Float 0.5

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

说明 同时设置了MaxSpotPrice和LaunchTemplateConfig.N.MaxPrice时,以最低值为准。LaunchTemplateConfig.N.MaxPrice在创建弹性供应组时设置,且不可修改。
TotalTargetCapacity String 70

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

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

PayAsYouGoTargetCapacity String 30

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

SpotTargetCapacity String 30

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

AutoProvisioningGroupName String apg-test

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

返回数据

名称 类型 示例值 描述
RequestId String B48A12CD-1295-4A38-A8F0-0E92C937****

请求ID。

示例

请求示例

http(s)://ecs.aliyuncs.com/?Action=ModifyAutoProvisioningGroup
&RegionId=cn-hangzhou
&AutoProvisioningGroupId=apg-bp67acfmxazb4ph****
&TotalTargetCapacity=70
&MaxSpotPrice=0.5
&<公共请求参数>

正常返回示例

XML 格式

<ModifyAutoProvisioningGroupResponse>
    <RequestId>928E2273-5715-46B9-A730-238DC996****</RequestId>
</ModifyAutoProvisioningGroupResponse>

JSON 格式

{
    "RequestId": "B48A12CD-1295-4A38-A8F0-0E92C937****"
}

错误码

HttpCode 错误码 错误信息 描述
403 Forbidden.RAM User not authorized to operate on the specified resource, or this API doesn't support RAM. 您没有操作此资源的权限,或者此 API 不支持 RAM 角色。

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