本接口用于修改 Serverless StarRocks 实例计算组的节点数量。
接口说明
请确保在使用该接口前，已充分了解 Serverless StarRocks 产品的收费方式和计费项。 调用该接口时，您需要注意：
-
只有标准版实例支持修改计算组节点数量，入门版实例不支持。
-
实例必须处于运行中（Running）状态。
-
FE 节点的数量不能是偶数，且 FE 节点不支持缩容。
修改节点数量后，计费变化情况如下：
-
按量付费：按照新的节点数量计费。
-
包年包月：在计费周期内，会根据新旧配置的价格差和剩余天数（从次日 0 点到有效期结束）来计算应补缴的费用。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
sr:ModifyNodeNumber |
get |
*Instance
|
无 | 无 |
请求语法
POST /webapi/resourceChange/modifyNodeNumber HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| InstanceId |
string |
是 |
实例 ID。 |
c-b25e21e24388**** |
| NodeGroupId |
string |
是 |
计算组 ID。 |
ng-3d5ce6454354**** |
| Target |
integer |
是 |
目标节点数量。 |
3 |
| PromotionOptionNo |
string |
否 |
||
| Parallelism |
integer |
否 |
||
| TerminationGracePeriodSeconds |
integer |
否 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| HttpStatusCode |
integer |
HTTP 请求状态码。 |
200 |
| RequestId |
string |
请求 ID。 |
32A44F0D-BFF6-5664-999A-218BBDE7**** |
| Success |
boolean |
请求是否成功。 |
false |
| ErrCode |
string |
错误码。 |
InvalidParams |
| ErrMessage |
string |
错误信息。 |
Invalid params: [instance not exists]. |
| Data |
integer |
订单 ID。 |
24151320976**** |
| AccessDeniedDetail |
string |
权限校验失败详情。 |
{ "PolicyType": "AccountLevelIdentityBasedPolicy", "AuthPrincipalOwnerId": "xxx", "EncodedDiagnosticMessage": "xxx", "AuthPrincipalType": "xxx", "AuthPrincipalDisplayName": "xxx", "NoPermissionType": "ImplicitDeny", "AuthAction": "sr:xxx" } |
示例
正常返回示例
JSON格式
{
"HttpStatusCode": 200,
"RequestId": "32A44F0D-BFF6-5664-999A-218BBDE7****",
"Success": false,
"ErrCode": "InvalidParams",
"ErrMessage": "Invalid params: [instance not exists].",
"Data": 0,
"AccessDeniedDetail": "{ \"PolicyType\": \"AccountLevelIdentityBasedPolicy\", \"AuthPrincipalOwnerId\": \"xxx\", \"EncodedDiagnosticMessage\": \"xxx\", \"AuthPrincipalType\": \"xxx\", \"AuthPrincipalDisplayName\": \"xxx\", \"NoPermissionType\": \"ImplicitDeny\", \"AuthAction\": \"sr:xxx\" }"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。