Queries the pricing configuration of a cluster.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
ehpc:DescribePrice |
*All Resource
|
None | None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| PriceUnit |
string |
Yes |
The billing cycle unit of the ECS instance. This parameter is valid only when ChargeType is set to PrePaid. Valid values:
Default value: Hour. |
Hour |
| ChargeType |
string |
No |
The billing method of the ECS instances for cluster nodes. Valid values:
Default value: PostPaid. |
PostPaid |
| OrderType |
string |
No |
The order type. Only commodity purchase is supported. Valid value: INSTANCE-BUY. |
INSTANCE-BUY |
| Commodities |
array<object> |
Yes |
The commodity list. |
|
|
array<object> |
No |
|||
| Amount |
integer |
Yes |
The number of nodes of the Nth type. Valid values: 1 to 1000. Default value: 1. Valid values of N: 1 to 10. |
2 |
| SystemDiskSize |
integer |
No |
The size of the system cloud disk for the Nth node. Unit: GB. Valid values: 40 to 500. Default value: 40. Valid values of N: 1 to 10. |
40 |
| SystemDiskPerformanceLevel |
string |
No |
The performance level of the system cloud disk for the Nth node when the disk type is ESSD, not standard SSD. This parameter is valid only when Commodities.N.SystemDiskCategory is set to cloud_essd. Valid values:
Default value: PL1. Valid values of N: 1 to 10. |
PL1 |
| NodeType |
string |
Yes |
The type of the Nth node. Valid values:
Valid values of N: 1 to 10. |
Compute |
| SystemDiskCategory |
string |
No |
The system cloud disk type of the Nth node. Valid values:
Default value: cloud_efficiency. Valid values of N: 1 to 10. |
cloud_ssd |
| InternetChargeType |
string |
No |
The billing method for Internet traffic of the Nth node. Valid values:
Valid values of N: 1 to 10. |
PayByBandwidth |
| NetworkType |
string |
No |
The network type of the Nth node. Only VPC is supported. Valid value: VPC. Valid values of N: 1 to 10. |
VPC |
| InstanceType |
string |
Yes |
The ECS instance type of the Nth node. Valid values of N: 1 to 10. |
ecs.n1.tiny |
| Period |
integer |
Yes |
The billing duration of the ECS instance for the Nth node. Valid values:
Default value: 1. Valid values of N: 1 to 10. |
1 |
| InternetMaxBandWidthOut |
integer |
No |
The maximum outbound public bandwidth of the Nth node. Unit: Mbit/s. Valid values: 0 to 100. Default value: 0. Valid values of N: 1 to 10. |
100 |
| DataDisks |
array<object> |
No |
The list of data cloud disks that are created with the node. |
|
|
object |
No |
|||
| size |
integer |
No |
The capacity of the Nth data cloud disk created with the node. Unit: GB. Valid values: 40 to 500. Default value: 40. Valid values of N: 0 to 4. |
40 |
| category |
string |
No |
The type of the Nth data cloud disk created with the node. Valid values:
Default value: cloud_efficiency. Valid values of N: 0 to 4. |
cloud_efficiency |
| deleteWithInstance |
boolean |
No |
Specifies whether the Nth data cloud disk created with the node is released with the instance. Valid values:
Default value: true. Valid values of N: 0 to 4. |
true |
| performanceLevel |
string |
No |
The performance level of the Nth data cloud disk created with the node when the disk type is ESSD, not standard SSD. This parameter is valid only when Commodities.N.DataDisks.N.category is set to cloud_essd. Valid values:
Default value: PL1. Valid values of N: 0 to 4. |
PL1 |
| encrypted |
boolean |
No |
Specifies whether the Nth data cloud disk created with the node is encrypted. Valid values:
Default value: false. Valid values of N: 0 to 4. |
false |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| TotalTradePrice |
number |
The total price. Unit: USD. |
1258 |
| RequestId |
string |
The request ID. |
54FF9025-2C2F-42EB-870D-0DF5B0ACF24E |
| Prices |
object |
||
| PriceInfo |
array<object> |
The price list of the cluster. When the request queries the configuration prices of multiple nodes in the cluster, the order of elements in the PriceInfo response matches the order of the node information specified in the request parameters. For example, the node information with N=1 in the request parameters corresponds to the first element in PriceInfo. |
|
|
object |
|||
| OriginalPrice |
number |
The original price. Unit: USD. |
1258 |
| NodeType |
string |
The node type. Valid values:
|
Compute |
| Currency |
string |
The currency unit. Valid values: USD: US dollar |
|
| TradePrice |
number |
The transaction price. Unit: USD. |
1258 |
Examples
Success response
JSON format
{
"TotalTradePrice": 1258,
"RequestId": "54FF9025-2C2F-42EB-870D-0DF5B0ACF24E",
"Prices": {
"PriceInfo": [
{
"OriginalPrice": 1258,
"NodeType": "Compute",
"Currency": "CNY\n\nUSD",
"TradePrice": 1258
}
]
}
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InvalidParams | The specified parameter %s is invalid. | The specified parameter %s is invalid. |
| 500 | UnknownError | An unknown error occurred. | An unknown error occurred. |
| 404 | ClusterNotFound | The specified cluster does not exist. | The specified instance does not exist. |
| 503 | ServiceUnavailable | The request has failed due to a temporary failure of the server | The request has failed due to a temporary failure of the server. |
| 406 | EcsError | An error occurred while calling the ECS API operation. | ECS API call error. %s |
| 406 | DbError | A database service error occurred. | Database request failed. |
| 406 | AliyunError | An Alibaba Cloud product error occurred. | Alibaba Cloud product error. %s |
| 407 | NotAuthorized | You are not authorized by RAM for this request. | The request is not authorized by RAM. |
| 407 | EntityNotExist.Role | The role does not exist. | The role does not exist. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.