调用DescribePrice查询集群价格配置信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribePrice |
系统规定参数。取值:DescribePrice。 |
PriceUnit | String | 是 | Hour |
ECS实例的计费周期单位。仅当ChargeType=PrePaid时该参数有效。取值范围:
默认值:Hour N的取值范围:1~10 |
ChargeType | String | 否 | PostPaid |
集群节点ECS实例的计费方式。取值范围:
默认值:PostPaid |
OrderType | String | 否 | INSTANCE-BUY |
订单类型,仅支持设置为商品购买。取值:INSTANCE-BUY |
Commodities.N.Amount | Integer | 是 | 2 |
第N个该类型节点的数量。取值范围:1~1000 默认值:1 N的取值范围:1~10 |
Commodities.N.SystemDiskSize | Integer | 否 | 40 |
第N个该节点的系统盘大小。单位:GB 取值范围:40~500 默认值:40 N的取值范围:1~10 |
Commodities.N.SystemDiskPerformanceLevel | String | 否 | PL1 |
第N个该节点的系统盘类型为ESSD云盘时,区分性能等级。仅当Commodities.N.SystemDiskCategory=cloud_essd时该参数有效。取值范围:
默认值:PL1 N的取值范围:1~10 |
Commodities.N.NodeType | String | 是 | Compute |
第N个节点类型。取值范围:
N的取值范围:1~10 |
Commodities.N.SystemDiskCategory | String | 否 | cloud_ssd |
第N个该节点的系统盘类型。可能值:
默认值:cloud_efficiency N的取值范围:1~10 |
Commodities.N.InternetChargeType | String | 否 | PayByBandwidth |
第N个该节点的公网付费方式。取值范围:
N的取值范围:1~10 |
Commodities.N.NetworkType | String | 否 | VPC |
第N个该节点的网络类型,仅支持设置为专有网络VPC。取值:VPC N的取值范围:1~10 |
Commodities.N.InstanceType | String | 是 | ecs.n1.tiny |
第N个该节点的ECS实例规格。 N的取值范围:1~10 |
Commodities.N.Period | Integer | 是 | 1 |
第N个该节点的ECS实例的计费时长。取值范围:
默认值:1 N的取值范围:1~10 |
Commodities.N.InternetMaxBandWidthOut | Integer | 否 | 100 |
第N个该节点公网出带宽最大值。单位为Mbit/s。 取值范围:0~100 默认值:0 N的取值范围:1~10 |
Commodities.N.DataDisks.N.size | Integer | 否 | 40 |
第N个随节点创建的数据盘容量大小。单位:GB 取值范围:40~500 默认值:40 N的取值范围:0~4 |
Commodities.N.DataDisks.N.category | String | 否 | cloud_efficiency |
第N个随节点创建的数据盘类型。可能值:
默认值:cloud_efficiency N的取值范围:0~4 |
Commodities.N.DataDisks.N.deleteWithInstance | Boolean | 否 | true |
第N个随节点创建的数据盘是否随实例释放。取值范围:
默认值:true N的取值范围:0~4 |
Commodities.N.DataDisks.N.performanceLevel | String | 否 | PL1 |
第N个随节点创建的数据盘类型为ESSD云盘时,区分性能等级。仅当Commodities.N.DataDisks.N.category=cloud_essd时该参数有效。取值范围:
默认值:PL1 N的取值范围:0~4 |
Commodities.N.DataDisks.N.encrypted | Boolean | 否 | false |
第N个随节点创建的数据盘是否加密。取值范围:
默认值:false N的取值范围:0~4 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
TotalTradePrice | Float | 1258 |
总价格。 单位:元 |
RequestId | String | 54FF9025-2C2F-42EB-870D-0DF5B0ACF24E |
请求ID。 |
Prices | Array of PriceInfo |
集群价格列表。当请求参数查询集群的多个节点配置价格时,返回值PriceInfo内多个元素的顺序与请求参数设置的多个节点信息的顺序依次对应。例如,请求参数中N=1的节点信息,对应的返回值为PriceInfo内的第一个元素。 |
|
PriceInfo | |||
OriginalPrice | Float | 1258 |
原价。 单位:元 |
NodeType | String | Compute |
节点类型。可能值:
|
Currency | String | CNY |
货币单位。可能值: CNY:人民币 |
TradePrice | Float | 1258 |
成交价。 单位:元 |
示例
请求示例
https://ehpc.cn-hangzhou.aliyuncs.com/?Action=DescribePrice
&Commodities.1.Amount=2
&Commodities.1.InstanceType=ecs.n1.tiny
&Commodities.1.1odeType=compute
&Commodities.1.Period=1
&PriceUnit=Hour
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribePriceResponse>
<Prices>
<PriceInfo>
<OriginalPrice>1258</OriginalPrice>
<TradePrice>1258</TradePrice>
<Currency>CNY</Currency>
<NodeType>Compute</NodeType>
</PriceInfo>
</Prices>
<TotalTradePrice>1258</TotalTradePrice>
<RequestId>54FF9025-2C2F-42EB-870D-0DF5B0ACF24E</RequestId>
</DescribePriceResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"Prices" : {
"PriceInfo" : [ {
"OriginalPrice" : "1258",
"TradePrice" : "1258",
"Currency" : "CNY",
"NodeType" : "Compute"
} ]
},
"TotalTradePrice" : "1258",
"RequestId" : "54FF9025-2C2F-42EB-870D-0DF5B0ACF24E"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidParams | The specified parameter %s is invalid. | 无效的参数:%s |
404 | ClusterNotFound | The specified cluster does not exist. | 指定的集群不存在,请您检查该参数是否正确。 |
406 | EcsError | An error occurred while calling the ECS API operation. | ECS API调用出错 |
406 | DbError | A database service error occurred. | 数据库请求失败 |
406 | AliyunError | An Alibaba Cloud product error occurred. | 阿里云产品错误 |
407 | NotAuthorized | You are not authorized by RAM for this request. | 此请求未获得RAM授权 |
500 | UnknownError | An unknown error occurred. | 未知错误,请您稍后再试,若还出现相同的错误请提交工单处理。 |
503 | ServiceUnavailable | The request has failed due to a temporary failure of the server | 请求失败,服务暂时不可用 |
访问错误中心查看更多错误码。