全部产品
Search
文档中心

云原生数据库 PolarDB:DescribeDBClusterPrice - 查询DB实例价格

更新时间:Jul 10, 2026

查询集群价格

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

DBNodeClass

string

节点规格。BUY 场景必填,格式如 polar.mysql.x4.large

polar.mysql.x4.large

DBType

string

数据库引擎类型。BUY 场景必填,取值:MySQL、PostgreSQL、Oracle

MySQL

DBVersion

string

数据库引擎版本。BUY 场景必填。MySQL 取值:5.6、5.7、8.0;PostgreSQL 取值:11、14;Oracle 取值:11、14

8.0

PayType

string

付费类型。BUY 和 CONVERT 场景必填。取值:Prepaid(包年包月)、Postpaid(按量付费)

Prepaid

OrderType

string

订单类型。取值:BUY(新购)、CONVERT(付费类型转换)、RENEW(续费)、UPGRADE(升配/增加节点)、DOWNGRADE(降配/删除节点)

BUY

RegionId

string

地域 ID

cn-hangzhou

ZoneId

string

可用区 ID。BUY 场景建议传入

cn-hangzhou-h

DBNodeNum

integer

节点数量。BUY 场景有效,包含读写节点,最小值为 1,默认为 1

2

CreationCategory

string

集群系列。取值:Normal(集群版)、Basic(单节点)、ArchiveNormal(归档版)、SENormal(标准版)、NormalMultimaster(多主集群)

Normal

StorageSpace

string

存储空间,单位为 GB。预付费存储或存储变配场景使用

50

StorageType

string

存储类型。取值:PSL5(高性能)、PSL4(标准)、ESSDPL0、ESSDPL1、ESSDPL2、ESSDPL3、ESSDAUTOPL

PSL5

StorageChargeType

string

存储计费类型。取值:Prepaid(预付费)、Postpaid(按量付费)

Prepaid

ProvisionedIops

string

预配置 IOPS。标准版(SENormal)场景使用

1000

HotStandbyCluster

string

是否开启热备集群。取值:ON(开启)、OFF(关闭)。BUY 场景和变更场景有效

ON

ServerlessType

string

Serverless 类型。取值:AgileServerless

AgileServerless

DBClusterId

string

集群 ID。非 BUY 场景必填

pc-**************

UsedTime

string

购买时长。与 Period 配合使用,BUY/CONVERT/RENEW 场景且付费类型为 Prepaid 时有效

1

Period

string

购买周期。取值:Month(月)、Year(年)

Month

DBNodes

array<object>

异构变配节点列表。变配场景使用,指定各节点的目标规格

object

节点信息详情。

DBNodeId

string

节点 ID

pi-**************

DBNodeClass

string

目标节点规格

polar.mysql.x4.large

ModifyType

string

变配方向。取值:ADD(增加节点)、DELETE(删除节点)、UPGRADE(升配)、DOWNGRADE(降配)、HOT_STANDBY(热备变更)、STORAGE(存储空间变配)、STORAGE_TYPE(存储类型变配)

UPGRADE

DBNodeIds

array

待删除节点 ID 列表。ModifyType 为 DELETE 时使用

pi-**************

string

节点 ID

pi-***************

返回参数

名称

类型

描述

示例值

object

RequestId

string

请求 ID。

7E2FE3BB-C677-5FF9-9FC5-XXX

ShowDiscount

boolean

是否允许使用折扣。

False

OrderType

string

订单类型。取值范围如下:

  • BUY:新购。

  • UPGRADE:变更配置。

  • RENEW:续费。

  • CONVERT:转换付费类型。

BUY

PriceInfo

object

价格详细信息。

Currency

string

货币单位。

CNY

OriginalPrice

number

原价。

1099.0

TradePrice

number

最终价,为原价减去折扣。

165.0

DiscountPrice

number

折扣。

1978.2

RuleIds

object

RuleId

array

规则 ID。

string

规则 ID。

[8]

Coupons

object

Coupon

array<object>

优惠详情信息。

object

优惠详情信息。

CouponNo

string

优惠券编号。

779643240541

Name

string

优惠券名称

coupon

IsSelected

string

是否已选择优惠券。

false

Rules

object

Rule

array<object>

活动规则。

object

活动规则。

RuleId

integer

规则 ID。

rule-xxx

Name

string

规则名称

rule-xxx

示例

正常返回示例

JSON格式

{
  "RequestId": "7E2FE3BB-C677-5FF9-9FC5-XXX",
  "ShowDiscount": true,
  "OrderType": "BUY",
  "PriceInfo": {
    "Currency": "CNY",
    "OriginalPrice": 1099,
    "TradePrice": 165,
    "DiscountPrice": 1978.2,
    "RuleIds": {
      "RuleId": [
        "[8]"
      ]
    },
    "Coupons": {
      "Coupon": [
        {
          "CouponNo": "779643240541",
          "Name": "coupon",
          "IsSelected": "false"
        }
      ]
    }
  },
  "Rules": {
    "Rule": [
      {
        "RuleId": 0,
        "Name": "rule-xxx"
      }
    ]
  }
}

错误码

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

变更历史

更多信息,参考变更详情