扩容节点
更新时间：2024-09-25
接口描述
对已存在的队列扩容新的节点。
请求结构
POST /v1/cluster/{clusterId}/queue/{queueName}/instances HTTP/1.1
Host: chpc.bj.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号。 |
| clientToken | String | 否 | Query参数 | 幂等性Token，是一个长度不超过64位的ASCII字符串。 |
| clusterId | String | 是 | URL参数 | 扩容节点所属的集群id |
| queueName | String | 是 | URL参数 | 扩容节点所属的队列 |
| count | Integer | 否 | RequestBody参数 | 计算节点数量。取值范围：1~99，默认值为1 |
| spec | String | 是 | RequestBody参数 | 新增计算节点规格，如bcc.g5.c32m128 |
| systemDiskSize | Integer | 否 | RequestBody参数 | 系统盘大小，默认40，单位GB |
| systemDiskType | String | 否 | RequestBody参数 | 系统盘类型，可选类型：StorageType默认cloud_hp1 |
| dataDiskCount | Integer | 否 | RequestBody参数 | 每个节点数据盘个数，默认0个 |
| dataDiskSize | Integer | 否 | RequestBody参数 | 数据盘大小，默认0，单位GB，不创建数据盘 |
| dataDiskType | String | 否 | RequestBody参数 | 数据盘类型，可选类型：StorageType默认空 |
| chargeType | String | 否 | RequestBody参数 | 扩容节点的付费类型，取值范围：Postpaid：按量付费Prepaid：包年包月默认Postpaid |
| period | Integer | 否 | RequestBody参数 | 购买时长默认1； |
| periodUnit | String | 否 | RequestBody参数 | 购买资源的时长。取值范围：MonthYear默认值：Month |
| autoRenew | Boolean | 否 | RequestBody参数 | 是否自动续费，当参数chargeType取值为Prepaid时才生效。取值范围：true：自动续费false：不自动续费默认值：false |
| autoRenewPeriod | Integer | 否 | RequestBody参数 | 自动续费时长。默认为1 |
| autoRenewPeriodUnit | String | 否 | RequestBody参数 | 自动续费时长单位。默认为Month |
| zoneName | String | 否 | RequestBody参数 | 可用区名字，如cn-bj-d默认为集群创建时所在可用区 |
| subnetId | String | 否 | RequestBody参数 | 子网ID。默认为当前集群初始创建的子网ID。 |
| securityGroupId | String | 否 | RequestBody参数 | 安全组ID。默认为当前集群初始创建的安全组ID。 |
| imageId | String | 是 | RequestBody参数 | 镜像ID |
响应头域
除公共头域外，无其他特殊头域。
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| requestId | String | 请求ID |
错误码
| 错误码 | 错误描述 | HTTP状态码 | 中文解释 |
|---|---|---|---|
| BadRequest | description should be different. | 400 | 修改的集群描述应该与当前集群描述不一样 |
| QuotaExceeded | Exceed compute node quota | 403 | 计算节点超出配额 |
| BadRequest | cn-bj-d does not equals to subnetId sbn-xxxxxxx's zoneName cn-bj-f | 400 | zoneName不等于子网的zoneName |
请求示例
POST /v1/cluster/c-arPHgRIb/queue/default_queue/instances
Host: chpc.bj.baidubce.com
Authorization: bce-auth-v1/ALTAKfdDegfDEgedgyhted54dg/2023-08-22T11:35:34Z/1800/host/99a18198dfd91ecaf821207a93ba04176b19afab948c001a5c11beffc7a5ff6b响应示例
{
"requestId": "5193e5d3-f467-4059-96b4-a97fd115f1c4",
"clusterId": "c-arPHgRIb",
"queueName": "default_queue",
"status": "creating"
}