Queries the price for modifying the disk type of nodes in a compute group.
Operation description
Before you call this API, make sure that you understand the billing methods and billable items of the Serverless StarRocks product. Take note of the following:
-
Only standard instances support disk scale-out. Entry-level instances do not.
-
Only instances that have a compute group of the Standard Edition (standard) specification type support disk scale-out.
-
Instances must be in the running (Running) state.
After a disk scale-out, the billing changes as follows:
-
Pay-as-you-go: You are billed based on the new disk size.
-
Subscription: A supplemental fee is calculated based on the price difference between the new and old configurations for the remaining duration of the subscription. The remaining duration is calculated from 00:00 on the next day until the subscription expires.
Try it now
Test
RAM authorization
Request syntax
POST /webapi/priceInquiry/modifyDiskType HTTP/1.1
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| InstanceId |
string |
Yes |
Instance ID. |
c-b25e21e24388**** |
| NodeGroupId |
string |
Yes |
Compute group ID. |
ng-d332aa8bca48**** |
| TargetPerformanceLevel |
string |
Yes |
Target disk performance. |
pl2 |
| TargetDiskType |
string |
Yes |
Target disk type. |
essd |
| PromotionOptionNo |
string |
No |
Coupon ID. |
youhuiquan_12378dfj6 |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| HttpStatusCode |
integer |
HTTP request status code. |
200 |
| RequestId |
string |
Request ID. |
32A44F0D-BFF6-5664-999A-218BBDE74XXX |
| Success |
boolean |
Is the request successful. |
True |
| ErrCode |
string |
Error code. |
InvalidParams |
| ErrMessage |
string |
Error message. |
Invalid params: [Region id should be select from set [cn-beijing, cn-hangzhou]] |
| Data |
object |
Returned data. |
|
| OriginalAmount |
number |
Original price (original amount) = catalog price × usage. |
10923 |
| DiscountAmount |
number |
Discount amount = original amount - bill payable amount (including coupon deduction amount). |
0 |
| TradeAmount |
number |
Amount. |
10923 |
| ComponentPrices |
array<object> |
Component prices. |
|
|
object |
Component prices. |
||
| ComponentName |
string |
Resource group ID. |
disk_type |
| OriginalAmount |
number |
Original price. |
10923 |
| DiscountAmount |
number |
Discount. |
0 |
| TradeAmount |
number |
Final price, which is the original price minus the discount amount. |
10923 |
| Currency |
string |
Currency. |
CNY |
| OptionalPromotions |
array<object> |
Coupon information. |
|
|
object |
Coupon information. |
||
| PromotionOptionNo |
string |
Coupon ID. |
youhuiquan_12378dfj6 |
| PromotionName |
string |
Coupon name. |
youhuiquan_promotion_option_id_for_blank |
| PromotionDesc |
string |
The description of the coupon. |
youhuiquan_desc |
| StandPrice |
number |
Official website discount price. |
10923 |
| StandDiscountPrice |
number |
Discounted price based on the official website discount. |
10923 |
| DepreciateInfo |
object |
Price reduction ratio. |
|
| CheapRate |
number |
Price reduction ratio. |
0 |
| CheapStandAmount |
number |
Total official website price after reduction. |
10923 |
| OriginalStandAmount |
number |
Original total official website price. |
10923 |
| IsShow |
boolean |
Display price reduction range. |
true |
| Rules |
array<object> |
Returned data structure. |
|
|
object |
Returned data structure. |
||
| Name |
string |
Rule name. |
rule-928shy23sa |
| RuleDescId |
string |
Rule ID. |
7dsu230ks23 |
| Amount |
number |
Quantity. |
10 |
| AccessDeniedDetail |
string |
AccessDeniedDetail |
{ "PolicyType": "AccountLevelIdentityBasedPolicy", "AuthPrincipalOwnerId": "xxx", "EncodedDiagnosticMessage": "xxx", "AuthPrincipalType": "xxx", "AuthPrincipalDisplayName": "xxx", "NoPermissionType": "ImplicitDeny", "AuthAction": "sr:xxx" } |
Examples
Success response
JSON format
{
"HttpStatusCode": 200,
"RequestId": "32A44F0D-BFF6-5664-999A-218BBDE74XXX",
"Success": true,
"ErrCode": "InvalidParams",
"ErrMessage": "Invalid params: [Region id should be select from set [cn-beijing, cn-hangzhou]]",
"Data": {
"OriginalAmount": 10923,
"DiscountAmount": 0,
"TradeAmount": 10923,
"ComponentPrices": [
{
"ComponentName": "disk_type",
"OriginalAmount": 10923,
"DiscountAmount": 0,
"TradeAmount": 10923
}
],
"Currency": "CNY",
"OptionalPromotions": [
{
"PromotionOptionNo": "youhuiquan_12378dfj6",
"PromotionName": "youhuiquan_promotion_option_id_for_blank",
"PromotionDesc": "youhuiquan_desc"
}
],
"StandPrice": 10923,
"StandDiscountPrice": 10923,
"DepreciateInfo": {
"CheapRate": 0,
"CheapStandAmount": 10923,
"OriginalStandAmount": 10923,
"IsShow": true
},
"Rules": [
{
"Name": "rule-928shy23sa",
"RuleDescId": "7dsu230ks23",
"Amount": 10
}
]
},
"AccessDeniedDetail": "{ \"PolicyType\": \"AccountLevelIdentityBasedPolicy\", \"AuthPrincipalOwnerId\": \"xxx\", \"EncodedDiagnosticMessage\": \"xxx\", \"AuthPrincipalType\": \"xxx\", \"AuthPrincipalDisplayName\": \"xxx\", \"NoPermissionType\": \"ImplicitDeny\", \"AuthAction\": \"sr:xxx\" }"
}
Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.