调用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 请求失败，服务暂时不可用

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