QueryModifyDiskPerformanceLevelPrice - E-MapReduce - Alibaba Cloud Documentation Center

Queries the price of changing the disk performance level for a compute group node.

Operation description

Before you call this operation, make sure that you understand the billing methods and pricing of Serverless StarRocks. Note the following when you call this operation:

Only standard instances support disk upgrade or downgrade. Entry-level instances do not.
Only instances with a standard compute group specification support disk upgrade or downgrade.
The instance must be in the running state.
You cannot downgrade the disk to performance level (PL) 0.
The performance level of an Enhanced SSD (ESSD) is limited by its capacity. If you cannot upgrade the performance level, scale out the disk and try again. For more information, see ESSDs.

After you upgrade or downgrade a disk, the billing changes as follows:

Pay-as-you-go: You are charged based on the new disk type.
Subscription: A supplementary fee is calculated based on the price difference between the new and old configurations and the remaining days in the subscription period, starting from 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/modifyDiskPerformanceLevel HTTP/1.1

Request parameters

Parameter	Type	Required	Description	Example
InstanceId	string	Yes	The instance ID.	c-a7fa8b85ff6bced6
NodeGroupId	string	Yes	The compute group ID.	ng-204ea5d711860b4d
Target	string	Yes	The target disk performance level.	pl2
PromotionOptionNo	string	No	The coupon ID.	youhuiquan_12378dfj6

Response elements

Element	Type	Description	Example
	object
HttpStatusCode	integer	The HTTP status code of the request.	200
RequestId	string	The request ID.	86865DD4-7733-5446-B52B-C9DA71961B76
Success	boolean	Indicates whether the request was successful.	True
ErrCode	string	The error code.	InvalidParams
ErrMessage	string	The error message.	Invalid params: [instance not exists].
Data	object	The order ID.
OriginalAmount	number	The original price. Original price = List price × Usage.	17629
DiscountAmount	number	The discount amount. Discount amount = Original price - Amount payable (including the amount deducted by coupons).	0
TradeAmount	number	The amount.	17629
ComponentPrices	array<object>	The component prices.
	object	The component prices.
ComponentName	string	Resource group ID	disk_type
OriginalAmount	number	The original price.	17629
DiscountAmount	number	The discount.	0
TradeAmount	number	The final price, which is the original price minus the discount.	17629
Currency	string	The currency. Valid values: CNY: Chinese Yuan. USD: US Dollar. JPY: Japanese Yen.	CNY
OptionalPromotions	array<object>	The coupon information.
	object	The coupon information.
PromotionOptionNo	string	The coupon ID.	youhuiquan_12378dfj6
PromotionName	string	The coupon name.	youhuiquan_promotion_option_id_for_blank
PromotionDesc	string	The coupon description.	youhuiquan_desc
StandPrice	number	The official discounted price.	17629
StandDiscountPrice	number	The discounted price based on the official discount.	17629
DepreciateInfo	object	The total official price after the price reduction.	17629
CheapRate	number	The price reduction ratio.	0
CheapStandAmount	number	The total official price after the price reduction.	17629
OriginalStandAmount	number	The original total official price.	17629
IsShow	boolean	Indicates whether to display the price reduction range.	true
Rules	array<object>	A list of hit rules. Each item is a rule. Only information about the hit rules and their locations is returned.
	object	A list of hit rules. Each item is a rule. Only information about the hit rules and their locations is returned.
Name	string	The rule name.	rule_128nsg182
RuleDescId	string	The rule ID.	78hujis12jd
Amount	number	The number of purchased resources.	1
AccessDeniedDetail	string	The details about 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": "86865DD4-7733-5446-B52B-C9DA71961B76",
  "Success": true,
  "ErrCode": "InvalidParams",
  "ErrMessage": "Invalid params: [instance not exists].",
  "Data": {
    "OriginalAmount": 17629,
    "DiscountAmount": 0,
    "TradeAmount": 17629,
    "ComponentPrices": [
      {
        "ComponentName": "disk_type",
        "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_128nsg182",
        "RuleDescId": "78hujis12jd",
        "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.