/ 弹性云服务器 ecs/ api参考/ api/ 智能购买组管理/ 修改智能购买组
更新时间：2023-07-06 gmt 08:00
查看pdf

修改智能购买组-九游平台

功能介绍

更新指定智能购买组信息。

调试

您可以在中调试该接口。

uri

put /v2/{domain_id}/auto-launch-groups/{auto_launch_group_id}

参数说明请参见表1。
表1 参数说明

参数

是否必选

描述

domain_id

是

租户域id。

auto_launch_group_id

是

智能购买组id。

请求消息

请求参数如表2所示。

表2 请求参数

参数

是否必选

参数类型

描述

name

否

string

智能购买组名称。

取值范围：1-64个字符，只能包含中文、字母、数字、下划线和中划线。

guarantee_plan_id

否

string

算力保障计划id。

target_capacity

否

integer

智能购买组目标容量。

实例数量或者cpu个数目标容量大于等于stable_capacity。竞价实例的容量为满配容量减去stable_capacity。

stable_capacity

否

integer

按需实例目标容量。

目标容量指实例数量或cpu个数，必须小于等于target_capacity，智能购买组中可以没有按需实例。

excess_fulfilled_capacity_behavior

否

string

超过目标容量或目标容量减少时的实例中断行为。

  • terminate：释放
  • notermination：不释放

默认值：terminate

instances_behavior_with_expiration

否

string

请求到期时正在运行实例的中断行为。

  • terminate：释放
  • notermination：不释放

默认值：terminate

spot_price

否

double

用户愿意为竞价实例每小时支付的最高价格。如果overrides中没有提供价格，可以使用该价格。

响应消息

表3 响应参数

参数

参数类型

描述

error_code

integer
错误码。
  • 请求失败时，响应体中包含错误。
  • 请求成功时，响应消息体中不包含错误码。

error_msg

string
错误描述。
  • 请求失败时，响应体中包含错误描述。
  • 请求成功时，响应消息体中不包含错误描述。

请求示例

修改指定智能购买组信息，包括名称、算力保障计划id、目标容量、按需实例目标容量等。

put https://{endpoint}/v2/{domain_id}/auto_launch_groups/{auto_launch_group_id}
{
    "name": "autolaunchgroup1",
    "guarantee_plan_id": "plan_id",
    "target_capacity": 10,
    "stable_capacity": 5,
    "excess_fulfilled_capacity_behavior": "terminate",
    "instances_behavior_with_expiration": "terminate",
    "spot_price": 0.5
}

响应示例

无

返回值

请参考通用请求返回值。

错误码

请参考。

父主题： 智能购买组管理

相关文档

网站地图