创建弹性伸缩组
更新时间:2026-07-22
描述
创建伸缩组的接口。
OpenAPI Explorer
去调试
您可以在 OpenAPI Explorer 中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /v2/group
2Host: as.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "groupName": groupName,
7 "zoneInfo": [
8 {
9 "zone": zone,
10 "subnetId": subnetId,
11 "subnetUuid": subnetUuid,
12 "subnetName": subnetName,
13 "subnetType": subnetType,
14 "nodeCount": nodeCount
15 }
16 ],
17 "config": {
18 "minNodeNum": minNodeNum,
19 "maxNodeNum": maxNodeNum,
20 "cooldownInSec": cooldownInSec,
21 "expectNum": expectNum,
22 "initNum": initNum
23 },
24 "keypairId": keypairId,
25 "keypairName": keypairName,
26 "keepImageLogin": keepImageLogin,
27 "blb": [
28 {
29 "blbId": blbId,
30 "blbName": blbName,
31 "blbType": blbType,
32 "sgIds": [sgIds]
33 }
34 ],
35 "blbUnbindWaitTime": blbUnbindWaitTime,
36 "nodes": [
37 {
38 "spec": spec,
39 "cpuCount": cpuCount,
40 "memoryCapacityInGB": memoryCapacityInGB,
41 "sysDiskType": sysDiskType,
42 "sysDiskInGB": sysDiskInGB,
43 "billing": {
44 "paymentTiming": paymentTiming,
45 "reservation": {
46 "reservationLengthInMonth": reservationLengthInMonth
47 }
48 },
49 "bidModel": bidModel,
50 "bidPrice": bidPrice,
51 "ephemeralDisks": [
52 {
53 "storageType": storageType,
54 "sizeInGB": sizeInGB
55 }
56 ],
57 "instanceType": instanceType,
58 "gpuCard": gpuCard,
59 "gpuCount": gpuCount,
60 "fpgaCard": fpgaCard,
61 "fpgaCount": fpgaCount,
62 "containsFpga": containsFpga,
63 "kunlunCard": kunlunCard,
64 "kunlunCount": kunlunCount,
65 "imageType": imageType,
66 "imageId": imageId,
67 "imageName": imageName,
68 "osType": osType,
69 "osName": osName,
70 "osVersion": osVersion,
71 "osArch": osArch,
72 "securityGroupId": securityGroupId,
73 "adminPass": adminPass,
74 "adminPassType": adminPassType,
75 "securityGroupName": securityGroupName,
76 "totalCount": totalCount,
77 "aspId": aspId,
78 "cds": [
79 {
80 "volumeType": volumeType,
81 "sizeInGB": sizeInGB,
82 "snapshotId": snapshotId,
83 "snapshotName": snapshotName
84 }
85 ],
86 "zoneSubnet": zoneSubnet,
87 "userData": userData,
88 "priorities": priorities,
89 "templateId": templateId
90 }
91 ],
92 "eip": {
93 "ifBindEip": ifBindEip,
94 "bandwidthInMbps": bandwidthInMbps,
95 "eipProductType": eipProductType,
96 "purchaseType": purchaseType
97 },
98 "eipConfig": {
99 "eipGroupBindStrategy": eipGroupBindStrategy,
100 "eipGroupUnbindStrategy": eipGroupUnbindStrategy,
101 "eipGroupIdList": [eipGroupIdList],
102 "increase": {
103 "enabled": enabled,
104 "strategy": strategy
105 },
106 "decrease": {
107 "enabled": enabled
108 },
109 "bandwidth": {
110 "max": max,
111 "min": min,
112 "standard": standard
113 }
114 },
115 "billing": {
116 "paymentTiming": paymentTiming,
117 "reservation": {
118 "reservationLengthInMonth": reservationLengthInMonth
119 }
120 },
121 "rds": [rds],
122 "scs": [scs],
123 "healthCheck": {
124 "healthCheckInterval": healthCheckInterval,
125 "graceTime": graceTime
126 },
127 "expansionStrategy": expansionStrategy,
128 "shrinkageStrategy": shrinkageStrategy,
129 "assignTagInfo": {
130 "resourceId": resourceId,
131 "relationTag": relationTag,
132 "tags": [
133 {
134 "tagKey": tagKey,
135 "tagValue": tagValue
136 }
137 ]
138 },
139 "cmdConfig": {
140 "hasDecreaseCmd": hasDecreaseCmd,
141 "decCmdStrategy": decCmdStrategy,
142 "decCmdData": decCmdData,
143 "decCmdTimeout": decCmdTimeout,
144 "decCmdManual": decCmdManual,
145 "hasIncreaseCmd": hasIncreaseCmd,
146 "incCmdStrategy": incCmdStrategy,
147 "incCmdData": incCmdData,
148 "incCmdTimeout": incCmdTimeout,
149 "incCmdManual": incCmdManual
150 },
151 "bccNameConfig": {
152 "bccName": bccName,
153 "bccHostname": bccHostname,
154 "autoSeqSuffix": autoSeqSuffix,
155 "openHostnameDomain": openHostnameDomain
156 }
157}
请求头域
除公共头域外,无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| groupName | String | 是 | RequestBody参数 | 伸缩组名称 |
| zoneInfo | List<ZoneInfo> | 是 | RequestBody参数 | 伸缩组所在可用区 |
| config | GroupConfig | 是 | RequestBody参数 | 伸缩组边界配置 |
| keypairId | String | 否 | RequestBody参数 | 创建实例时使用的密钥对 ID |
| keypairName | String | 否 | RequestBody参数 | 创建实例时使用的密钥对名称 |
| keepImageLogin | Integer | 否 | RequestBody参数 | 是否使用镜像预置密码,非必填,默认为0,当为1时使用预置密码,这时镜像类型必须为自定义镜像 |
| blb | List<BlbInfo> | 否 | RequestBody参数 | 伸缩组绑定BLB,可绑定多个 |
| blbUnbindWaitTime | Integer | 否 | RequestBody参数 | |
| nodes | List<NodeInfo> | 是 | RequestBody参数 | 伸缩组扩容时节点配置 |
| eip | EipInfo | 否 | RequestBody参数 | 购买新eip是的配置,如果使用共享带宽eip,请配置eipConfig字段 |
| eipConfig | EipConfig | 否 | RequestBody参数 | 共享带宽EIP配置信息 |
| billing | BillingInfo | 否 | RequestBody参数 | 伸缩组Billing,后付费-post,抢占式-bidding |
| rds | List<String> | 否 | RequestBody参数 | 伸缩组绑定RDS,可绑定多个 |
| scs | List<String> | 否 | RequestBody参数 | 伸缩组绑定SCS,可绑定多个 |
| healthCheck | HealthCheckConfig | 否 | RequestBody参数 | 健康检查相关配置 |
| expansionStrategy | expansionStrategy | 否 | RequestBody参数 | 伸缩组扩容时策略,单可用区时默认为Priority;Priority - 在单可用区优先创建,Balanced - 在所有可用区均衡创建 |
| shrinkageStrategy | shrinkageStrategy | 否 | RequestBody参数 | 伸缩组缩容时策略;Earlier - 删除先创建实例,Later - 删除后创建实例 |
| assignTagInfo | AssignTagInfo | 是 | RequestBody参数 | 伸缩组关联标签 |
| cmdConfig | CmdConfig | 是 | RequestBody参数 | 扩缩容脚本配置 |
| bccNameConfig | BccNameConfig | 否 | RequestBody参数 | 创建 bcc 名称相关配置 |
返回头域
除公共头域,无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| groupId | String | 伸缩组ID |
| orderId | List<String> | 订单ID |
请求示例
Plain Text
1POST /v2/group
2Host: as.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "groupName" : "demoGroup",
7 "config" : {
8 "minNodeNum" : 1,
9 "expectNum" : -1,
10 "maxNodeNum" : "15",
11 "cooldownInSec" : "60"
12 },
13 "healthCheck" : {
14 "healthCheckInterval" : 15,
15 "graceTime" : 300
16 },
17 "blb" : [ {
18 "blbName" : "test_blb",
19 "blbType" : "Blb",
20 "blbId" : "lb-d575b684"
21 } ],
22 "rds" : [ ],
23 "scs" : [ ],
24 "expansionStrategy" : "Priority",
25 "shrinkageStrategy" : "Earlier",
26 "zoneInfo" : [ {
27 "zone" : "zoneA",
28 "subnetId" : "sbn-4wgp88t13u8e"
29 }, {
30 "zone" : "zoneD",
31 "subnetId" : "sbn-0f2c1331b651"
32 } ],
33 "assignTagInfo" : {
34 "relationTag" : true,
35 "tags" : [ {
36 "tagKey" : "默认项目",
37 "tagValue" : "test"
38 } ]
39 },
40 "nodes" : [ {
41 "cpuCount" : 2,
42 "memoryCapacityInGB" : 8,
43 "sysDiskType" : "premium_ssd",
44 "sysDiskInGB" : 20,
45 "instanceType" : 13,
46 "productType" : "postpay",
47 "imageId" : "df8a3999-a04e-41fb-abf3-c392d90c378d",
48 "imageType" : "public",
49 "osType" : "linux",
50 "securityGroupId" : "g-6ud2rvseymdr",
51 "spec" : "bcc.g4.c2m8",
52 "ephemeralDisks" : [ ],
53 "aspId" : "",
54 "userData" : "ZWNobyAiaGVsbG8gdXNlcmRhdGEi",
55 "priorities" : 1,
56 "zoneSubnet" : "[{\"zone\":\"zoneA\",\"subnetId\":\"sbn-4wgp88t13u8e\",\"subnetName\":\"test(192.168.0.0/24)\",\"subnetUuid\":\"c33ab5dd-2357-4f4e-b526-e3e2e4a8e2c2\"},{\"zone\":\"zoneD\",\"subnetId\":\"sbn-0f2c1331b651\",\"subnetName\":\"test-qa(192.168.3.0/24)\",\"subnetUuid\":\"8df84b73-0c75-43c8-822d-c7df8cbd93ee\"}]",
57 "totalCount" : 1,
58 "cds" : [ ]
59 } ],
60 "eipConfig" : { },
61 "eip" : {
62 "ifBindEip" : true,
63 "bandwidthInMbps" : 12,
64 "eipProductType" : "bandwidth",
65 "purchaseType" : "BGP"
66 },
67 "billing" : {
68 "paymentTiming" : "postpay"
69 },
70 "cmdConfig" : {
71 "hasDecreaseCmd" : true,
72 "decCmdStrategy" : "Proceed",
73 "decCmdData" : "echo \"hello scale down cmd\"",
74 "decCmdTimeout" : 3600,
75 "decCmdManual" : true,
76 "hasIncreaseCmd" : true,
77 "incCmdStrategy" : "Proceed",
78 "incCmdData" : "echo \"hello scale up cmd\"",
79 "incCmdTimeout" : 3600,
80 "incCmdManual" : true
81 },
82 "bccNameConfig" : {
83 "bccName" : "demo-bcc",
84 "bccHostname" : "demo-bcc",
85 "autoSeqSuffix" : true
86 }
87}
返回示例
Plain Text
1200 Success
2
3{
4 "groupId" : "asg-xxxxxx",
5 "orderId" : [ ]
6}
评价此篇文章
