调用DescribePrice查询集群价格配置信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribePrice

系统规定参数。取值:DescribePrice

Commodities.N.Amount Integer 2

第N个该类型节点的数量。取值范围:1~1000

默认值:1

N的取值范围:1~10

Commodities.N.InstanceType String ecs.n1.tiny

第N个该节点的ECS实例规格。

N的取值范围:1~10

Commodities.N.NodeType String Compute

第N个节点类型。取值范围:

  • Compute:计算节点
  • Manager:管控节点
  • Login:登录节点

N的取值范围:1~10

Commodities.N.Period Integer 1

第N个该节点的ECS实例的计费时长。取值范围:

  • 当参数PriceUnit取值为Month时:1~9
  • 当参数PriceUnit取值为Year时:1~3
  • 当参数PriceUnit取值为Hour时:1
  • 当参数PriceUnit取值为Week时:1~4

默认值:1

N的取值范围:1~10

PriceUnit String Hour

ECS实例的计费周期单位。仅当ChargeType=PrePaid时该参数有效。取值范围:

  • Month:按月计费
  • Year:按年计费
  • Hour:按小时计费
  • Week:按周计费

默认值:Hour

N的取值范围:1~10

Commodities.N.NetworkType String VPC

第N个该节点的网络类型,仅支持设置为专有网络VPC。取值:VPC

N的取值范围:1~10

Commodities.N.SystemDiskCategory String cloud_ssd

第N个该节点的系统盘类型。可能值:

  • cloud_efficiency:高效云盘
  • cloud_ssd:SSD云盘
  • cloud_essd:ESSD云盘
  • cloud:普通云盘

默认值:cloud_efficiency

N的取值范围:1~10

Commodities.N.SystemDiskSize Integer 40

第N个该节点的系统盘大小。单位:GB

取值范围:40~500

默认值:40

N的取值范围:1~10

Commodities.N.InternetChargeType String PayByBandwidth

第N个该节点的公网付费方式。取值范围:

  • PayByBandwidth:按固定带宽收费
  • PayByTraffic:按流量计费

N的取值范围:1~10

Commodities.N.InternetMaxBandWidthOut Integer 100

第N个该节点公网出带宽最大值。单位为Mbit/s。

取值范围:0~100

默认值:0

N的取值范围:1~10

Commodities.N.SystemDiskPerformanceLevel String PL1

第N个该节点的系统盘类型为ESSD云盘时,区分性能等级。仅当Commodities.N.SystemDiskCategory=cloud_essd时该参数有效。取值范围:

  • PL0:单盘最高随机读写IOPS 1万
  • PL1:单盘最高随机读写IOPS 5万
  • PL2:单盘最高随机读写IOPS 10万
  • PL3:单盘最高随机读写IOPS 100万

默认值:PL1

N的取值范围:1~10

ChargeType String PostPaid

集群节点ECS实例的计费方式。取值范围:

  • PostPaid:按量付费
  • PrePaid:包年包月

默认值:PostPaid

OrderType String instance-buy

订单类型,仅支持设置为商品购买。取值:instance-buy

返回数据

名称 类型 示例值 描述
Prices Array of PriceInfo

集群价格列表。当请求参数查询集群的多个节点配置价格时,返回值PriceInfo内多个元素的顺序与请求参数设置的多个节点信息的顺序依次对应。例如,请求参数中N=1的节点信息,对应的返回值为PriceInfo内的第一个元素。

PriceInfo
Currency String CNY

货币单位。可能值:

  • CNY:人民币
  • USD:美元
NodeType String Compute

节点类型。可能值:

  • Manager:管控节点
  • Login:登录节点
  • Compute:计算节点
OriginalPrice Float 1258

原价。

单位:元

TradePrice Float 1258

成交价。

单位:元

RequestId String 54FF9025-2C2F-42EB-870D-0DF5B0ACF24E

请求ID。

TotalTradePrice 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格式

<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格式

{
    "Prices":{
        "PriceInfo":[
            {
                "OriginalPrice":"1258",
                "TradePrice":"1258",
                "Currency":"CNY",
                "NodeType":"Compute"
            }
        ]
    },
    "TotalTradePrice":"1258",
    "RequestId":"54FF9025-2C2F-42EB-870D-0DF5B0ACF24E"
}

错误码

HttpCode 错误码 错误信息 描述
503 ServiceUnavailable The request has failed due to a temporary failure of the server 请求失败,服务暂时不可用

访问错误中心查看更多错误码。