QueryModifyDiskNumberPrice-阿里云帮助中心

Retrieve the price for changing the number of disks in a compute group node

Operation description

Before you call this operation, review the billing methods and billable items for Serverless StarRocks.

You can increase the disk count only for Standard Edition instances. You cannot increase the disk count for Starter Edition instances.
You can increase the disk count only for instances with a compute group specification type of Standard Edition (standard).
The instance must be in the Running state.

After you increase the disk count, billing changes as follows:

Pay-as-you-go: Billing is based on the new disk type.
Subscription: During the billing cycle, the additional fee is calculated based on the price difference between the new and original configurations and the remaining days—from 00:00 the next day to the end of the validity period.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

POST /webapi/priceInquiry/modifyDiskNumber HTTP/1.1

Request parameters

Parameter	Type	Required	Description	Example
InstanceId	string	Yes	The ID of the instance.	c-b25e21e24388****
NodeGroupId	string	Yes	The ID of the compute group.	ng-3d5ce6454354****
Target	integer	Yes	The target number of nodes.	500
PromotionOptionNo	string	No	The ID of the coupon.	youhuiquan_12378dfj6

Response elements

Element	Type	Description	Example
	object
HttpStatusCode	integer	The HTTP status code of the request.	200
RequestId	string	The ID of the request.	32A44F0D-BFF6-5664-999A-218BBDE74XXX
Success	boolean	Indicates whether the request succeeded.	false
ErrCode	string	The error code.	InvalidParams
ErrMessage	string	The error message.	null
Data	object	The ID of the order.
OriginalAmount	number	The original amount = catalog price × usage.	17629
DiscountAmount	number	The discount amount = original amount − payable amount on the bill (including coupon deductions).	0
TradeAmount	number	The final amount.	17629
ComponentPrices	array<object>	The prices of components.
	object	The price of a component.
ComponentName	string	The name of the component.	disk
OriginalAmount	number	The original amount.	17629
DiscountAmount	number	The discount amount for the order.	0
TradeAmount	number	The final amount, which equals the original amount minus the discount.	17629
Currency	string	The currency.	CNY
OptionalPromotions	array<object>	The coupon information.
	object	The coupon information.
PromotionOptionNo	string	The ID of the coupon.	youhuiquan_12378dfj6
PromotionName	string	The name of the coupon.	youhuiquan_promotion_option_id_for_blank
PromotionDesc	string	The description of the coupon.	youhuiquan_desc
StandPrice	number	The official discounted price.	17629
StandDiscountPrice	number	The discounted price.	17629
DepreciateInfo	object	The total official price after discount.	17629
CheapRate	number	The discount rate.	0
CheapStandAmount	number	The total official price after discount.	17629
OriginalStandAmount	number	The original total official price.	17629
IsShow	boolean	Indicates whether to show the discount amount.	true
Rules	array<object>	The list of rules that match your request. Each item is a matching rule. Only matching rule information and the location of each matching rule are returned.
	object	The pricing rule.
Name	string	The name of the rule.	rule_12hus92
RuleDescId	string	The ID of the rule.	6yhsi10223
Amount	number	The number of Elastic Compute Service (ECS) instances for which you want to query the price. Valid values: 1 to 1000. Default value: 1. Default value: 1.	3
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\n",
  "Success": false,
  "ErrCode": "InvalidParams",
  "ErrMessage": "null",
  "Data": {
    "OriginalAmount": 17629,
    "DiscountAmount": 0,
    "TradeAmount": 17629,
    "ComponentPrices": [
      {
        "ComponentName": "disk",
        "OriginalAmount": 17629,
        "DiscountAmount": 0,
        "TradeAmount": 17629
      }
    ],
    "Currency": "CNY",
    "OptionalPromotions": [
      {
        "PromotionOptionNo": "youhuiquan_12378dfj6",
        "PromotionName": "youhuiquan_promotion_option_id_for_blank",
        "PromotionDesc": "youhuiquan_desc"
      }
    ],
    "StandPrice": 17629,
    "StandDiscountPrice": 17629,
    "DepreciateInfo": {
      "CheapRate": 0,
      "CheapStandAmount": 17629,
      "OriginalStandAmount": 17629,
      "IsShow": true
    },
    "Rules": [
      {
        "Name": "rule_12hus92",
        "RuleDescId": "6yhsi10223",
        "Amount": 3
      }
    ]
  },
  "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.