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

接口说明

修改弹性供应组前，请注意：

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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
RegionId String 是 cn-hangzhou

弹性供应组所在地域的ID。
Action String 否 ModifyAutoProvisioningGroup

系统规定参数，取值：ModifyAutoProvisioningGroup。

AutoProvisioningGroupId String 否 apg-uf6jel2bbl62wh13****

弹性供应组的ID。
DefaultTargetCapacityType String 否 PayAsYouGo

指定差额容量的类型，PayAsYouGoTargetCapacity和SpotTargetCapacity之和小于TotalTargetCapacity时，您可以指定补齐差额容量的实例类型。可选值：

  • PayAsYouGo：使用按量付费实例补齐差额容量。
  • Spot：使用抢占式实例补齐差额容量。
ExcessCapacityTerminationPolicy String 否 no-termination

弹性供应组超过容量时，超额的抢占式实例的关停策略，可选值：

  • no-termination：超额的抢占式实例继续运行。
  • termination：关停超额的抢占式实例，关停后的动作由SpotInstanceInterruptionBehavior指定。
说明 SpotInstanceInterruptionBehavior在创建弹性供应组时设置，且不可修改，更多信息请参见CreateAutoProvisioningGroup。
MaxSpotPrice Float 否 8

弹性供应组内抢占式实例的全局价格上限，同时设置MaxSpotPrice和LaunchTemplateConfig.N.MaxPrice时，以较低者为准。

说明 LaunchTemplateConfig.N.MaxPrice在创建弹性供应组时设置，且不可修改，更多信息请参见CreateAutoProvisioningGroup。
PayAsYouGoTargetCapacity String 否 5

弹性供应组内按量付费实例的目标容量。
SpotTargetCapacity String 否 5

弹性供应组内抢占式实例的目标容量。
TerminateInstancesWithExpiration Boolean 否 false

弹性供应组到期时的关停策略，可选值：

  • true：关停组内抢占式实例，关停后的动作由SpotInstanceInterruptionBehavior指定。
  • false：组内抢占式实例继续运行。
说明 SpotInstanceInterruptionBehavior在创建弹性供应组时设置，且不可修改，更多信息请参见CreateAutoProvisioningGroup。
TotalTargetCapacity String 否 10

弹性供应组的目标总容量，由以下三个部分组成：

  • PayAsYouGoTargetCapacity指定的按量付费实例目标容量。
  • SpotTargetCapacity指定的抢占式实例目标容量。
  • PayAsYouGoTargetCapacity和SpotTargetCapacity之外的差额容量。

返回数据

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

请求ID。

示例

请求示例


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

正常返回示例

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. 子账号鉴权不通过。

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