功能介绍
创建智能购买组。
接口约束
不支持细粒度授权。
不支持包年／包月计费模式。
不支持对接ＱｕｏｔａＭａｎａｇｅｒ，使用默认配置，单个租户更大支持创建３０个智能购买组。
不支持创建ＩＰｖ６实例。
不支持创建１００ｕｍｓ云盘。
不支持网络ｄｒｉｖｅｒ＿ｍｏｄｅ配置。
不支持创建时指定云服务器密码（可通过启动模板指定）。
租户创建的实例个数、ＣＰＵ以及网络配额同租户自身配额保持一致。
不支持创建ＢＭＳ实例。
调试
您可以在ＡＰＩ Ｅｘｐｌｏｒｅｒ中调试该接口。
ＵＲＩ
ＰＯＳＴ ／ｖ２／｛ｄｏｍａｉｎ＿ｉｄ｝／ａｕｔｏ－ｌａｕｎｃｈ－ｇｒｏｕｐｓ
参数说明请参见表１。
表１ 参数说明
参数
是否必选
描述
ｄｏｍａｉｎ＿ｉｄ
是
租户域ＩＤ。
请求参数
表２ 请求参数
参数
是否必选
参数类型
描述
ｎａｍｅ
是
Ｓｔｒｉｎｇ
智能购买组名称。
取值范围：１－６４个字符，只能包含中文、字母、数字、下划线和中划线。
ｄｒｙ＿ｒｕｎ
否
Ｂｏｏｌｅａｎ
创建智能购买组参数核查。
ｔｒｕｅ：发送检查请求，不会创建智能购买组。检查项包括是否填写了必需参数、请求格式等。
如果检查不通过，则返回对应错误。
如果检查通过，则返回２０２状态码。
ｆａｌｓｅ：发送正常请求，通过检查后并且执行创建智能购买组请求。
ｔｙｐｅ
否
Ｓｔｒｉｎｇ
请求类型。
ｒｅｑｕｅｓｔ：一次性。仅在启动时交付实例集群，调度失败后不再重试。
ｍａｉｎｔａｉｎ：持续供应。在启动时尝试交付实例集群，并监控容量，未达到目标容量则尝试继续创建ＥＣＳ实例。
默认值：ｍａｉｎｔａｉｎ
ｇｕａｒａｎｔｅｅ＿ｐｌａｎ＿ｉｄ
否
Ｓｔｒｉｎｇ
算力保障计划ＩＤ。
ｔａｒｇｅｔ＿ｃａｐａｃｉｔｙ
是
Ｉｎｔｅｇｅｒ
智能购买组目标容量。
实例数量或者ＣＰＵ个数目标容量大于等于ｓｔａｂｌｅ＿ｃａｐａｃｉｔｙ。竞价实例的容量为满配容量减去ｓｔａｂｌｅ＿ｃａｐａｃｉｔｙ。
ｓｔａｂｌｅ＿ｃａｐａｃｉｔｙ
否
Ｉｎｔｅｇｅｒ
按需实例目标容量。
目标容量指实例数量或ＣＰＵ个数，必须小于等于ｔａｒｇｅｔ＿ｃａｐａｃｉｔｙ，智能购买组中可以没有按需实例。
ｅｘｃｅｓｓ＿ｆｕｌｆｉｌｌｅｄ＿ｃａｐａｃｉｔｙ＿ｂｅｈａｖｉｏｒ
否
Ｓｔｒｉｎｇ
超过目标容量或目标容量减少时的实例中断行为。
ｔｅｒｍｉｎａｔｅ：释放
ｎｏＴｅｒｍｉｎａｔｉｏｎ：不释放
默认值：ｔｅｒｍｉｎａｔｅ
ｉｎｓｔａｎｃｅｓ＿ｂｅｈａｖｉｏｒ＿ｗｉｔｈ＿ｅｘｐｉｒａｔｉｏｎ
否
Ｓｔｒｉｎｇ
请求到期时正在运行实例的中断行为。
ｔｅｒｍｉｎａｔｅ：释放
ｎｏＴｅｒｍｉｎａｔｉｏｎ：不释放
默认值：ｔｅｒｍｉｎａｔｅ
ｖａｌｉｄ＿ｓｉｎｃｅ
否
Ｓｔｒｉｎｇ
请求开始时间，和ｖａｌｉｄ＿ｕｎｔｉｌ共同确定有效时段。
按照ＩＳＯ８６０１标准表示，并使用ＵＴＣ ＋０时间，格式为ｙｙｙｙ－ＭＭ－ｄｄＴＨＨ：ｍｍ：ｓｓＺ。
默认值：立即生效
ｖａｌｉｄ＿ｕｎｔｉｌ
否
Ｓｔｒｉｎｇ
请求结束时间，和ｖａｌｉｄ＿ｓｉｎｃｅ共同确定有效时段。
按照ＩＳＯ８６０１标准表示，并使用ＵＴＣ ＋０时间，格式为ｙｙｙｙ－ＭＭ－ｄｄＴＨＨ：ｍｍ：ｓｓＺ。
默认值：无限期
ａｌｌｏｃａｔｉｏｎ＿ｓｔｒａｔｅｇｙ
否
Ｓｔｒｉｎｇ
实例分配策略。
ｌｏｗｅｓｔ＿ｐｒｉｃｅ：价格更低策略，智能购买组购买的所有实例的价格总和更低。
ｐｒｉｏｒｉｔｉｚｅｄ：优先级策略，按照规格设定的优先级创建实例。
ｃａｐａｃｉｔｙ＿ｏｐｔｉｍｉｚｅｄ：容量更优化策略，智能购买组购买的实例按照大规格优先进行购买。
默认值：ｌｏｗｅｓｔ＿ｐｒｉｃｅ
ｒｅｇｉｏｎ＿ｓｐｅｃｓ
是
Ａｒｒａｙ ｏｆ ｏｂｊｅｃｔｓ
智能购买组内各区域的资源描述，详情请参见表３。
ｓｕｐｐｌｙ＿ｏｐｔｉｏｎ
否
Ｓｔｒｉｎｇ
资源供给中规格选择策略。
ｓｉｎｇｌａｔｉｏｎ：选择一种规格供给。
ｍｕｌｔｉｐｌｅ：组合多种规格供给。
ｓｐｏｔ＿ｐｒｉｃｅ
否
Ｄｏｕｂｌｅ
用户愿意为竞价实例每小时支付的更高价格。如果ｏｖｅｒｒｉｄｅｓ中没有提供价格，可以使用该价格。
表３ ｒｅｇｉｏｎ＿ｓｐｅｃｓ参数信息
参数
是否必选
参数类型
描述
ｒｅｇｉｏｎ＿ｉｄ
是
Ｓｔｒｉｎｇ
区域ＩＤ。
ｅｘｐｅｃｔ＿ｔａｒｇｅｔ＿ｃａｐａｃｉｔｙ
是
Ｉｎｔｅｇｅｒ
区域内期望的总算力容量。
ｅｘｐｅｃｔ＿ｓｔａｂｌｅ＿ｃａｐａｃｉｔｙ
是
Ｉｎｔｅｇｅｒ
区域内期望的稳定算力容量。
ｌａｕｎｃｈ＿ｔｅｍｐｌａｔｅ＿ｃｏｎｆｉｇ
是
Ｏｂｊｅｃｔ
启动模板配置，详情请参见表４。
表４ ｌａｕｎｃｈ＿ｔｅｍｐｌａｔｅ＿ｃｏｎｆｉｇ参数信息
参数
是否必选
参数类型
描述
ｌａｕｎｃｈ＿ｔｅｍｐｌａｔｅ
是
Ｏｂｊｅｃｔ
实例的启动模板，详情请参见表５。
ｏｖｅｒｒｉｄｅｓ
是
Ａｒｒａｙ ｏｆ ｏｂｊｅｃｔｓ
实例的详细信息，详情请参见表６。
表５ ｌａｕｎｃｈ＿ｔｅｍｐｌａｔｅ参数信息
参数
是否必选
参数类型
描述
ｌａｕｎｃｈ＿ｔｅｍｐｌａｔｅ＿ｉｄ
是
Ｓｔｒｉｎｇ
实例的启动模板ＩＤ，标识一个启动模板。
ｖｅｒｓｉｏｎ
是
Ｓｔｒｉｎｇ
启动模板版本号。
表６ ｏｖｅｒｒｉｄｅ参数信息
参数
是否必选
参数类型
描述
ａｖａｉｌａｂｉｌｉｔｙ＿ｚｏｎｅ＿ｉｄ
是
Ｓｔｒｉｎｇ
可用区ＩＤ。
ｆｌａｖｏｒ＿ｉｄ
是
Ｓｔｒｉｎｇ
实例规格ＩＤ。
ｓｐｏｔ＿ｐｒｉｃｅ
否
Ｄｏｕｂｌｅ
用户愿意为竞价实例每小时支付的更高价格。
ｐｒｉｏｒｉｔｙ
否
Ｉｎｔｅｇｅｒ
优先级。数值越小，优先级越高，优先购买。
取值范围：０到Ｉｎｔｅｇｅｒ．ＭＡＸ＿ＶＡＬＵＥ
默认值：Ｉｎｔｅｇｅｒ．ＭＡＸ＿ＶＡＬＵＥ
ｗｅｉｇｈｔｅｄ＿ｃａｐａｃｉｔｙ
否
Ｄｏｕｂｌｅ
实例规格的权重。取值越高，单台实例满足计算力需求的能力越大，所需的实例数量越小。
取值范围：大于０
可以根据指定实例规格的计算力和集群单节点更低计算力得出权重值。
假设单节点更低计算力为８ｖＣＰＵ、６０ＧＢ，则８ｖＣＰＵ、６０ＧＢ实例规格的权重可设置为１，１６ｖＣＰＵ、１２０ＧＢ实例规格的权重可设置为２。
响应参数
表７ 响应参数
参数
参数类型
描述
ａｕｔｏ＿ｌａｕｎｃｈ＿ｇｒｏｕｐ＿ｉｄ
Ｓｔｒｉｎｇ
创建的智能购买组。
ｅｒｒｏｒ＿ｃｏｄｅ
Ｉｎｔｅｇｅｒ
错误码。
请求失败时，响应体中包含错误。
请求成功时，响应消息体中不包含错误码。
ｅｒｒｏｒ＿ｍｓｇ
Ｓｔｒｉｎｇ
错误描述。
请求失败时，响应体中包含错误描述。
请求成功时，响应消息体中不包含错误描述。
请求示例
创建一个智能购买组，名称为“ｔｅｓｔ”，持续供应类型，目标容量为１０，按需实例目标容量为５。
ＰＯＳＴ ｈｔｔｐｓ：／／｛ｅｎｄｐｏｉｎｔ｝／ｖ２／｛ｄｏｍａｉｎ＿ｉｄ｝／ａｕｔｏ－ｌａｕｎｃｈ－ｇｒｏｕｐｓ
｛
＂ｎａｍｅ＂：＂ｔｅｓｔ＂，
＂ｇｕａｒａｎｔｅｅ＿ｐｌａｎ＿ｉｄ＂：＂ｐｌａｎ＿ｉｄ＂，
＂ｔｙｐｅ＂：＂ｍａｉｎｔａｉｎ＂，
＂ｔａｒｇｅｔ＿ｃａｐａｃｉｔｙ＂：１０，
＂ｓｔａｂｌｅ＿ｃａｐａｃｉｔｙ＂：５，
＂ｅｘｃｅｓｓ＿ｆｕｌｆｉｌｌｅｄ＿ｃａｐａｃｉｔｙ＿ｂｅｈａｖｉｏｒ＂：＂ｔｅｒｍｉｎａｔｅ＂，
＂ｉｎｓｔａｎｃｅｓ＿ｂｅｈａｖｉｏｒ＿ｗｉｔｈ＿ｅｘｐｉｒａｔｉｏｎ＂：＂ｔｅｒｍｉｎａｔｅ＂，
＂ｖａｌｉｄ＿ｓｉｎｃｅ＂：＂２０２０－０４－０４Ｔ１５：５８：１３Ｚ＂，
＂ｖａｌｉｄ＿ｕｎｔｉｌ＂：＂２０２１－０４－０６Ｔ１５：５８：１３Ｚ＂，
＂ｒｅｇｉｏｎ＿ｓｐｅｃｓ＂：［
｛
＂ｒｅｇｉｏｎ＿ｉｄ＂：＂ｒｅｇｉｏｎ１＂，
＂ｅｘｐｅｃｔ＿ｔａｒｇｅｔ＿ｃａｐａｃｉｔｙ＂：１０，
＂ｅｘｐｅｃｔ＿ｓｔａｂｌｅ＿ｃａｐａｃｉｔｙ＂：５，
＂ｌａｕｎｃｈ＿ｔｅｍｐｌａｔｅ＿ｃｏｎｆｉｇ＂：｛
＂ｌａｕｎｃｈ＿ｔｅｍｐｌａｔｅ＂：｛
＂ｌａｕｎｃｈ＿ｔｅｍｐｌａｔｅ＿ｉｄ＂：＂ｃ５１６ｃ３５０－７０９１－４４９０－９３３８－４７ｄｄｂ９０３６０ｆ２＂，
＂ｖｅｒｓｉｏｎ＂：＂１．０＂
｝，
＂ｏｖｅｒｒｉｄｅｓ＂：［
｛
＂ａｖａｉｌａｂｉｌｉｔｙ＿ｚｏｎｅ＿ｉｄ＂：＂ａｚ１＂，
＂ｆｌａｖｏｒ＿ｉｄ＂：＂ｓ３．ｌａｒｇｅ．２＂，
＂ｓｐｏｔ＿ｐｒｉｃｅ＂：２，
＂ｐｒｉｏｒｉｔｙ＂：４，
＂ｗｅｉｇｈｔｅｄ＿ｃａｐａｃｉｔｙ＂：６
｝，
｛
＂ａｖａｉｌａｂｉｌｉｔｙ＿ｚｏｎｅ＿ｉｄ＂：＂ａｚ２＂，
＂ｆｌａｖｏｒ＿ｉｄ＂：＂ｓ３．ｌａｒｇｅ．２＂，
＂ｓｐｏｔ＿ｐｒｉｃｅ＂：２，
＂ｐｒｉｏｒｉｔｙ＂：４，
＂ｗｅｉｇｈｔｅｄ＿ｃａｐａｃｉｔｙ＂：１２
｝，
｛
＂ａｖａｉｌａｂｉｌｉｔｙ＿ｚｏｎｅ＿ｉｄ＂：＂ａｚ３＂，
＂ｆｌａｖｏｒ＿ｉｄ＂：＂ｓ３．ｌａｒｇｅ．２＂，
＂ｓｐｏｔ＿ｐｒｉｃｅ＂：２，
＂ｐｒｉｏｒｉｔｙ＂：４，
＂ｗｅｉｇｈｔｅｄ＿ｃａｐａｃｉｔｙ＂：２
｝
］
｝
｝
］，
＂ａｌｌｏｃａｔｉｏｎ＿ｓｔｒａｔｅｇｙ＂：＂ｌｏｗｅｓｔ＿ｐｒｉｃｅ＂，
＂ｓｐｏｔ＿ｐｒｉｃｅ＂：０．５，
＂ｓｕｐｐｌｙ＿ｏｐｔｉｏｎ＂：＂ｍｕｌｔｉｐｌｅ＂，
＂ｄｒｙ＿ｒｕｎ＂：ｆａｌｓｅ
｝
响应示例
｛
＂ａｕｔｏ＿ｌａｕｎｃｈ＿ｇｒｏｕｐ＿ｉｄ＂： ＂ｃ５１６ｃ３５０－７０９１－４４９０－９３３８－４７ｄｄｂ９０３６０ｆ２＂
｝
返回值
请参考通用请求返回值。
错误码
请参考错误码。
华为云共建智能世界云底座[52] 华为公有云专属云主机DeH服务[51] 华为云场景化解决方案[49] 华为公有云产品[44] 华为云云主机[43] 华为云产品服务[43] 华为云服务器应用[43] 华为弹性云服务器[39] 华为公有云架构解决方案[38] 华为云提供的服务[37] 华为虚拟私有云vpc[37] 华为公有云介绍[32] 华为公有云提供哪些计算服务[30] 华为云漏洞扫描[27] 华为云软件开发服务[27] 华为公有云和私有云区别[27] 华为云域名注册[26] 华为云官网登陆[26] 华为公有云解决方案[26] 华为私有云产品有哪些[26] 华为私有云服务[25] 华为云数据库[23] 华为云安全[22] 华为公有云官网[22] 华为私有云的搭建方案[22] 华为云弹性云服务器应用[21] 华为公有云平台[20] 华为公有云行业解决方案[20] 华为私有云解决方案服务定制领导者[20] [19] 华为私有云服务器[19] 华为私有云网格结构[19] 华为公有云视讯解决方案[18] 华为云官网[17] 华为云速建站[17] 华为私有云架构[17] 华为云优势[16] 华为云服务器[16] 华为私有云部署架构[16] 华为云企业邮箱服务 (SAAS[15] 华为云邮箱[15] 华为公有云是什么[15] 华为公有云架构[15] 华为云迁移解决方案[14] 华为公有云解决方案服务定制领导者[14] 华为私有云解决方案[14] 云邮箱）[13] 华为云园区解决方案[13] 华为云服务总代理[13] 华为云速智能客服[13] 华为公有云服务[13] 华为私有云搭建方案[13] 云与计算咨询服务[12] 云与计算培训服务[11] 华为云备份[11] 华为云服务器配置[11] 华为云服务服务中心[11] 华为云服务核心分销商[11] 华为公有云[11] 华为私有云搭建[11] 云迁移与运营支撑服务[10] 公有云私有云混合云[10] 华为云服务器ECS[10] 华为云服务器成功案例[10] 华为云解决方案[10] 华为公有云通用解决方案[9] 华为智慧云课堂解决方案[9] 华为云数据解决方案[8] 华为云是什么[8] 华为私有云平台[8] 云与计算客户支持与运维使能服务[7] 华为云官网网站[7] 华为云智慧教育解决方案[7] 华为云智慧校园解决方案[7] 华为云桌面系统集成商[7] 华为云经销商[7] 华为代理公司有哪些[7] 华为私有云方案[7] 智慧教育云平台解决方案[7] 华为云服务器试用[6] 华为云网站建设服务器[6] 华为手机代理加盟[6] 华为私有云[6] 大数据使能服务[6] 智慧教育云计算解决方案[6] 华为云云主机 [5] 华为云智慧***解决方案[5] 华为云桌面总代理商[5] 云与计算客户支持服务[4] 华为云产品介绍[4] 华为云智慧制造解决方案[4] 华为云场景化解决方案[3] 华为公有云官网[3] 华为公有云通用解决方案[3] 华为弹性云服务器[3] 华为公有云产品 [3] 华为云产品服务[2] 华为云域名注册[2] 华为云数据库[2] 华为云智慧校园解决方案[2] 华为云服务器应用[2] 华为云服务器成功案例[2] 华为云软件开发服务[2] 华为公有云产品[2] 华为公有云介绍[2] 华为公有云和私有云区别[2] 华为公有云服务[2] 华为公有云架构[2] 华为公有云架构解决方案[2] 华为公有云视讯解决方案[2] 华为公有云解决方案[2] 华为私有云产品有哪些[2] 华为私有云服务[2] 华为私有云架构[2] 智慧教育云计算解决方案[2] 云规划设计与实施服务[2] 云邮箱[2] 华为云产品报价[2] 华为公有云通用解决方案 [2] 华为云服务器成功案例[1] 华为云桌面系统集成商[1] 云与计算客户支持与运维使能服务[1] 云迁移与运营支撑服务[1] 云迁移与运营支撑服务 [1] 华为云共建智能世界云底座[1] 华为云备份[1] 华为云安全[1] 华为云官网登陆[1] 华为云弹性云服务器应用[1] 华为云提供的服务[1] 华为云数据解决方案[1] 华为云智慧制造解决方案[1] 华为云服务器[1] 华为云服务核心分销商 [1] 华为云漏洞扫描[1] 华为云迁移解决方案 [1] 华为云速智能客服[1] 华为云邮箱[1] 华为公有云专属云主机DeH服务[1] 华为公有云是什么[1] 华为公有云行业解决方案[1] 华为私有云搭建[1] 华为私有云方案[1] 华为私有云服务.华为公有云专属云主机DeH服务.华为云产品报价[1] 华为私有云的搭建方案[1] 华为私有云网格结构[1] 华为私有云解决方案[1] 华为私有云部署架构[1] 为云产品服务[1] 云与计算咨询服务 [1] 云与计算客户支持与运维使能服务 [1] 云与计算客户支持与运维使能服务 云与计算客户支持服务[1] 华为云是什么 [1] 华为云软件开发服[1] 华为云速智能客服 [1] 华为代理加盟[1] 华为公有云架构解决方案 [1] 华为公有云解决方案服务定制领导者 [1] 华为弹性云[1] 华为弹性云服务器 华为云域名注册 华为云服务器应用[1] 华为私有云搭建 [1] 华为私有云搭建方案 [1] 华为私有云部署架构 [1] 大数据使能服务 [1] 撒[1]
