QueryModifyCuPrice-阿里云帮助中心

Queries the price for modifying the CU of compute group nodes.

Operation description

Before you use this API, understand the billing methods and billable items for Serverless StarRocks.

When you call this API, note the following:

Only standard instances allow you to modify the number of CUs for compute groups. Entry-level instances do not.
You can increase the disk size only for instances with a Standard Edition (standard) compute group.
The instance must be in the Running state.

After you modify the number of CUs, billing changes as follows:

Pay-as-you-go: Billing is based on the new number of CUs.
Subscription: The amount to pay is calculated based on the price difference between the old and new configurations for the remainder of the subscription period. This period starts at 00:00 on the following day.

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/modifyCu 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 CUs.	2
PromotionOptionNo	string	No	The ID of the coupon.	youhuiquan_12378dfj6

Response elements

Element	Type	Description	Example
	object
HttpStatusCode	integer	The HTTP status code.	200
RequestId	string	The ID of the request.	B67D142D-D54E-184F-A306-22BDC01B2XXX
Success	boolean	Indicates whether the request was successful.	True
ErrCode	string	The error code.	InvalidParams
ErrMessage	string	The error message.	null
Data	object	The returned data.
OriginalAmount	number	The original price. Original price = List price × Billing usage.	7986
DiscountAmount	number	The discount amount. Discount amount = Original amount - Billable amount. The billable amount includes coupon deductions.	0
TradeAmount	number	The transaction amount.	7986
ComponentPrices	array<object>	The prices of the components.
	object	The prices of the components.
ComponentName	string	The name of the component.	cu_num
OriginalAmount	number	The original price.	7986
DiscountAmount	number	The discount amount.	0
TradeAmount	number	The final price, which is the original price minus the discount.	7986
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 discounted price on the official website.	7986
StandDiscountPrice	number	The price after the standard discount is applied.	7986
DepreciateInfo	object	The depreciation rate.	0
CheapRate	number	The price reduction ratio.	0
CheapStandAmount	number	The total list price after the price reduction.	7986
OriginalStandAmount	number	The original total list price.	7986
IsShow	boolean	Indicates whether to show the price reduction information.	true
Rules	array<object>	The data structure returned in the response.
	object	The price calculation rules.
Name	string	The name of the rule.	rule_123123
RuleDescId	string	The ID of the rule.	ak72hajsd
Amount	number	The number of instances to purchase in a batch. You can use this parameter to query the price of purchasing multiple Elastic Compute Service (ECS) instances with a specific configuration. Valid values: 1 to 1000. Default value: 1.	1
AccessDeniedDetail	string	Details about the access denial.	{ "PolicyType": "AccountLevelIdentityBasedPolicy", "AuthPrincipalOwnerId": "xxx", "EncodedDiagnosticMessage": "xxx", "AuthPrincipalType": "xxx", "AuthPrincipalDisplayName": "xxx", "NoPermissionType": "ImplicitDeny", "AuthAction": "sr:xxx" }

Examples

Success response

JSON format

{
  "HttpStatusCode": 200,
  "RequestId": "B67D142D-D54E-184F-A306-22BDC01B2XXX",
  "Success": true,
  "ErrCode": "InvalidParams",
  "ErrMessage": "null",
  "Data": {
    "OriginalAmount": 7986,
    "DiscountAmount": 0,
    "TradeAmount": 7986,
    "ComponentPrices": [
      {
        "ComponentName": "cu_num",
        "OriginalAmount": 7986,
        "DiscountAmount": 0,
        "TradeAmount": 7986
      }
    ],
    "Currency": "CNY",
    "OptionalPromotions": [
      {
        "PromotionOptionNo": "youhuiquan_12378dfj6",
        "PromotionName": "youhuiquan_promotion_option_id_for_blank",
        "PromotionDesc": "youhuiquan_desc"
      }
    ],
    "StandPrice": 7986,
    "StandDiscountPrice": 7986,
    "DepreciateInfo": {
      "CheapRate": 0,
      "CheapStandAmount": 7986,
      "OriginalStandAmount": 7986,
      "IsShow": true
    },
    "Rules": [
      {
        "Name": "rule_123123",
        "RuleDescId": "ak72hajsd",
        "Amount": 1
      }
    ]
  },
  "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.